Skip to content

Latest commit

 

History

History
78 lines (50 loc) · 2.58 KB

azure.md

File metadata and controls

78 lines (50 loc) · 2.58 KB
Raw

*** PLEASE NOTE: This document applies to the HEAD of the source tree only. If you are using a released version of Kubernetes, you almost certainly want the docs that go with that version.

Documentation for specific releases can be found at releases.k8s.io.

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
  3. If you want to build your own release, you need to have Docker installed. On Mac OS X you can use boot2docker.

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 to try out your new cluster.

For more complete applications, please look in the examples directory.

Tearing down the cluster

cluster/kube-down.sh

Analytics