回滚必读

回滚到 v2.5.0+

要回滚到 Rancher v2.5.0+，请使用 Rancher Backups 应用程序并从备份中恢复 Rancher。

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

通过创建 Restore 自定义资源进行还原。

重要
  • 请按照此页面上的说明在已备份的同一集群上恢复 rancher。为了将 rancher 迁移到新的集群，请按照步骤进行迁移 rancher。
  • 在使用相同设置还原 Rancher 时，Rancher deployment 在还原开始前被手动缩减，然后操作员将在还原完成后将其缩回。因此，在恢复完成之前，Rancher 和 UI 将不可用。当 UI 不可用时，可使用 kubectl 创建还原：kubectl create -f restore.yaml。

将 Rancher Deployment 的规模扩大到 0

  1. 在全局视图中，将鼠标悬停在本地集群上。
  2. 在本地的项目下，点击System。
  3. 从cattle-system命名空间部分，找到 rancher deployment。
  4. 选择⋮> Edit。
  5. 将Scalable deployment of _ pods改为0。
  6. 滚动到底部并点击保存。

创建 Restore 自定义资源

  1. 在Cluster Explorer中，进入左上角的下拉菜单，单击Rancher Backups。
    注意： 如果 Rancher Backups 应用程序在下拉列表中不可见，您需要从 Apps & Marketplace 中的 Charts 页面安装它。请参阅此处了解更多信息。

  2. 单击 Restore。

  3. 使用表单或 YAML 创建 Restore。关于使用在线表单创建 Restore 资源，请参考配置参考和示例。

  4. 使用 YAML 编辑器，你可以单击Create > Create from YAML 进入 Restore YAML。以下是还原自定义资源的示例：

    1. apiVersion: resources.cattle.io/v1
    3. kind: Restore
    5. metadata:
    7.   name: restore-migration
    9. spec:
    11.   backupFilename: backup-b0450532-cee1-4aa1-a881-f5f48a007b1c-2020-09-15T07-27-09Z.tar.gz
    13.   encryptionConfigSecretName: encryptionconfig
    15.   storageLocation:
    17.     s3:
    19.       credentialSecretName: s3-creds
    21.       credentialSecretNamespace: default
    23.       bucketName: rancher-backups
    25.       folder: rancher
    27.       region: us-west-2
    29.       endpoint: s3.us-west-2.amazonaws.com

    Copy

    有关配置 Restore 的帮助，请参阅配置参考和示例。

  5. 单击 Create。

结果：备份文件被创建并更新到目标存储位置。资源按以下顺序恢复：

  1. 自定义资源对象 (CRDs)
  2. 集群范围内的资源
  3. 命名空间资源

要查看还原的进展情况，可以查看 operator 的日志。请按照以下步骤来获取日志：

  1. kubectl get pods -n cattle-resources-system
  3. kubectl logs <pod name from above command> -n cattle-resources-system -f

Copy

回滚到以前的 Rancher 版本

Rancher 可以使用 Helm CLI 进行回滚。要回滚到以前的版本：

  1. helm rollback rancher -n cattle-system

Copy

如果以前的版本不是预定目标，你可以指定一个版本来回滚。要查看部署历史：

  1. helm history rancher -n cattle-system

Copy

当目标版本确定后，执行回滚。这个例子将回滚到版本3：

  1. helm rollback rancher 3 -n cattle-system

Copy

回滚到上一个版本

您可以使用 Rancher UI 回滚。

  1. 在 Rancher UI 中，进入本地集群。
  2. 进入系统项目。
  3. 编辑 Rancher 部署，并将镜像修改为您要回滚到的版本。
  4. 保存所做的更改。

回滚到 v2.2.x-v2.4.x

要回滚到 v2.5 之前的 Rancher，请按照这里的步骤进行。恢复备份 - Kubernetes 安装 恢复 Rancher 服务器集群的快照会将 Rancher 恢复到快照时的版本和状态。

有关如何回滚安装了 Docker 的 Rancher 的信息，请参考本页

受管集群对其状态具有权威性。这意味着恢复 rancher 服务器不会恢复工作负载部署或快照后在托管集群上所做的更改。

回滚到 v2.0.x-v2.1.x

不再支持回滚到 Rancher v2.0-v2.1。回滚到这些版本的说明保留在这里，仅用于升级到 Rancher v2.2+不可行的情况。