The following steps will quickly deploy a Rancher Server with a single node cluster attached.

Prerequisites

Note Deploying to DigitalOcean will incur charges.

• DigitalOcean Account: You will require an account on DigitalOcean as this is where the server and cluster will run.
• DigitalOcean Access Key: Use this link to create a DigitalOcean Access Key if you don't have one.
• Terraform: Used to provision the server and cluster to DigitalOcean.

Getting Started

1. Clone Rancher Quickstart to a folder using git clone https://github.com/rancher/quickstart.

2. Go into the DigitalOcean folder containing the terraform file by executing cd quickstart/do.

3. Rename the terraform.tfvars.example file to terraform.tfvars.

4. Edit terraform.tfvars to include your DigitalOcean Access Key.

5. Optional: Edit terraform.tfvars to:

   • Change the number of nodes. (count_agent_all_nodes)
   • Change the password of the admin user for logging into Rancher. (admin_password)

6. Run terraform init.

7. To initiate the creation of the environment, run terraform apply. Then wait for the the following output:

   Apply complete! Resources: 2 added, 0 changed, 0 destroyed. Outputs: rancher-url = [ https://xxx.xxx.xxx.xxx ]

8. Paste the rancher-url from the output above into the browser. Log in when prompted (default password is admin).

Result: Rancher Server and your Kubernetes cluster is installed on DigitalOcean.

What's Next?

Use Rancher to create a deployment. For more information, see Creating Deployments.

Destroying the Environment

1. From the quickstart/do folder, execute terraform destroy --force.

2. Wait for confirmation that all resources have been destroyed.