使用 BR 恢复 Azure Blob Storage 上的备份数据

本文介绍如何将 Azure Blob Storage 上的备份数据恢复到 Kubernetes 环境中的 TiDB 集群，其中包括以下两种恢复方式：

• 全量恢复，可以将 TiDB 集群恢复到快照备份的时刻点。备份数据来自于快照备份。
• PITR 恢复，可以将 TiDB 集群恢复到历史任意时刻点。备份数据来自于快照备份和日志备份。

本文使用的恢复方式基于 TiDB Operator 的 Custom Resource Definition (CRD) 实现，底层使用 BR 进行数据恢复。BR 全称为 Backup & Restore，是 TiDB 分布式备份恢复的命令行工具，用于对 TiDB 集群进行数据备份和恢复。

PITR 全称为 Point-in-time recovery，该功能可以让你在新集群上恢复备份集群的历史任意时刻点的快照。使用 PITR 功能恢复时需要快照备份数据和日志备份数据。在恢复时，首先将快照备份的数据恢复到 TiDB 集群中，再以快照备份的时刻点作为起始时刻点，并指定任意恢复时刻点，将日志备份数据恢复到 TiDB 集群中。

全量恢复

本节示例将存储在 Azure Blob Storage 上指定路径 spec.azblob.container 存储桶中 spec.azblob.prefix 文件夹下的快照备份数据恢复到 namespace test2 中的 TiDB 集群 demo2。以下是具体的操作过程。

前置条件：完成数据备份

本节假设 Azure Blob Storage 中的桶 my-container 中文件夹 my-full-backup-folder 下存储着快照备份产生的备份数据。关于如何备份数据，请参考使用 BR 备份 TiDB 集群数据到 Azure Blob Storage。

第 1 步：准备恢复环境

使用 BR 将 Azure Blob Storage 上的备份数据恢复到 TiDB 前，请按照以下步骤准备恢复环境。

1. 创建恢复需要的 RBAC 相关资源：

   kubectl apply -n test2 -f - <<EOF
   apiVersion: rbac.authorization.k8s.io/v1
   kind: Role
   metadata:
     name: tidb-backup-manager
     labels:
       app.kubernetes.io/component: tidb-backup-manager
   rules:
   - apiGroups: [""]
     resources: ["events"]
     verbs: ["*"]
   - apiGroups: ["br.pingcap.com"]
     resources: ["backups", "restores"]
     verbs: ["get", "watch", "list", "update"]
   ---
   kind: ServiceAccount
   apiVersion: v1
   metadata:
     name: tidb-backup-manager
   ---
   kind: RoleBinding
   apiVersion: rbac.authorization.k8s.io/v1
   metadata:
     name: tidb-backup-manager
     labels:
       app.kubernetes.io/component: tidb-backup-manager
   subjects:
   - kind: ServiceAccount
     name: tidb-backup-manager
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: Role
     name: tidb-backup-manager
   EOF
   

2. 参考 Azure 账号授权授予远程存储访问权限。Azure 提供两种方式进行授权。授权成功后，namespace 中应存在名为 azblob-secret 或 azblob-secret-ad 的 Secret 对象。

   注意

   • 授权账户应至少具备对 Blob 数据的写入权限，例如具备参与者角色。
   • 在创建 Secret 对象时，你可以自定义其名称。为便于说明，本文统一使用 azblob-secret 作为示例 Secret 对象名称。

第 2 步：将指定备份数据恢复到 TiDB 集群

在 test2 这个 namespace 中创建一个名为 demo2-restore-azblob 的 Restore CR，用于恢复快照备份产生的数据：

kubectl apply -n test2 -f restore-full-azblob.yaml

restore-full-azblob.yaml 文件内容如下：

---
apiVersion: br.pingcap.com/v1alpha1
kind: Restore
metadata:
  name: demo2-restore-azblob
  namespace: test2
