docs(azure): streamline azure boot process

Author: dtzar

src/quickstart/install-cli-tools.md

@@ -34,13 +34,13 @@ Install the latest `helm` cli for Linux or Mac OS X by following the
 
 ## Step 2: Boot a Kubernetes Cluster and Install Deis Workflow
 
-There are many ways to boot and run Kubernetes. You may choose to get up and running in cloud environments or locally on
-your laptop.
+There are many ways to boot and run Kubernetes. You may choose to get up and running in cloud environments or locally on your laptop.
 
 Cloud-based options:
 
 * [Google Container Engine](provider/gke/boot.md): provides a managed Kubernetes environment, available with a few clicks.
 * [Amazon Web Services](provider/aws/boot.md): uses Kubernetes upstream `kube-up.sh` to boot a cluster on AWS EC2.
+* [Azure Container Service](provider/azure-acs/boot.md): provides a managed Kubernetes environment.
 
 If you would like to test on your local machine follow our guide for [Vagrant](provider/vagrant/boot.md).
 

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

@@ -84,13 +84,14 @@ $ az group create --name "${RG_NAME}" --location "${DC_LOCATION}"
 Execute the command to deploy the cluster. The `dns-prefix` and `ssh-key-value` must be replaced with your own values.
 
 ```
+$ export SERVICE_NAME=myacs
 $ az acs create --resource-group="${RG_NAME}" --location="${DC_LOCATION}" \
   --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" \
+  --name="${SERVICE_NAME}" --dns-prefix="mydnsprefix" \
   --ssh-key-value @/home/myusername/.ssh/id_rsa.pub
 ```
 
@@ -167,27 +168,16 @@ The Kubernetes cluster will take a few minutes to complete provisioning and conf
 
 ## Connect to the ACS Kubernetes Cluster
 
-Retrieve the fully qualified domain name (FQDN) for the Kubernetes master.
+`kubectl` is the Kubernetes command line client.  If you don't already have it installed, you can install it with:
 
-```
-$ export K8S_FQDN=`az acs list -g $RG_NAME --query [0].masterProfile.fqdn --output tsv`
-$ echo $K8S_FQDN
-```
-
-Download the Kubeconfig from the master to the local machine, make sure to use the same SSH credentials used to create the cluster:
-
-```
-$ scp -i ~/.ssh/id_rsa k8sadmin@$K8S_FQDN:.kube/config ~/.kube/k8sanddeis.config
-The authenticity of host 'mydnsprefix.myregion.cloudapp.azure.com (40.78.71.181)' can't be established.
-ECDSA key fingerprint is a0:09:ff:59:83:47:70:38:d4:0d:68:b2:cf:0f:2a:cf.
-Are you sure you want to continue connecting (yes/no)? yes
-Warning: Permanently added 'mydnsprefix.myregion.cloudapp.azure.com,40.78.71.181' (ECDSA) to the list of known hosts.
+```console
+az acs kubernetes install-cli
 ```
 
-Point `kubectl` at the kubernetes configuration file by setting the `KUBECONFIG` environment value:
+Download the master kubernetes cluster configuration to the ~/.kube/config file by running the following command:
 
-```
-export KUBECONFIG=~/.kube/k8sanddeis.config
+```console
+az acs kubernetes get-credentials --resource-group=$RG_NAME --name=$SERVICE_NAME
 ```
 
 Verify connectivity to the new ACS Kubernetes cluster by running `kubectl cluster-info`