Upgrade your Rancher cluster using Terraform

This guide walks you through upgrading your Rancher cluster with Terraform. This guide will make use of Terraform Cloud.

Upgrading Rancher

To upgrade the kubernetes version of your Rancher cluster, follow these steps.

1 Click on variables to view all workspace variables and variable sets.

2 Locate the variable called eks_cluster_version. Its value should match a valid EKS version, such as 1.27.

3 Click the three dots in the Actions column, then select Edit variable.

4 Enter the desired EKS version as the value, and click on Save variable.

5 Navigate back to the hosting-infrastructure workspace.

6 In the top right corner, click on + New run. You can choose to run a plan (which shows what changes would be made) or plan & apply (which also applies those changes to your infrastructure).

Verifying the upgrade

If the run completes successfully, you can verify the new Rancher Kubernetes version in either AWS or Rancher itself.

AWS

1. Go to the AWS Console and open the EKS service.

2. Select the upgraded Rancher cluster and confirm that the new Kubernetes version is applied.

Rancher

1. Log in to the Rancher dashboard.

2. In the cluster overview, verify that the Kubernetes Version field for the local cluster displays the updated version.