kubernetes/docs/getting-started-guides/azure.md

Getting started on Microsoft Azure

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 in cluster/azure/config-defualt.sh:

AZ_VNET=<vnet name>

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.

Running a container (simple version)

The cluster/kubecfg.sh command below spins up two containers, running Nginx and with port 80 mapped to 8080:

cd kubernetes
cluster/kubecfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx

To stop the containers:

cluster/kubecfg.sh stop myNginx

To delete the containers:

cluster/kubecfg.sh rm myNginx

Running a container (more complete version)

You can create a pod like this:

cd kubernetes
cluster/kubecfg.sh -c api/examples/pod.json create /pods

Where pod.json contains something like:

{
  "id": "php",
  "kind": "Pod",
  "apiVersion": "v1beta1",
  "desiredState": {
    "manifest": {
      "version": "v1beta1",
      "id": "php",
      "containers": [{
        "name": "nginx",
        "image": "dockerfile/nginx",
        "ports": [{
          "containerPort": 80,
          "hostPort": 8080
        }],
        "livenessProbe": {
          "enabled": true,
          "type": "http",
          "initialDelaySeconds": 30,
          "httpGet": {
            "path": "/index.html",
            "port": "8080"
          }
        }
      }]
    }
  },
  "labels": {
    "name": "foo"
  }
}

You can see your cluster's pods:

cluster/kubecfg.sh list pods

and delete the pod you just created:

cluster/kubecfg.sh delete pods/php

Look in api/examples/ for more examples

Tearing down the cluster

cd kubernetes
cluster/kube-down.sh