spec:
  br:
    cluster: demo2
    # logLevel: info
    # statusAddr: ${status_addr}
    # concurrency: 4
    # rateLimit: 0
    # timeAgo: ${time}
    # checksum: true
    # sendCredToTikv: true
  azblob:
    secretName: azblob-secret
    container: my-container
    prefix: my-full-backup-folder

在配置 restore-full-azblob.yaml 文件时，请参考以下信息：

• 关于 Azure Blob Storage 相关配置，请参考 Azure Blob Storage 存储字段介绍。
• .spec.br 中的一些参数为可选项，如 logLevel、statusAddr、concurrency、rateLimit、checksum、timeAgo、sendCredToTikv。更多 .spec.br 字段的详细解释，请参考 BR 字段介绍。
• .spec.azblob.secretName：填写你在创建 Secret 对象时设置的名称，例如 azblob-secret。
• 更多 Restore CR 字段的详细解释，请参考 Restore CR 字段介绍。

创建好 Restore CR 后，可通过以下命令查看恢复的状态：

kubectl get restore -n test2 -o wide

NAME                   STATUS     ...
demo2-restore-azblob   Complete   ...

PITR 恢复

本节示例在 namespace test3 中的 TiDB 集群 demo3 上执行 PITR 恢复，分为以下两步：

1. 使用 spec.pitrFullBackupStorageProvider.azblob.container 存储桶中 spec.pitrFullBackupStorageProvider.azblob.prefix 文件夹下的快照备份数据，将集群恢复到快照备份的时刻点。
2. 使用 spec.azblob.container 存储桶中 spec.azblob.prefix 文件夹下的日志备份的增量数据，将集群恢复到备份集群的历史任意时刻点。

下面是具体的操作过程。

前置条件：完成数据备份

本节假设 Azure Blob Storage 中的桶 my-container 中存在两份备份数据，分别是：

• 在日志备份期间，进行快照备份产生的备份数据，存储在 my-full-backup-folder-pitr 文件夹下。
• 日志备份产生的备份数据，存储在 my-log-backup-folder-pitr 文件夹下。

关于如何备份数据，请参考使用 BR 备份 TiDB 集群数据到 Azure Blob Storage。

第 1 步：准备恢复环境

与全量恢复的准备步骤相同。

第 2 步：将指定备份数据恢复到 TiDB 集群

本节示例中首先将快照备份恢复到集群中，因此 PITR 的恢复时刻点需要在快照备份的时刻点之后，并在日志备份的最新恢复点之前。具体步骤如下：

1. 在 test3 这个 namespace 中创建一个名为 demo3-restore-azblob 的 Restore CR，并指定恢复到 2022-10-10T17:21:00+08:00：

   kubectl apply -n test3 -f restore-point-azblob.yaml
   

   restore-point-azblob.yaml 文件内容如下：

   ---
   apiVersion: br.pingcap.com/v1alpha1
   kind: Restore
   metadata:
     name: demo3-restore-azblob
     namespace: test3
   spec:
     restoreMode: pitr
     br:
       cluster: demo3
     azblob:
       secretName: azblob-secret
       container: my-container
       prefix: my-log-backup-folder-pitr
     pitrRestoredTs: "2022-10-10T17:21:00+08:00"
     pitrFullBackupStorageProvider:
       azblob:
         secretName: azblob-secret
         container: my-container
         prefix: my-full-backup-folder-pitr
   

   在配置 restore-point-azblob.yaml 文件时，请参考以下信息：

   • spec.restoreMode：在进行 PITR 恢复时，需要设置值为 pitr。默认值为 snapshot，即进行全量恢复。

2. 查看恢复的状态，等待恢复操作完成：

   kubectl get jobs -n test3
   

   NAME                           COMPLETIONS   ...
   restore-demo3-restore-azblob   1/1           ...
   

   也可通过以下命令查看恢复的状态：

   kubectl get restore -n test3 -o wide
   

   NAME                   STATUS     ...
   demo3-restore-azblob   Complete   ...
   

故障诊断

在使用过程中如果遇到问题，可以参考故障诊断。