添加备份代码库

控制台

1. 登录 GDC 控制台。
2. 在导航菜单中，点击集群备份。确保在项目选择器中未选择任何项目。
3. 依次点击代码库 > 创建代码库。
4. 输入代码库名称。说明是可选的。
5. 在 S3 URI 端点字段中，输入包含对象存储区网站的完全限定域名的端点。例如 https://storagegrid.zone.DOMAIN.SUFFIX:PORT。
6. 在存储桶名称字段中，输入存储桶的完全限定名称，该名称可从 GDC 存储桶自定义资源的状态中找到。
7. 在存储桶区域字段中，输入存储桶的创建区域。
8. 在访问密钥 ID 列表中，输入存储桶 Secret 中的访问密钥 ID。
9. 在访问密钥字段中，输入存储桶 Secret 中的访问密钥。
10. 点击创建。

API

如需使用备份和恢复 API，您必须配置有效的 ClusterBackupRepository 自定义资源并提供所需的凭据。您还必须使用服务身份（通常称为服务账号）通过 API 创建代码库。

1. 获取包含 S3 凭证的 Secret 的名称：

   export PROJECT_NAME=PROJECT_NAME
   export SA_NAME=SA_NAME
   kubectl get secrets --namespace $PROJECT_NAME -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'
   

   请务必记录该命令返回的 Secret 名称，并在创建 ClusterBackupRepository 自定义资源时将其用作 SECRET_NAME 值。

   替换以下内容：

   • PROJECT_NAME：您的项目的名称。
   • SA_NAME：用于访问对象存储区的服务账号的名称。

2. 如需获取 FQDN 和端点等存储桶详细信息，请从输出中提取 fullyQualifiedName 和 zonalEndpoints 值：

   kubectl get buckets -n PROJECT_NAME BUCKET_NAME -o yaml
   

3. 添加 ClusterBackupRepository 自定义资源以使用这些凭据，并将新资源应用于 Management API 服务器。备份仓库属于集群级资源：

   apiVersion: backup.gdc.goog/v1
   kind: ClusterBackupRepository
   metadata:
     name: CLUSTER_BACKUP_REPOSITORY
     namespace: PROJECT_NAME
   spec:
     secretReference:
       namespace: PROJECT_NAME
       name: SECRET_NAME
     endpoint: END_POINT
     type: "S3"
     s3Options:
       bucket: BUCKET_FQDN
       region: REGION
       forcePathStyle: FORCE_PATH_STYLE
     importPolicy: IMPORT_POLICY
   

   替换以下内容：

   • CLUSTER_BACKUP_REPOSITORY：集群备份仓库的名称。
   • PROJECT_NAME：您的项目的名称。
   • SA_NAME：用于访问对象存储区的服务账号的名称。
   • SECRET_NAME：kubectl get secrets 命令返回的 Secret 的名称。
   • ENDPOINT：存储系统的完全限定域名，例如 https://objectstorage.google.gdch.test。对于 type 字段，仅支持 S3 值。
   • BUCKET_FQDN：存储桶的完全限定名称。
   • REGION：创建存储桶的区域。
   • FORCE_PATH_STYLE：使用 forcePathStyle 字段强制为对象使用路径样式网址。此字段的值必须为 true 或 false。
   • IMPORT_POLICY：设置为以下某一项：
     • ReadWrite：此代码库可用于安排或创建备份、备份方案和恢复。
     • ReadOnly：此代码库只能用于导入和查看备份。您无法在此代码库中创建新的备份或资源，但恢复操作可以使用和引用只读备份进行恢复。您可以随时将备份仓库用作 ReadOnly，没有频率限制。