新增備份存放區

控制台

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) 清單中，輸入值區私密金鑰中的存取金鑰 ID。
9. 在「Access key」(存取金鑰) 欄位中，輸入值區密鑰中的存取金鑰。
10. 點選「建立」。

API

如要使用備份及還原 API，必須設定有效的ClusterBackupRepository自訂資源，並提供必要憑證。 您也必須使用服務身分 (通常稱為服務帳戶)，才能透過 API 建立存放區。

1. 取得包含 S3 憑證的密鑰名稱：

   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 和端點等 bucket 詳細資料，請從輸出內容中擷取 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 指令傳回的密鑰名稱。
   • ENDPOINT：儲存系統的完整網域名稱，例如 https://objectstorage.google.gdch.test。type 欄位僅支援 S3 值。
   • BUCKET_FQDN：bucket 的完整名稱。
   • REGION：建立 bucket 的區域。
   • FORCE_PATH_STYLE：使用 forcePathStyle 欄位，強制為物件使用路徑樣式的網址。這個欄位的值必須為 true 或 false。
   • IMPORT_POLICY：設為下列其中一項：
     • ReadWrite：這個存放區可用於排定或建立備份、備份方案和還原作業。
     • ReadOnly：這個存放區只能用於匯入及查看備份資料。您無法在這個存放區中建立新的備份或資源，但還原作業可以參考唯讀備份。備份存放區的使用次數沒有限制。ReadOnly