Documentation survey

回滚

本页概述了如何在升级 Rancher 后将 Rancher 回滚到之前的版本。

  • This is only possible by restoring to a previous version from a backup instance. Changing versions using kubectl or Helm is not supported.

  • When rolling back, ensure the version being restored is under active support. Rolling back to versions that are end-of-life is not supported. Refer to SUSE’s Product Support Lifecycle page to verify key lifecycle dates for your given version.

请在以下情况时按照本页的说明进行操作：

  • 正在运行的 Rancher 实例在备份完成后升级到了更新的版本。

  • 上游（本地）集群与进行备份的集群相同。

To roll back Rancher to a lower/previous version, use the Rancher Backups application and restore Rancher from backup.

回滚后，Rancher 必须以较低/较早的版本启动。

还原是通过创建 Restore 自定义资源实现的。

重要提示：

  • 请按照此页面上的说明在已备份的同一集群上还原 Rancher。要把 Rancher 迁移到新集群，请参照步骤迁移 Rancher。

  • 在使用相同设置恢复 Rancher 时，Rancher deployment 在恢复开始前被手动缩减，然后 Operator 将在恢复完成后将其缩回。因此，在恢复完成之前，Rancher 和 UI 都将不可用。如果 UI 不可用时，你可使用 kubectl create -f restore.yamlYAML 恢复文件来使用初始的集群 kubeconfig。

步骤 1 ：创建 Restore 自定义资源

  1. 点击 ☰ > 集群管理。

  2. 找到你的本地集群，并点击 Explore。

  3. 在左侧导航栏中，点击 Rancher 备份  还原。

如果 Rancher Backups 应用不可见，你需要到 Apps 的 Charts 页面中安装应用。详情请参见此处。

  1. 单击创建。

  2. 使用表单或 YAML 创建 Restore。如需获取使用表单创建 Restore 资源的更多信息，请参见配置参考和示例。

  3. 如需使用 YAML 编辑器，点击创建  使用 YAML 文件创建。然后输入 Restore YAML。以下是 Restore 自定义资源示例：

    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.com

    如需获得配置 Restore 的帮助，请参见配置参考和示例。

  4. 单击创建。

结果：已创建备份文件并更新到目标存储位置。资源还原顺序如下：

  1. 自定义资源定义（CRD）

  2. 集群范围资源

  3. 命名空间资源

如需查看还原的处理方式，请检查 Operator 的日志。按照如下步骤获取日志：

kubectl get pods -n cattle-resources-system
kubectl logs -n cattle-resources-system -f

步骤 2：回滚到上一个 Rancher 版本

你可以使用 Helm CLI 回滚 Rancher。要回滚到上一个版本：

helm rollback rancher -n cattle-system

如果你不是想回滚到上一个版本，你也可以指定回滚的版本。查看部署历史记录：

helm history rancher -n cattle-system

确定目标版本后，执行回滚。此示例回滚到版本 3：

helm rollback rancher 3 -n cattle-system