Skip to content

Cannot upgrade Rancher-provisioned RKE clusters using an RKE template

This document (000021637) is provided subject to the disclaimer at the end of this document.

Environment

  • Rancher v2.9.x < v2.9.5
  • A Rancher-provisioned RKE cluster using an RKE Template

Situation

Attempting to upgrade downstream clusters using RKE templates in Rancher v2.9.0 - v2.9.4 may fail. When navigating to Cluster Management in the Rancher UI and selecting Edit Config for a templated RKE cluster, after changing the template revision to a template with a newer Kubernetes version, sections of the form including Kubernetes options, private registries, and advanced options disappear.

Resolution

The issue is fixed in Rancher v2.9.5 and above, and you should upgrade to take advantage of the fix.

To workaround the issue in Rancher v2.9.0 - v2.9.4, affected clusters can be upgraded using the Rancher v3 API.

Workaround Steps:

  1. Access the Rancher v3 API of the downstream cluster where you want to upgrade the Kubernetes version: https://[RANCHER-URL]/v3/clusters/[CLUSTER-ID]
  2. To easily find the cluster ID, within the Rancher UI navigate to Cluster Management and select the cluster

  3. On the URL bar, you will see something similar to:

    https://[RANCHER-URL]/dashboard/c/_/manager/provisioning.cattle.io.cluster/fleet-default/ c-xxxxx

    The last 7 characters (c-xxxxx) are your cluster ID. 2. You will be able to see now the Rancher v3 API. In the top-right corner, you will see an operations window. 3. Click on Edit and you will see all the cluster's configurations. 4. Make use of the Ctrl+F search to find the "clusterTemplateRevisionId" value. 5. It should show a select field where you can see all your template revisions. 6. Select the revision to which you wish to upgrade the cluster. 7. Scroll down and click on the Show Request button. 8. Scroll down again and click on the Send Request button to apply the changes.

Additional Information

Disclaimer

This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.