Home
Getting Started
Documentation
Community
Events
Media
Blog

This is an archived version of the documentation. View the latest version here.

Getting started on Microsoft Azure

Table of Contents

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

Starting a cluster

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= AZ_SUBNET=

You can create a virtual network:

azure network vnet create --subnet-name= --location "West US" -v

Now you're ready.

You can download and install the latest Kubernetes release from this page, then run the <kubernetes>/cluster/kube-up.sh script to start the cluster:

cd kubernetes 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.

Adding the Kubernetes command line tools to PATH

The kubectl tool controls the Kubernetes cluster manager. It lets you inspect your cluster resources, create, delete, and update components, and much more. You will use it to look at your new cluster and bring up example apps.

Add the appropriate binary folder to your PATH to access kubectl:

# OS X export PATH=/platforms/darwin/amd64:$PATH

# Linux export PATH=/platforms/linux/amd64:$PATH

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