Note: requires Terraform v0.13

This Terraform setup will:

• Start a droplet running rancher/rancher version specified in rancher_version
• Create a custom cluster called cluster_name
• Start count_agent_all_nodes amount of droplets and add them to the custom cluster with all roles
• Create an ssh_config file in the terraform module directory for connecting to the droplets

• Start count_agent_etcd_nodes amount of droplets and add them to the custom cluster with etcd role
• Start count_agent_controlplane_nodes amount of droplets and add them to the custom cluster with controlplane role
• Start count_agent_worker_nodes amount of droplets and add them to the custom cluster with worker role

All available options/variables are described in terraform.tfvars.example.

You can add a tools node, which consists of some software that can be used for Rancher tooling like notifiers and logging. See below for more information on the current software included:

Note: replace PRIVATE_IP or PUBLIC_IP with tools-private-ip or tools-public-ip

Note: set the appropriate users for the images in the terraform variables, default is root

You can use the use the auto-generated ssh_config file to connect to the droplets by droplet name, e.g. ssh <prefix>-rancheragent-all-0 or ssh <prefix>-rancherserver etc. To do so, you have two options:

1. Add an Include directive at the top of the SSH config file in your home directory (~/.ssh/config) to include the ssh_config file at the location you have checked out the this repository, e.g. Include ~/git/tf-do-rancher2/ssh_config.

2. Specify the ssh_config file when invoking ssh via the -F option, e.g. ssh -F ~/git/tf-do-rancher2/ssh_config <host>.

• Clone this repository
• Move the file terraform.tfvars.example to terraform.tfvars and edit (see inline explanation)
• Run terraform apply