kubernetes/docs/getting-started-guides/aws.md
2014-11-17 21:41:13 -08:00

1.3 KiB

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

Cluster turnup

Preferred Option: Install from 0.5 release

  1. wget https://github.com/GoogleCloudPlatform/kubernetes/releases/download/v0.5/kubernetes.tar.gz
  2. tar -xzf kubernetes.tar.gz
  3. cd kubernetes

Alternate Option: Install from source at head

  1. git clone https://github.com/GoogleCloudPlatform/kubernetes.git
  2. cd kubernetes; make release

Turn up the cluster

export KUBERNETES_PROVIDER=aws
cluster/kube-up.sh

The script above relies on AWS S3 to deploy the software to instances running in EC2.

Once the cluster is up, it will print the ip address of your cluster.

export PATH=$PATH:$PWD/platforms/<os>/<platform>
export KUBERNETES_MASTER=https://<ip-address>

Running examples

Take a look at next steps

Tearing down the cluster

cd kubernetes
cluster/kube-down.sh

Cloud Formation

There is a contributed example from CoreOS using Cloud Formation.