Merge pull request #1 from dtzar/acs-quickstart

Update flow and add CLI deployment

Author: slack

src/quickstart/provider/azure-acs/boot.md

@@ -1,12 +1,17 @@
 # Booting Azure Container Service
 
-If you do not already have a Azure Cloud account, you can start a trial with $200 of free credit [here](https://azure.microsoft.com/en-us/free/). After completing sign up, you must add your billing information.
+## Prerequisites
 
-## Install and configure the Azure CLI
+1. Azure Accout - If you do not already have a Azure Cloud account, you can start a trial with $200 of free credit [here](https://azure.microsoft.com/en-us/free/). After completing sign up, you must add your billing information.
+2. Some form of *nix-based terminal - MacOS, Ubuntu, CentOS, Bash on Windows, etc
+<br>Where the following is present:
+3. Azure CLI - The Azure CLI (2.0) provides the `az` command and allows you to interact with Azure through the command line. Install the CLI by following the instructions on [GitHub for the Azure CLI](https://github.com/Azure/azure-cli).
+4. SSH Key - This is used to deploy the cluster. 
+5. jq - to parse the JSON responses from the CLI. [jq download page](https://stedolan.github.io/jq/)
 
-The Azure CLI (2.0) provides the `az` command and allows you to interact with Azure through the command line. Install the CLI by following the instructions on [GitHub for the Azure CLI](https://github.com/Azure/azure-cli).
+## Configure the Azure CLI
 
-After installing the CLI, log in to your Azure Account:
+After installing the CLI, log in to your Azure Account by typing `az login` and output would look similar to this:
 ```
 ~ $ az login
 To sign in, use a web browser to open the page https://aka.ms/devicelogin and enter the code F7DLMNOPE to authenticate.
@@ -26,14 +31,26 @@ To sign in, use a web browser to open the page https://aka.ms/devicelogin and en
 ]
 ```
 
-TODO: handle multiple subscriptions?
+Replace the value of SUBSCRIPTION_ID with the desired subscription id where you want to deploy from the previous step.  We also set the active subscription to deploy to.
+```
+SUBSCRIPTION_ID=57849302-a9f0-4908-b300-31337a0fb205
+az account set --subscription="${SUBSCRIPTION_ID}"
+```
 
 ## Create an Azure Service Principle
 
 Next, create an Azure Service Principle that will be used to provision the ACS Kubernetes Cluster. Service Principles are entities that have permission to create resources on your behalf. New Service Principles must be given a unique name, a role, and an Azure subscription that the Service Principle may modify.
 
 ```
-$ az ad sp create-for-rbac --name="http://workflow-on-acs" --role="Contributor" --scopes="/subscriptions/<SUBSCRIPTION ID>"
+SP_JSON=`az ad sp create-for-rbac --role="Contributor" --scopes="/subscriptions/${SUBSCRIPTION_ID}"`
+SP_NAME=`echo $SP_JSON | jq -r '.name'`
+SP_PASS=`echo $SP_JSON | jq -r '.password'`
+SP_TENANT=`echo $SP_JSON | jq -r '.tenant'`
+echo SP_JSON
+```
+
+This should display an output similar to this.  jq has also automatically extracted these values for use in the creation of the cluster.
+```
 {
   "appId": "58b21231-3dd7-4546-bd37-9df88812331f",
   "name": "http://workflow-on-acs",
@@ -44,6 +61,32 @@ $ az ad sp create-for-rbac --name="http://workflow-on-acs" --role="Contributor"
 
 ## Create Your ACS Kubernetes Cluster
 
+You can build the Kubernetes cluster on ACS using primarily the Azure web Portal (UI) or entirely using the Azure command line (CLI).  Choose one of the two paths:
+
+### Path 1: Azure 'az' CLI
+
+1. Create an empty Azure resource group to deploy your cluster. The location of the resource group value can be changed to any datacenter.
+
+```
+RG_NAME=myresourcegroup
+az resource group create --name "${RG_NAME}" --location southcentralus
+```
+
+2. Execute the command to deploy the cluster. The dns-prefix and ssh-key-value must be replaced with your own values.
+
+```
+  az acs create --resource-group="${RG_NAME}" --location="southcentralus" /
+  --service-principal="${SP_NAME}" /
+  --client-secret="${SP_PASS}" /
+  --orchestrator-type=kubernetes --master-count=1 --agent-count=2 /
+  --agent-vm-size="Standard_D2_v2" /
+  --admin-username="k8sadmin" /
+  --name="k8sanddeis" --dns-prefix="mydnsprefix" /
+  --ssh-key-value @/home/myusername/.ssh/id_rsa.pub
+```
+
+### Path 2: UI
+
 Sign into the [Azure Portal](https://portal.azure.com) and create a new Azure Container Service:
 
 ![](images/step1.png)
@@ -89,8 +132,6 @@ The Kubernetes cluster will take a few minutes to complete provisioning and conf
 
 ![](images/step9.png)
 
-Path 2: ACS Engine
-
 ## Connect to your Kubernetes Cluster
 
 1. Find hostname for the master