github.com/enmand/kubernetes@v1.2.0-alpha.0/docs/getting-started-guides/azure.md (about)

     1  <!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
     2  
     3  <!-- BEGIN STRIP_FOR_RELEASE -->
     4  
     5  <img src="http://kubernetes.io/img/warning.png" alt="WARNING"
     6       width="25" height="25">
     7  <img src="http://kubernetes.io/img/warning.png" alt="WARNING"
     8       width="25" height="25">
     9  <img src="http://kubernetes.io/img/warning.png" alt="WARNING"
    10       width="25" height="25">
    11  <img src="http://kubernetes.io/img/warning.png" alt="WARNING"
    12       width="25" height="25">
    13  <img src="http://kubernetes.io/img/warning.png" alt="WARNING"
    14       width="25" height="25">
    15  
    16  <h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
    17  
    18  If you are using a released version of Kubernetes, you should
    19  refer to the docs that go with that version.
    20  
    21  <strong>
    22  The latest 1.0.x release of this document can be found
    23  [here](http://releases.k8s.io/release-1.0/docs/getting-started-guides/azure.md).
    24  
    25  Documentation for other releases can be found at
    26  [releases.k8s.io](http://releases.k8s.io).
    27  </strong>
    28  --
    29  
    30  <!-- END STRIP_FOR_RELEASE -->
    31  
    32  <!-- END MUNGE: UNVERSIONED_WARNING -->
    33  Getting started on Microsoft Azure
    34  ----------------------------------
    35  
    36  **Table of Contents**
    37  
    38  - [Prerequisites](#prerequisites)
    39  - [Setup](#setup)
    40  - [Getting started with your cluster](#getting-started-with-your-cluster)
    41  - [Tearing down the cluster](#tearing-down-the-cluster)
    42  
    43  
    44  ## Prerequisites
    45  
    46  **Azure Prerequisites**
    47  
    48  1. You need an Azure account. Visit http://azure.microsoft.com/ to get started.
    49  2. Install and configure the Azure cross-platform command-line interface. http://azure.microsoft.com/en-us/documentation/articles/xplat-cli/
    50  3. Make sure you have a default account set in the Azure cli, using `azure account set`
    51  
    52  **Prerequisites for your workstation**
    53  
    54  1. Be running a Linux or Mac OS X.
    55  2. Get or build a [binary release](binary_release.md)
    56  3. If you want to build your own release, you need to have [Docker
    57  installed](https://docs.docker.com/installation/).  On Mac OS X you can use
    58  [boot2docker](http://boot2docker.io/).
    59  
    60  ## Setup
    61  
    62  ### Starting a cluster
    63  
    64  The cluster setup scripts can setup Kubernetes for multiple targets. First modify `cluster/kube-env.sh` to specify azure:
    65  
    66      KUBERNETES_PROVIDER="azure"
    67  
    68  Next, specify an existing virtual network and subnet in `cluster/azure/config-default.sh`:
    69  
    70      AZ_VNET=<vnet name>
    71      AZ_SUBNET=<subnet name>
    72  
    73  You can create a virtual network:
    74  
    75      azure network vnet create <vnet name> --subnet-name=<subnet name> --location "West US" -v
    76  
    77  Now you're ready.
    78  
    79  You can download and install the latest Kubernetes release from [this page](https://github.com/kubernetes/kubernetes/releases), then run the `<kubernetes>/cluster/kube-up.sh` script to start the cluster:
    80  
    81      cd kubernetes
    82      cluster/kube-up.sh
    83  
    84  The script above will start (by default) a single master VM along with 4 worker VMs.  You
    85  can tweak some of these parameters by editing `cluster/azure/config-default.sh`.
    86  
    87  ### Adding the Kubernetes command line tools to PATH
    88  
    89  The [kubectl](../../docs/user-guide/kubectl/kubectl.md) tool controls the Kubernetes cluster manager.  It lets you inspect your cluster resources, create, delete, and update components, and much more.
    90  You will use it to look at your new cluster and bring up example apps.
    91  
    92  Add the appropriate binary folder to your `PATH` to access kubectl:
    93  
    94      # OS X
    95      export PATH=<path/to/kubernetes-directory>/platforms/darwin/amd64:$PATH
    96  
    97      # Linux
    98      export PATH=<path/to/kubernetes-directory>/platforms/linux/amd64:$PATH
    99  
   100  ## Getting started with your cluster
   101  
   102  See [a simple nginx example](../user-guide/simple-nginx.md) to try out your new cluster.
   103  
   104  For more complete applications, please look in the [examples directory](../../examples/).
   105  
   106  ## Tearing down the cluster
   107  
   108  ```sh
   109  cluster/kube-down.sh
   110  ```
   111  
   112  
   113  <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
   114  [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/azure.md?pixel)]()
   115  <!-- END MUNGE: GENERATED_ANALYTICS -->