新增備份存放區

控制台

1. 登入 GDC 控制台。
2. 在導覽選單中，按一下「Backup for Clusters」。確認專案選取器中未選取任何專案。
3. 依序點選「存放區」>「建立存放區」。
4. 輸入存放區名稱。說明為選填項目。
5. 在「S3 URI endpoint」(S3 URI 端點) 欄位中，輸入包含物件儲存庫網站完整網域名稱的端點。例如：https://storagegrid.zone.DOMAIN.SUFFIX:PORT。
6. 在「Bucket name」(值區名稱) 欄位中，輸入值區的完整名稱，這個名稱可從 GDC 值區自訂資源的狀態中找到。
7. 在「Bucket region」(Bucket 區域) 欄位中，輸入 Bucket 的建立區域。
8. 在「Access Key ID」(存取金鑰 ID) 清單中，輸入值區 Secret 的存取金鑰 ID。
9. 在「Access key」(存取金鑰) 欄位中，輸入值區 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'
   

   請務必記錄指令傳回的密鑰名稱，並在建立 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：bucket 的完整名稱。
   • REGION：建立 bucket 的區域。
   • FORCE_PATH_STYLE：使用 forcePathStyle 欄位，強制物件使用路徑樣式網址。這個欄位的值必須是 true 或 false。
   • IMPORT_POLICY：設為下列其中一項：
     • ReadWrite：這個存放區可用於排定或建立備份、備份方案和還原作業。
     • ReadOnly：這個存放區只能用於匯入及查看備份。您無法在這個存放區建立新的備份或資源，但還原作業可以使用及參照唯讀備份。使用備份存放區做為 ReadOnly 的頻率沒有限制。