Rancher 回滚指南

回滚到 Rancher v2.5.0+

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

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

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

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

将 Rancher Deployment 的规模扩展到 0

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

创建 Restore 自定义资源

1. 在Cluster Explorer中，进入左上角的下拉菜单，单击Rancher Backups。

注意： 如果 Rancher Backups 应用程序在下拉列表中不可见，您需要从 Apps & Marketplace 中的 Charts 页面安装它。请参阅此处（ https://docs.rancher.cn/docs/rancher2.5/helm-charts/_index#charts ）了解更多信息。

2. 单击 Restore。

3. 使用表单或 YAML 创建 Restore。关于使用在线表单创建 Restore 资源，请参考配置参考（ https://docs.rancher.cn/docs/rancher2.5/backups/configuration/restore-config/_index ）和示例（ https://docs.rancher.cn/docs/rancher2.5/backups/examples/_index ）。

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

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 的帮助，请参阅配置参考（https://docs.rancher.cn/docs/rancher2.5/backups/configuration/restore-config/_index）和示例（https://docs.rancher.cn/docs/rancher2.5/backups/examples/_index）。

5. 单击 Create。

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

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

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

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

回滚到以前的 Rancher 版本

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

helm rollback rancher -n cattle-system

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

helm history rancher -n cattle-system

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

helm rollback rancher 3 -n cattle-system

回滚到上一个版本

您可以使用 Rancher UI 回滚。

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