Amazon AWS Quick Start
The following steps will quickly deploy a Rancher Server with a single node cluster attached.
Note Deploying to Amazon AWS will incur charges.
- Amazon AWS Account: An Amazon AWS Account is required to create resources for deploying Rancher and Kubernetes.
- Amazon AWS Access Key: Use this link to follow a tutorial to create an Amazon AWS Access Key if you don’t have one yet.
- Amazon AWS Key Pair Use this link and follow instructions to create a Key Pair.
- Terraform: Used to provision the server and cluster in Amazon AWS.
Clone Rancher Quickstart to a folder using
git clone https://github.com/rancher/quickstart.
Go into the AWS folder containing the terraform file by executing
terraform.tfvarsand customize the following variables at minimum. To change node counts and sizes, see
aws_access_key- Amazon AWS Access Key
aws_secret_key- Amazon AWS Secret Key
ssh_key_name- Amazon AWS Key Pair Name
prefix- Resource Prefix
Optional: Modify the count of the various node types within
terraform.tfvars. See the Quickstart Readme for more information on the variables.
To initiate the creation of the environment, run
terraform apply. Then wait for the following output:
Apply complete! Resources: 3 added, 0 changed, 0 destroyed. Outputs: rancher-url = [ https://xxx.xxx.xxx.xxx ]
rancher-urlfrom the output above into the browser. Log in when prompted (default username is
admin, and default password is
Result: Rancher Server and your Kubernetes cluster is installed in Amazon AWS.
Use Rancher to create a deployment. For more information, see Creating Deployments.
Destroying the Environment
terraform destroy --auto-approve.
Wait for confirmation that all resources have been destroyed.