Marty Hernandez Avedon
0a7c7e7230
* 1172-refresh-helm-charts-in-rancher-page * wording revised, steps compressed * smoothing instructions, syncing language in similar steps * updated heading levels * versioning * versioned headings * Apply suggestions from code review Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * rm'd br tag, revised descr of project/namespace filter, made all nouns plural to match verb * Apply suggestions from code review missed one Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> * Helm apps > Kubernetes apps * h3 heading and moved feature charts section * absolute link to older docs, spacing * heading levels * reorganizing/renaming helm charts in rancher section * rename some headings * changing path to apps/repositories to instead go through explore button * once > after * engineers say the default branch is set by the remote repo. Rancher will respect whatever that default is unless you specifically tell it to pull from another branch * straggler * fix in-page links after heading changed * wrong verb! * hyphen * moved section up as to not interrupt flow * moved info about upstream charts * moved line 64 to part of line 31 * Apply suggestions from code review Co-authored-by: Billy Tat <btat@suse.com> * Update versioned_docs/version-2.8/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Update versioned_docs/version-2.8/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Update versioned_docs/version-2.7/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Update versioned_docs/version-2.7/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Update docs/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Update docs/how-to-guides/new-user-guides/helm-charts-in-rancher/helm-charts-in-rancher.md Co-authored-by: Billy Tat <btat@suse.com> * Apply suggestions from code review Co-authored-by: Billy Tat <btat@suse.com> --------- Co-authored-by: Lucas Saintarbor <lucas.saintarbor@suse.com> Co-authored-by: Billy Tat <btat@suse.com>
6.6 KiB
title
| title |
|---|
| Rollbacks |
Additional Steps for Rollbacks with Rancher v2.6.4+
Rancher v2.6.4 upgrades the cluster-api module from v0.4.4 to v1.0.2. Version v1.0.2 of the cluster-api, in turn, upgrades the Cluster API's Custom Resource Definitions (CRDs) from cluster.x-k8s.io/v1alpha4 to cluster.x-k8s.io/v1beta1. The CRDs upgrade to v1beta1 causes rollbacks to fail when you attempt to move from Rancher v2.6.4 to any previous version of Rancher v2.6.x. This is because CRDs that use the older apiVersion (v1alpha4) are incompatible with v1beta1.
To avoid rollback failure, the following Rancher scripts should be run before you attempt a restore operation or rollback:
verify.sh: Checks for any Rancher-related resources in the cluster.cleanup.sh: Cleans up the cluster.
See the rancher/rancher-cleanup repo for more details and source code.
:::caution
There will be downtime while cleanup.sh runs, since the script deletes resources created by Rancher.
:::
Rolling back from v2.6.4+ to lower versions of v2.6.x
- Follow these instructions to run the scripts.
- Follow these instructions to install the rancher-backup Helm chart on the existing cluster and restore the previous state.
- Omit Step 3.
- When you reach Step 4, install the Rancher v2.6.x version on the local cluster you intend to roll back to.
Rolling Back to Rancher v2.5.0+
To roll back to Rancher v2.5.0+, use the Rancher Backups application and restore Rancher from backup.
Rancher has to be started with the lower/previous version after a rollback.
A restore is performed by creating a Restore custom resource.
:::note Important:
-
Follow the instructions from this page for restoring Rancher on the same cluster where it was backed up from. In order to migrate Rancher to a new cluster, follow the steps to migrate Rancher.
-
While restoring Rancher on the same setup, the Rancher deployment is manually scaled down before the restore starts, then the operator will scale it back up once the restore completes. As a result, Rancher and its UI will be unavailable until the restore is complete. While the UI is unavailable, use the original cluster kubeconfig with the restore YAML file:
kubectl create -f restore.yaml.
:::
Create the Restore Custom Resource
-
Click ☰ > Cluster Management.
-
Go to the local cluster and click Explore.
-
In the left navigation bar, click Rancher Backups > Restore. :::note
If the Rancher Backups app is not visible, you will need to install it from the Charts page in Apps. Refer here for more information.
:::
-
Click Create.
-
Create the Restore with the form or with YAML. For help creating the Restore resource using the online form, refer to the configuration reference and to the examples.
-
To use the YAML editor, you can click Create > Create from YAML. Enter the Restore YAML. The following is an example Restore custom resource:
apiVersion: resources.cattle.io/v1 kind: Restore metadata: name: restore-migration spec: backupFilename: backup-b0450532-cee1-4aa1-a881-f5f48a007b1c-2020-09-15T07-27-09Z.tar.gz encryptionConfigSecretName: encryptionconfig storageLocation: s3: credentialSecretName: s3-creds credentialSecretNamespace: default bucketName: rancher-backups folder: rancher region: us-west-2 endpoint: s3.us-west-2.amazonaws.comFor help configuring the Restore, refer to the configuration reference and to the examples.
-
Click Create.
Result: The backup file is created and updated to the target storage location. The resources are restored in this order:
- Custom Resource Definitions (CRDs)
- Cluster-scoped resources
- Namespaced resources
To check how the restore is progressing, you can check the logs of the operator. Follow these steps to get the logs:
kubectl get pods -n cattle-resources-system
kubectl logs -n cattle-resources-system -f
Roll back to a previous Rancher version
Rancher can be rolled back using the Helm CLI. To roll back to the previous version:
helm rollback rancher -n cattle-system
If the previous revision is not the intended target, you can specify a revision to roll back to. To see the deployment history:
helm history rancher -n cattle-system
When the target revision is determined, perform the rollback. This example will roll back to revision 3:
helm rollback rancher 3 -n cattle-system
Rolling Back to Rancher v2.2-v2.4+
To roll back to Rancher before v2.5, follow the procedure detailed here: Restoring Backups — Kubernetes installs Restoring a snapshot of the Rancher server cluster will revert Rancher to the version and state at the time of the snapshot.
For information on how to roll back Rancher installed with Docker, refer to this page.
:::note
Managed clusters are authoritative for their state. This means restoring the Rancher server will not revert workload deployments or changes made on managed clusters after the snapshot was taken.
:::
Rolling Back to Rancher v2.0-v2.1
Rolling back to Rancher v2.0-v2.1 is no longer supported. The instructions for rolling back to these versions are preserved here and are intended to be used only in cases where upgrading to Rancher v2.2+ is not feasible.