179fa8cb61
Put a Prerequisites section in all the hosted gettting-started-guides. Change how title and contents are formatted so they are not automatically included in the ToC. Tweak other section headers to improve ToCs.
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
Getting started on Microsoft Azure
|
|
----------------------------------
|
|
|
|
**Table of Contents**
|
|
|
|
- [Prerequisites](#prerequisites)
|
|
- [Setup](#setup)
|
|
- [Getting started with your cluster](#getting-started-with-your-cluster)
|
|
- [Tearing down the cluster](#tearing-down-the-cluster)
|
|
|
|
|
|
## Prerequisites
|
|
|
|
** Azure Prerequisites**
|
|
|
|
1. You need an Azure account. Visit http://azure.microsoft.com/ to get started.
|
|
2. Install and configure the Azure cross-platform command-line interface. http://azure.microsoft.com/en-us/documentation/articles/xplat-cli/
|
|
3. Make sure you have a default account set in the Azure cli, using `azure account set`
|
|
|
|
**Prerequisites for your workstation**
|
|
|
|
1. Be running a Linux or Mac OS X.
|
|
2. Get or build a [binary release](binary_release.md)
|
|
3. If you want to build your own release, you need to have [Docker
|
|
installed](https://docs.docker.com/installation/). On Mac OS X you can use
|
|
[boot2docker](http://boot2docker.io/).
|
|
|
|
## Setup
|
|
The cluster setup scripts can setup Kubernetes for multiple targets. First modify `cluster/kube-env.sh` to specify azure:
|
|
|
|
KUBERNETES_PROVIDER="azure"
|
|
|
|
Next, specify an existing virtual network and subnet in `cluster/azure/config-default.sh`:
|
|
|
|
AZ_VNET=<vnet name>
|
|
AZ_SUBNET=<subnet name>
|
|
|
|
You can create a virtual network:
|
|
|
|
azure network vnet create <vnet name> --subnet=<subnet name> --location "West US" -v
|
|
|
|
Now you're ready.
|
|
|
|
You can then use the `cluster/kube-*.sh` scripts to manage your azure cluster, start with:
|
|
|
|
cluster/kube-up.sh
|
|
|
|
The script above will start (by default) a single master VM along with 4 worker VMs. You
|
|
can tweak some of these parameters by editing `cluster/azure/config-default.sh`.
|
|
|
|
## Getting started with your cluster
|
|
See [a simple nginx example](../../examples/simple-nginx.md) to try out your new cluster.
|
|
|
|
For more complete applications, please look in the [examples directory](../../examples).
|
|
|
|
## Tearing down the cluster
|
|
```
|
|
cluster/kube-down.sh
|
|
```
|
|
|
|
|
|
[]()
|