Added 'Office 365 CLI login' GitHub action solving #2

Author: anoopt

.gitignore

@@ -0,0 +1,91 @@
+# comment out in distribution branches
+node_modules/
+
+# Rest pulled from https://github.com/github/gitignore/blob/master/Node.gitignore
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# next.js build output
+.next
+
+# nuxt.js build output
+.nuxt
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/

README.md

@@ -1,2 +1,67 @@
-# action-cli-login
-GitHub action to login to a tenant using Office 365 CLI 
+# Office 365 CLI login GitHub action
+GitHub action to login to a tenant using Office 365 CLI.
+
+![Office 365 CLI Login](./images/cli-login.png)
+
+This GitHub Action (created using typescript) uses [Office 365 CLI](https://pnp.github.io/office365-cli/), specifically the [login command](https://pnp.github.io/office365-cli/cmd/login), to allow you log in to Office 365.
+
+## Usage
+### Pre-requisites
+Create a workflow `.yml` file in your `.github/workflows` directory. An [example workflow](#example-workflow---office-365-cli-login) is available below. For more information, reference the GitHub Help Documentation for [Creating a workflow file](https://help.github.com/en/articles/configuring-a-workflow#creating-a-workflow-file).
+
+### Inputs
+- `ADMIN_USERNAME` : **Required** Username (email address of the admin)
+- `ADMIN_PASSWORD` : **Required** Password of the admin
+
+#### Optional requirement
+Since this action requires user name and password which are sensitive pieces of information, it would be ideal to store them securely. We can achieve this in a GitHub repo by using [secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets). So, click on `settings` tab in your repo and add 2 new secrets:
+- `adminUsername` - store the admin user name in this (e.g. user@contoso.onmicrosoft.com)
+- `adminPassword` - store the password of that user in this.
+These secrets are encrypted and can only be used by GitHub actions. 
+
+### Example workflow - Office 365 CLI Login
+On every `push` build the code and then login to Office 365 before deploying.
+
+```yaml
+name: SPFx CICD with O365 CLI
+
+on: [push]
+
+jobs:
+  build:
+    ##
+    ## Build code omitted
+    ##
+        
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [10.x]
+    
+    steps:
+    
+    ##
+    ## Code to get the package omitted
+    ##
+
+    # Office 365 cli login action
+    - name: Login to tenant
+      uses: pnp/action-cli-login@v1.0.0
+      with:
+        ADMIN_USERNAME:  ${{ secrets.adminUsername }}
+        ADMIN_PASSWORD:  ${{ secrets.adminPassword }}
+    
+    ##
+    ## Code to deploy the package to tenant omitted
+    ##
+```
+
+#### Self-hosted runners
+If self-hosted runners are used for running the workflow, then please make sure that they have `PowerShell` or `bash` installed on them. 
+
+## Release notes
+
+### v1.0.0
+- Added inital 'Office 365 CLI login' GitHub action solving #2

action.yml

@@ -0,0 +1,15 @@
+name: 'Office 365 CLI Login'
+description: 'Login to tenant using Office 365 CLI'
+inputs:
+  ADMIN_USERNAME:  
+    description: 'Username (email address) of the admin'
+    required: true
+  ADMIN_PASSWORD:  
+    description: 'Password of the admin'
+    required: true
+runs:
+  using: "node12"
+  main: "dist/index.js"
+branding:
+  icon: 'log-in'  
+  color: 'blue'