How to rollback the Kubernetes version of a Rancher v2.x provisioned cluster

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



This article details how to rollback the Kubernetes version of a Rancher v2.x provisioned cluster.

Important Note:

A Kubernetes Cluster Rollback will most definitely cause downtime in the cluster, as you are restoring a snapshot from before the upgrade and the cluster will have to reconcile state.


  • In order to rollback your Kubernetes cluster version upgrade, you need to have first taken an etcd snapshot from before the upgrade. You should keep the reference to the snapshot name that was created as your "pre-upgrade" snapshot. In my cluster which has cluster ID: c-q8st7 , my snapshot name was c-q8st7-ml-qdxdh. Our example upgrade is from v1.14.9-rancher1-2 to v1.15.7-rancher1-1.

Rollback operation

In order to rollback, you must:

  1. Edit Cluster
  2. Edit as YAML
  3. Set kubernetes_version back to v1.14.9-rancher1-2 (or whatever your desired restore version is)
  4. Find the restore key in the YAML.

    You will need to update the following configuration:

        restore: false

    You'll want to closely model the following:

        restore: true
        snapshot_name: "c-q8st7:c-q8st7-ml-qdxdh"

    Note the snapshot_name has the cluster ID prefixed to it with a : .

  5. Finally, you can save the cluster, and observe the snapshot restore + K8s version rollback occur.


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.

  • Document ID:000020195
  • Creation Date: 06-May-2021
  • Modified Date:06-May-2021
    • SUSE Rancher

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Join Our Community

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

SUSE Customer Support Quick Reference Guide SUSE Technical Support Handbook Update Advisories
Support FAQ

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.

Go to Customer Center