Upgrade a cluster

You can upgrade the version of Kubernetes that runs your clusters directly from your Release control panel. Note that this will put your cluster into maintenance mode for 30-60 minutes. Downtime is not expected, but you should not perform upgrades during critical or peak hours.

Steps

1. On your Account Settings page, navigate to Clusters and select the cluster you want to upgrade.

1. On the Cluster Info page, you can view the current version of the cluster. If an upgrade is available, you will see the Upgrade Cluster button. Press Upgrade Cluster.

1. You'll see a confirmation dialog, summarizing the cluster version you are on, and which version you will be upgraded to. Press Confirm.

1. Your cluster will go into maintenance mode and then automatically go back into "Running" once the upgrade is complete.

Troubleshooting and notes

Note that you can only upgrade one version at a time. In order to upgrade, for example, from 1.19 to 1.21, you will first have to upgrade to 1.20.

While the cluster is in maintenance mode, you may not be able to perform deployments or builds in that cluster, but your services should continue running.

If the Upgrade Cluster button is grayed out, it means we do not currently support an automatic upgrade path from your current cluster version. In this case, you can continue using your current version or reach out to us to help you upgrade your cluster.

For AWS clusters, we support AWS EKS versions as closely as possible. You can read more about the supported versions and end-of-life dates on AWS.

If your cluster stays in maintenance mode for more than one hour or shows any unexpected errors, please contact Release support.

Note that users with "member" permissions cannot perform cluster upgrades. They will not see the Upgrade Cluster button and will need to ask a user with "owner" permissions to perform the upgrade instead.