2014-11-10 21:35:57 +00:00
|
|
|
## Getting started on AWS
|
2014-11-06 11:06:30 +00:00
|
|
|
|
2014-11-10 21:35:57 +00:00
|
|
|
### Prerequisites
|
2014-11-06 11:06:30 +00:00
|
|
|
|
2014-11-06 22:27:15 +00:00
|
|
|
1. You need an AWS account. Visit [http://aws.amazon.com](http://aws.amazon.com) to get started
|
|
|
|
|
2. Install and configure [AWS Command Line Interface](http://aws.amazon.com/cli)
|
2014-11-06 11:06:30 +00:00
|
|
|
|
2014-11-10 21:55:34 +00:00
|
|
|
### Cluster turnup
|
2014-11-06 22:27:15 +00:00
|
|
|
|
2014-11-11 04:58:42 +00:00
|
|
|
#### Install from source
|
2014-11-10 21:55:34 +00:00
|
|
|
1. ```git clone https://github.com/GoogleCloudPlatform/kubernetes.git```
|
|
|
|
|
2. ```cd kubernetes; make release```
|
|
|
|
|
|
|
|
|
|
#### Turn up the cluster
|
2014-11-06 11:06:30 +00:00
|
|
|
```
|
2014-11-06 22:27:15 +00:00
|
|
|
export KUBERNETES_PROVIDER=aws
|
|
|
|
|
cluster/kube-up.sh
|
2014-11-06 11:06:30 +00:00
|
|
|
```
|
|
|
|
|
|
2014-11-10 21:35:57 +00:00
|
|
|
The script above relies on AWS S3 to deploy the software to instances running in EC2.
|
2014-11-06 11:06:30 +00:00
|
|
|
|
2014-11-06 22:27:15 +00:00
|
|
|
### Running examples
|
|
|
|
|
|
|
|
|
|
Take a look at [next steps](https://github.com/GoogleCloudPlatform/kubernetes#where-to-go-next)
|
2014-11-06 11:06:30 +00:00
|
|
|
|
2014-11-06 22:27:15 +00:00
|
|
|
### Tearing down the cluster
|
2014-11-06 11:06:30 +00:00
|
|
|
```
|
2014-11-06 22:27:15 +00:00
|
|
|
cd kubernetes
|
|
|
|
|
cluster/kube-down.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Cloud Formation
|
2014-11-10 21:55:34 +00:00
|
|
|
There is a contributed [example](aws-coreos.md) from [CoreOS](http://www.coreos.com) using Cloud Formation.
|
