Skip to content
This repository has been archived by the owner on Nov 30, 2021. It is now read-only.

Commit

Permalink
docs(azure): streamline azure boot process
Browse files Browse the repository at this point in the history
  • Loading branch information
dtzar committed Jan 9, 2017
1 parent 70f50a5 commit d430e42
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 20 deletions.
4 changes: 2 additions & 2 deletions src/quickstart/install-cli-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).

Expand Down
26 changes: 8 additions & 18 deletions src/quickstart/provider/azure-acs/boot.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

Expand Down Expand Up @@ -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`
Expand Down

0 comments on commit d430e42

Please sign in to comment.