备份 Rancher

在本节中，你将学习如何备份运行在任何 Kubernetes 集群上的 Rancher。要备份通过 Docker 安装的 Rancher，请参见单节点备份。

backup-restore operator 需要安装在 local 集群上，并且只对 Rancher 应用进行备份。备份和恢复操作仅在本地 Kubernetes 集群中执行。

请知悉，rancher-backup operator 的 2.x.x 版本用于 Rancher v2.6.x。

备份 Rancher - 图1警告

当把备份恢复到一个新的 Rancher 设置中时，新设置的版本应该与备份的版本相同。在恢复备份时还应考虑 Kubernetes 的版本，因为集群中支持的 apiVersion 和备份文件中的 apiVersion 可能不同。

先决条件

Rancher 必须是 2.5.0 或更高版本。

请参见此处获取在 Rancher 2.6.3 中将现有备份文件恢复到 v1.22 集群的帮助。

1. 安装 rancher backup operator

备份存储位置是 operator 级别的设置，所以需要在安装或升级 rancher backup 应用时进行配置。

备份文件的格式是 .tar.gz。这些文件可以推送到 S3 或 Minio，也可以存储在一个持久卷中。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在集群页面上，转到 local 集群并单击 Explore。Rancher Server 运行在 local 集群中。
  3. 单击 Apps > Charts。
  4. 点击 Rancher 备份。
  5. 单击安装。
  6. 配置默认存储位置。如需获取帮助，请参见存储配置。
  7. 单击安装。

备份 Rancher - 图2备注

使用 backup-restore operator 执行恢复后，Fleet 中会出现一个已知问题：用于 clientSecretName 和 helmSecretName 的密文不包含在 Fleet 的 Git 仓库中。请参见此处获得解决方法。

2. 执行备份

要执行备份，必须创建 Backup 类型的自定义资源。

  1. 在左上角，单击 ☰ > 集群管理。

  2. 在集群页面上，转到 local 集群并单击 Explore。

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

  4. 单击创建。

  5. 使用表单或 YAML 编辑器创建 Backup。

  6. 要使用该表单配置 Backup 详细信息，请单击创建，然后参见配置参考和示例进行操作。

  7. 要使用 YAML 编辑器，单击创建 > 使用 YAML 文件创建。输入 Backup YAML。这个示例 Backup 自定义资源将在 S3 中创建加密的定期备份。这个应用使用 credentialSecretNamespace 值来确定在哪里寻找 S3 备份的密文：

    1. apiVersion: resources.cattle.io/v1
    2. kind: Backup
    3. metadata:
    4.   name: s3-recurring-backup
    5. spec:
    6.   storageLocation:
    7.     s3:
    8.       credentialSecretName: s3-creds
    9.       credentialSecretNamespace: default
    10.       bucketName: rancher-backups
    11.       folder: rancher
    12.       region: us-west-2
    13.       endpoint: s3.us-west-2.amazonaws.com
    14.   resourceSetName: rancher-resource-set
    15.   encryptionConfigSecretName: encryptionconfig
    16.   schedule: "@every 1h"
    17.   retentionCount: 10

    备份 Rancher - 图3备注

    使用 YAML 编辑器创建 Backup 资源时，resourceSetName 必须设置为 rancher-resource-set。

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

    备份 Rancher - 图4警告

    rancher-backup operator 不保存 EncryptionConfiguration 文件。创建加密备份时，必须保存 EncryptionConfiguration 文件的内容，而且在使用备份还原时必须使用同一个文件。

  8. 单击创建。

结果：备份文件创建在 Backup 自定义资源中配置的存储位置中。执行还原时使用该文件的名称。