This deployment guide shows you how to set up a bare-metal Rancher Kubernetes Engine (RKE) cluster on which Coder can deploy.
See here for the full list of Rancher requirements. You must have at least one Linux host (node) with the following utilities installed:
To configure pod networking, you'll need to install a Container Network Interface (CNI) into the Rancher cluster. Here are Rancher's recommended CNI providers
- Once you've installed the necessary dependencies, create a
cluster.ymlfile to define the Rancher cluster configuration. Below is an example for a single-node cluster:
nodes: - address: 10.206.0.2 user: ubuntu role: - controlplane - etcd - worker ssh_key_path: /home/ubuntu/.ssh/id_rsa ssh_agent_auth: true
Ensure the user is a member of the docker group.
For a multi-node, high availability cluster, see the Rancher documentation for additional configuration values.
- Deploy the cluster with the following command:
rke up --config cluster.yml
- After the cluster is brought up, create your
kubeconfigfile and copy over the Rancher-generated configuration:
mkdir -p $HOME/.kube/ && cp kube_config_cluster.yml $HOME/.kube/config
Once complete, you can now install Coder on to your Rancher cluster.