添加备份代码库

控制台

1. 登录 GDC 控制台。
2. 在导航菜单中，点击 Backup for Clusters 。确保在项目选择器中未选择任何项目。
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 的频率没有限制。