版本：v2.7

还原 Rancher

本页概述了如何使用 Rancher 执行恢复。

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

正在运行的 Rancher 实例与备份时的版本相同。
上游（本地）集群与备份的位置相同。

重要提示

在使用相同设置还原 Rancher 时，operator 将在还原开始时缩减 Rancher deployment，还原完成后又会扩展 deployment。因此，Rancher 在还原期间将不可用。

提示

按照以下步骤迁移 Rancher。
如果你需要在升级后将 Rancher 还原到先前版本，请参见回滚。

创建 Restore 自定义资源

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

在左上角，单击 ☰ > 集群管理。
在集群页面上，转到 local 集群并单击 Explore。Rancher Server 运行在 local 集群中。
在左侧导航栏中，单击 Rancher 备份 > 还原。
单击创建。
使用表单或 YAML 创建 Restore。如需获取使用表单创建 Restore 资源的更多信息，请参见配置参考和示例。

要使用 YAML 编辑器，单击创建 > 使用 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 的帮助，请参见配置参考和示例。

单击创建。

结果：rancher-operator 在还原过程中将 Rancher deployment 缩容，并在还原完成后将它重新扩容。资源还原顺序如下：

自定义资源定义（CRD）
集群范围资源
命名空间资源

日志

如需查看还原的处理方式，请检查 Operator 的日志。查看日志的命令如下：

kubectl logs -n cattle-resources-system -l app.kubernetes.io/name=rancher-backup -f

清理

如果你使用 kubectl 创建了 Restore 资源，请删除该资源以防止与未来的还原发生命名冲突。

已知问题

在某些情况下，恢复备份后，Rancher 日志会显示类似以下的错误：

2021/10/05 21:30:45 [ERROR] error syncing 'c-89d82/m-4067aa68dd78': handler rke-worker-upgrader: clusters.management.cattle.io "c-89d82" not found, requeuing

发生这种情况的原因是，刚刚还原的某个资源有 finalizer，但相关的资源已经被删除，导致处理程序无法找到该资源。

为了消除这些错误，你需要找到并删除导致错误的资源。详情请参见此处。

创建 Restore 自定义资源​

日志​

清理​

已知问题​

创建 Restore 自定义资源

日志

清理

已知问题