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

Getting started on AWS

Prerequisites

1. You need an AWS account. Visit http://aws.amazon.com to get started
2. Install and configure AWS Command Line Interface
3. You need an AWS instance profile and role with EC2 full access.

Cluster turnup

Using wget

export KUBERNETES_PROVIDER=aws; wget -q -O - https://get.k8s.io | bash

or if you prefer curl

export KUBERNETES_PROVIDER=aws; curl -sS https://get.k8s.io | bash

NOTE: This script calls cluster/kube-up.sh which in turn calls cluster/aws/util.sh using cluster/aws/config-default.sh. By default, the script will provision a new VPC and a 4 node k8s cluster in us-west-2 (Oregon). It'll also try to create or reuse a keypair called "kubernetes", and IAM profiles called "kubernetes-master" and "kubernetes-minion". If these already exist, make sure you want them to be used here. You can override the variables defined in config-default.sh to change this behavior.

Once the cluster is up, it will print the ip address of your cluster, this process takes about 5 to 10 minutes.

export KUBERNETES_MASTER=https://<ip-address>

Copy the appropriate kubectl binary to somewhere in your PATH, for example:

# OS X
sudo cp kubernetes/platforms/darwin/amd64/kubectl /usr/local/bin/kubectl

# Linux
sudo cp kubernetes/platforms/linux/amd64/kubectl /usr/local/bin/kubectl

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

cd kubernetes
cluster/kube-down.sh

Running examples

Take a look at next steps

Cloud Formation [optional]

There is a contributed example from CoreOS using Cloud Formation.

Further reading

Please see the Kubernetes docs for more details on administering and using a Kubernetes cluster.