alloydbctl 和 Ansible 搭配使用,套用這些資訊清單設定,並自動備份至 Cloud Storage、標準 Amazon S3 bucket 或符合 S3 規範的軟體 (例如 MinIO)。
如要啟用 AlloyDB Omni 持續備份和復原功能,請為每個資料庫叢集建立備份方案。系統會根據 BackupPlan 資源中定義的備份排程進行備份。您可以透過 Backup 資源或復原時間範圍內的任何時間戳記 (精確到秒) 進行還原。
AlloyDB Omni 會透過資訊清單管理自動備份和復原作業:
BackupPlan:每個資料庫叢集可以有一或多個BackupPlan資訊清單,在不同備份層級採用不同的設定和排程。Backup:根據BackupPlan資訊清單,啟動完整、差異或增量備份。Restore:使用特定備份或時間點,啟動資料庫叢集的就地還原作業。
事前準備
設定及設定備份方案前,請確認已備妥下列項目:
備份的儲存位置:AlloyDB Omni 會將備份儲存在下列其中一個儲存選項中:
- Cloud Storage:Cloud Storage bucket。如要瞭解如何建立 bucket,請參閱「建立 bucket」。
- Amazon S3:Amazon S3 儲存空間。如要瞭解如何建立 S3 bucket,請參閱「建立 bucket」。
- 與 S3 相容的儲存空間:與 S3 相容的軟體 (例如 MinIO) 中的 bucket。如要瞭解如何建立 MinIO 儲存空間,請參閱 MinIO 說明文件。
驗證憑證:如果儲存空間選項需要驗證金鑰 (例如 Amazon S3、MinIO 或 Cloud Storage,且使用特定服務帳戶),您必須先建立包含這些憑證的
Secret資源,才能建立備份計畫。如需操作說明,請參閱「建立 Secret 資源來驗證儲存空間」。
建立 Secret 資源來驗證儲存空間
如果您使用的儲存空間需要驗證,則必須先建立 Secret 資源,才能建立備份方案。
為 Cloud Storage 建立 Secret 資源
- 建立服務帳戶,以便將備份新增至 bucket。
- 將 bucket 的
roles/storage.objectAdminIdentity and Access Management 角色授予服務帳戶。 - 產生 JSON 格式的服務帳戶金鑰。
- 將下載的 JSON 金鑰檔案內容以 base64 編碼。執行
base64 -w 0,或確保編碼文字為單一連續行。 建立
Secret資源資訊清單。data區段中的金鑰名稱必須是key.json。Secret: metadata: name: SECRET_NAME spec: type: Opaque data: key.json: "BASE64_ENCODED_JSON_KEY"更改下列內容:
SECRET_NAME:Secret資源的名稱。BASE64_ENCODED_JSON_KEY: 服務帳戶 JSON 金鑰檔案的 Base64 編碼內容。
為 S3 或 S3 相容儲存空間建立 Secret 資源
- 以 base64 編碼 S3 存取金鑰 ID。
- 以 base64 編碼 S3 私密存取金鑰。
建立
Secret資源資訊清單。data區段中的鍵名稱必須是access-key-id和access-key。Secret: metadata: name: SECRET_NAME spec: type: Opaque data: access-key-id: "BASE64_ENCODED_ACCESS_KEY_ID" access-key: "BASE64_ENCODED_SECRET_ACCESS_KEY"更改下列內容:
SECRET_NAME:Secret資源的名稱。BASE64_ENCODED_ACCESS_KEY_ID:以 Base64 編碼的 S3 存取金鑰 ID。BASE64_ENCODED_SECRET_ACCESS_KEY:以 Base64 編碼的 S3 秘密存取金鑰。
套用 Secret 資源
請先套用 Secret 資源資訊清單,再套用 BackupPlan 資訊清單。您可以透過下列任一方法套用 Secret 資源資訊清單:
alloydbctl
如要使用 alloydbctl 套用 Secret 資源資訊清單,請執行下列指令:
alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "SECRET_MANIFEST"請替換下列變數:
DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。SECRET_MANIFEST:您建立的Secret資源資訊清單路徑。
Ansible
如要使用 Ansible 套用 Secret 資源資訊清單,請完成下列步驟:
為
Secret資源資訊清單建立應對手冊:- name: Create Secret hosts: localhost become: true vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.backup請替換下列變數:
ANSIBLE_USER:OS 使用者,Ansible 會用這個使用者登入 AlloyDB Omni 節點。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 使用的私密金鑰,用於透過 SSH 連線至 AlloyDB Omni 節點。
套用
Secret資源資訊清單:ansible-playbook SECRET_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" \ -e resource_spec="SECRET_MANIFEST"請替換下列變數:
SECRET_PLAYBOOK:為Secret資源資訊清單建立的教戰手冊路徑。DEPLOYMENT_SPEC_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。SECRET_MANIFEST:您建立的Secret資源資訊清單路徑。
建立備份方案
使用儲存空間選項的格式建立
BackupPlan資訊清單:Cloud Storage
gcsOptions欄位為必填欄位。BackupPlan: metadata: name: BACKUP_PLAN_NAME spec: dbclusterRef: DBCLUSTER_NAME backupLocation: type: GCS gcsOptions: bucket: BUCKET_NAME key: BUCKET_PATH secretRef: name: SECRET_NAME backupRetainDays: RETAIN_DAYS backupSchedules: full: "FULL_SCHEDULE" differential: "DIFF_SCHEDULE" incremental: "INC_SCHEDULE"請替換下列變數:
BACKUP_PLAN_NAME:BackupPlan資訊清單的名稱。例如:my-backup-plan-1。DBCLUSTER_NAME:您在「建立叢集」中定義的資料庫叢集名稱。BUCKET_NAME:您建立的 Cloud Storage bucket 名稱。BUCKET_PATH:Cloud Storage 中應寫入備份的目錄路徑。您必須提供以/開頭的絕對路徑。 例如:/backups。SECRET_NAME(選用):儲存驗證金鑰的Secret資源名稱。RETAIN_DAYS(選用):備份自動刪除前保留的天數。FULL_SCHEDULE(選用):完整備份的 cron 排程運算式。例如:0 2 * * *。DIFF_SCHEDULE(選用):差異備份的 cron 排程運算式。例如:0 2 * * *。INC_SCHEDULE(選用):漸進式備份的 cron 排程運算式。例如:0 2 * * *。
Amazon S3 或 S3 相容
s3Options欄位為必填欄位。BackupPlan: metadata: name: BACKUP_PLAN_NAME spec: dbclusterRef: DBCLUSTER_NAME backupLocation: type: S3 s3Options: bucket: BUCKET_NAME key: BUCKET_PATH endpoint: ENDPOINT_URL region: REGION secretRef: name: SECRET_NAME backupRetainDays: RETAIN_DAYS backupSchedules: full: "FULL_SCHEDULE" differential: "DIFF_SCHEDULE" incremental: "INC_SCHEDULE"請替換下列變數:
BACKUP_PLAN_NAME:資訊清單的名稱。BackupPlan例如:my-backup-plan-1。DBCLUSTER_NAME:您在「建立叢集」中定義的資料庫叢集名稱。BUCKET_NAME:您建立的 S3 bucket 名稱。BUCKET_PATH:S3 bucket 中應寫入備份的目錄路徑。您必須提供以/開頭的絕對路徑。例如:/backups。ENDPOINT_URL:用於連線至與 S3 相容軟體 (例如 MinIO) 的自訂端點網址。例如,http://minio.example.com:9000。如果是 Amazon S3 bucket,則不必提供任何端點網址。REGION_(選用):儲存空間 bucket 的區域。連線至標準 Amazon S3 儲存貯體或 S3 相容軟體時,必須提供此資訊,系統會強制執行區域驗證。SECRET_NAME:參照您先前建立的Secret資源,其中包含ACCESS_KEY_ID和SECRET_ACCESS_KEY。RETAIN_DAYS(選用):備份自動刪除前保留的天數。FULL_SCHEDULE(選用):完整備份的 cron 排程運算式。例如:0 2 * * *。DIFF_SCHEDULE(選用):差異備份的 cron 排程運算式。例如:0 2 * * *。INC_SCHEDULE(選用):漸進式備份的 cron 排程運算式。例如:0 2 * * *。
使用下列任一方法套用備份方案:
alloydbctl套用
BackupPlan資源:alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_PLAN_MANIFEST"請替換下列變數:
DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_MANIFEST:先前建立的BackupPlan資訊清單路徑。
確認
BackupPlan資訊清單的狀態欄位status.phase為Ready。如果資訊清單尚未準備就緒,請等待:alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t BackupPlan -n BACKUP_PLAN_NAME -o yaml
Ansible
為
BackupPlan資訊清單建立應對手冊:- name: BACKUP_PLAN_PLAYBOOK_NAME hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.backup請替換下列變數:
BACKUP_PLAN_PLAYBOOK_NAME:Ansible 腳本的名稱。例如:My BackupPlan。請記下教戰手冊的路徑,因為下一個步驟會用到。ANSIBLE_USER:Ansible 用於登入 AlloyDB Omni 節點的 OS 使用者名稱。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 使用 SSH 連線至 AlloyDB Omni 節點時,會用到這個私密金鑰。
套用
BackupPlan資源:ansible-playbook BACKUP_PLAN_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" \ -e resource_spec="BACKUP_PLAN_MANIFEST"請替換下列變數:
BACKUP_PLAN_PLAYBOOK:先前為BackupPlan資訊清單建立的應對手冊路徑。DEPLOYMENT_SPEC_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_MANIFEST:先前建立的BackupPlan資訊清單路徑。
如果尚未建立
status.yaml應對手冊,請先建立。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。確認
BackupPlan資訊清單的狀態欄位status.phase為Ready。如果資訊清單尚未準備就緒,請等待:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=BackupPlan \ -e resource_name=BACKUP_PLAN_NAME
更新備份方案
如要更新備份方案,變更備份排程、修改保留期限或暫停排定的備份,請修改 BackupPlan 資訊清單,然後重新套用。
開啟您在「建立備份方案」中建立的
BackupPlan資訊清單。修改要更新的欄位。
- 如要更新備份排程,請修改
backupSchedules下方的 cron 運算式。 - 如要更新保留期限,請修改
backupRetainDays。 - 如要暫停排定的備份作業,請在
spec區段中新增paused欄位,並將其設為true。如要繼續備份,請將欄位設為false或移除欄位。
舉例來說,下列範例會將保留天數更新為
30、修改full和differential排程、新增incremental排程,以及暫停備份方案:BackupPlan: metadata: name: BACKUP_PLAN_NAME spec: dbclusterRef: DBCLUSTER_NAME backupLocation: type: GCS gcsOptions: bucket: BUCKET_NAME key: BUCKET_PATH secretRef: name: SECRET_NAME backupRetainDays: 30 backupSchedules: full: "0 4 * * *" differential: "0 0 * * 0" incremental: "0 12 * * *" paused: true- 如要更新備份排程,請修改
使用下列任一方法套用更新後的備份方案:
alloydbctl套用
BackupPlan資源:alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_PLAN_MANIFEST"請替換下列變數:
DEPLOYMENT_SPEC_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_MANIFEST:您修改的BackupPlan資訊清單路徑。
確認
BackupPlan資訊清單的狀態欄位status.phase為Ready。如果資訊清單尚未準備就緒,請等待:alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t BackupPlan -n BACKUP_PLAN_NAME -o yaml
Ansible
使用在「建立備份方案」中建立的應對手冊,套用更新後的
BackupPlan資源:ansible-playbook BACKUP_PLAN_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" \ -e resource_spec="BACKUP_PLAN_MANIFEST"請替換下列變數:
BACKUP_PLAN_PLAYBOOK:為BackupPlan資訊清單建立的應對手冊路徑。DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_MANIFEST:您修改的資訊清單路徑。BackupPlan
如果尚未建立
status.yaml應對手冊,請先建立。如要瞭解如何建立劇本,請參閱「查看狀態及列出備份資源」。確認
BackupPlan資訊清單的狀態欄位status.phase為Ready。如果資訊清單尚未準備就緒,請等待準備就緒後再進行驗證:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=BackupPlan \ -e resource_name=BACKUP_PLAN_NAME
刪除備份方案
如要刪除備份方案,請使用下列任一方法:
alloydbctl
alloydbctl delete -d "DEPLOYMENT_SPEC_PATH" -t BackupPlan -n BACKUP_PLAN_NAME請替換下列變數:
DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_NAME:要刪除的BackupPlan資訊清單名稱。
Ansible
建立刪除
BackupPlan資訊清單的應對手冊。- name: BACKUP_PLAN_DELETE_PLAYBOOK_NAME hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.delete請替換下列變數:
BACKUP_PLAN_DELETE_PLAYBOOK_NAME: Ansible 劇本的名稱。ANSIBLE_USER: Ansible 用於登入 AlloyDB Omni 節點的 OS 使用者。ANSIBLE_SSH_PRIVATE_KEY_FILE: Ansible 用於透過 SSH 連線至 AlloyDB Omni 節點的私密金鑰。
執行
ansible-playbook刪除BackupPlan資訊清單。ansible-playbook BACKUP_PLAN_DELETE_PLAYBOOK_NAME -i "DEPLOYMENT_SPEC_PATH" -e resource_type=BackupPlan \ -e resource_name=BACKUP_PLAN_NAME請替換下列變數:
BACKUP_PLAN_DELETE_PLAYBOOK_NAME:您在上一個步驟中建立的應對手冊路徑,用於刪除BackupPlan資訊清單。DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_PLAN_NAME:要刪除的BackupPlan資訊清單名稱。
建立備份
如要建立及啟動備份作業,請使用下列任一方法:
alloydbctl
使用下列格式建立
Backup資訊清單:Backup: metadata: name: BACKUP_NAME spec: backupPlanRef: BACKUP_PLAN_NAME dbclusterRef: DBCLUSTER_NAME type: full請替換下列變數:
BACKUP_NAME:Backup資訊清單的名稱。例如:my-backup-1。BACKUP_PLAN_NAME:先前建立的BackupPlan資訊清單名稱。例如:my-backup-plan-1。DBCLUSTER_NAME:您在「建立叢集」中定義的資料庫叢集名稱。type(選用):備份執行類型,可設為full、diff或incr。預設為full。
套用
Backup資訊清單:alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_MANIFEST"請替換下列變數:
DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_MANIFEST:先前建立的Backup資訊清單路徑。
確認
Backup資訊清單的狀態欄位status.phase為Succeeded。如果資訊清單尚未成功,請等待:alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t Backup -n BACKUP_NAME -o yaml確認 bucket 中有備份檔案,方法是檢查
/backup/db資料夾是否存在。
Ansible
使用下列格式建立
Backup資訊清單:Backup: metadata: name: BACKUP_NAME spec: backupPlanRef: BACKUP_PLAN_NAME dbclusterRef: DBCLUSTER_NAME type: full請替換下列變數:
BACKUP_NAME:Backup資訊清單的名稱。例如:my-backup-1。BACKUP_PLAN_NAME:您稍早建立的BackupPlan資訊清單名稱。例如:my-backup-plan-1。DBCLUSTER_NAME:您在「建立叢集」中定義的資料庫叢集名稱。type(選用):備份執行類型,可設為full、diff或incr。預設為full。
為
Backup資訊清單建立應對手冊:- name: BACKUP_PLAYBOOK_NAME hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.backup請替換下列變數:
BACKUP_PLAYBOOK_NAME:Ansible 教戰手冊的名稱。例如:My Backup。ANSIBLE_USER:Ansible 用來登入 AlloyDB Omni 節點的 OS 使用者名稱。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 使用 SSH 連線至 AlloyDB Omni 節點時,會用到這個私密金鑰。
套用
Backup資訊清單:ansible-playbook BACKUP_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" \ -e resource_spec="BACKUP_MANIFEST"請替換下列變數:
BACKUP_PLAYBOOK:您為先前建立的Backup資訊清單建立的劇本路徑。DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_MANIFEST:先前建立的Backup資訊清單路徑。
如果還沒有,請建立
status.yaml應對手冊。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。確認
Backup資訊清單的狀態欄位status.phase為Succeeded。如果資訊清單尚未成功,請等待成功後再進行驗證:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=Backup \ -e resource_name=BACKUP_NAME確認
/backup/db資料夾是否存在,藉此確認 bucket 中是否有備份檔案。
刪除備份
如要刪除備份,請執行下列任一指令:
alloydbctl
alloydbctl delete -d "DEPLOYMENT_SPEC_PATH" -t Backup -n BACKUP_NAME請替換下列變數:
DEPLOYMENT_SPEC_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_NAME:要刪除的Backup資訊清單名稱。
Ansible
建立刪除
Backup資訊清單的應對手冊。- name: BACKUP_DELETE_PLAYBOOK_NAME hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.delete請替換下列變數:
BACKUP_DELETE_PLAYBOOK_NAME: Ansible 劇本的名稱。ANSIBLE_USER: Ansible 用於登入 AlloyDB Omni 節點的 OS 使用者。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 使用 SSH 連線至 AlloyDB Omni 節點時,會用到這個私密金鑰。
執行
ansible-playbook刪除Backup資訊清單。ansible-playbook BACKUP_DELETE_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" -e resource_type=Backup \ -e resource_name=BACKUP_NAME請替換下列變數:
BACKUP_DELETE_PLAYBOOK:您在上一個步驟中建立的 Playbook 路徑,用於刪除Backup資訊清單。DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。BACKUP_NAME:要刪除的Backup資訊清單名稱。
從備份或時間點復原 (PITR)
如要從備份還原資料,請套用 Restore資訊清單。RPM 協調器會執行就地復原,直接修改目標資料庫叢集,不需啟動複製的叢集或手動執行指令碼。
如要從備份還原,請使用下列任一方法:
alloydbctl
請使用下列格式建立
Restore資訊清單:- 如要從特定命名備份執行作業還原:
Restore: metadata: name: RESTORE_NAME spec: sourceDBCluster: DBCLUSTER_NAME backup: BACKUP_NAME如要執行時間點還原 (PITR),請按照下列步驟操作:
Restore: metadata: name: RESTORE_NAME spec: sourceDBCluster: DBCLUSTER_NAME pointInTime: "TIMESTAMP"
請替換下列變數:
RESTORE_NAME:這個Restore資訊清單的名稱。例如:my-restore-1。DBCLUSTER_NAME:要就地復原的目標資料庫叢集名稱。BACKUP_NAME:要還原的已完成Backup資訊清單名稱。TIMESTAMP:RFC 3339 時間戳記,用於識別要復原到的確切時間點。例如:2026-06-19T14:30:00Z。
套用
Restore資訊清單:alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "RESTORE_MANIFEST"請替換下列變數:
DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。RESTORE_MANIFEST:您在步驟 1 中建立的Restore資訊清單規格檔案路徑。
確認
Restore資訊清單的status.phase轉換為Succeeded:alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t Restore -n RESTORE_NAME -o yaml
Ansible
請使用下列格式建立
Restore資訊清單:- 如要從特定命名備份執行作業還原:
Restore: metadata: name: RESTORE_NAME spec: sourceDBCluster: DBCLUSTER_NAME backup: BACKUP_NAME如要執行時間點還原 (PITR),請按照下列步驟操作:
Restore: metadata: name: RESTORE_NAME spec: sourceDBCluster: DBCLUSTER_NAME pointInTime: "TIMESTAMP"
請替換下列變數:
RESTORE_NAME:這個Restore資訊清單的名稱。例如:my-restore-1。DBCLUSTER_NAME:要就地復原的目標資料庫叢集名稱。BACKUP_NAME:要還原的已完成Backup資訊清單名稱。TIMESTAMP:RFC 3339 時間戳記,用於識別要還原的確切時間點。例如:2026-06-19T14:30:00Z。
為
Restore資訊清單建立應對手冊:- name: RESTORE_PLAYBOOK_NAME hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.restore請替換下列變數:
RESTORE_PLAYBOOK_NAME:Ansible 劇本的名稱。ANSIBLE_USER: Ansible 用於登入 AlloyDB Omni 節點的 OS 使用者。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 使用 SSH 連線至 AlloyDB Omni 節點時,會用到這個私密金鑰。
套用
Restore資訊清單:ansible-playbook RESTORE_PLAYBOOK -i "DEPLOYMENT_SPEC_PATH" \ -e resource_spec="RESTORE_MANIFEST"請替換下列變數:
RESTORE_PLAYBOOK:在步驟 2 為Restore資訊清單建立的教戰手冊路徑。DEPLOYMENT_SPEC_PATH:Deployment 規格的路徑。RESTORE_MANIFEST:您在步驟 1 建立的Restore資訊清單規格檔案路徑。
如果尚未建立
status.yaml應對手冊,請先建立。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。確認
Restore資訊清單的status.phase轉換為Succeeded:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=Restore \ -e resource_name=RESTORE_NAME
查看狀態並列出備份資源
如要查看 BackupPlan、Backup 和 Restore 資源的狀態或列出這些資源,請使用下列任一方法:
alloydbctl
如要列出特定類型的所有資源,請執行 alloydbctl get 指令:
alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t RESOURCE_TYPE如要查看特定資源的狀態,請執行 alloydbctl get 指令,並將資源名稱和輸出格式設為 yaml:
alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t RESOURCE_TYPE -n RESOURCE_NAME -o yaml請替換下列變數:
DEPLOYMENT_SPEC_PATH:Deployment 規格的路徑。RESOURCE_TYPE:資源類型。請將這個值設為BackupPlan、Backup或Restore。RESOURCE_NAME:要查看狀態的資源名稱。
Ansible
如要使用 Ansible 查看資源狀態或列出資源,請使用 google.alloydbomni_orchestrator.status 角色。
使用下列格式建立工作手冊,例如
status.yaml:- name: Get resource status hosts: localhost vars: ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.status請替換下列變數:
ANSIBLE_USER:Ansible 用來登入節點的 OS 使用者。ANSIBLE_SSH_PRIVATE_KEY_FILE:Ansible 用來透過 SSH 連線至節點的私密金鑰。
執行應對手冊。
如要列出特定類型的所有資源,請使用
resource_type變數執行教戰手冊:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=RESOURCE_TYPE如要查看特定資源的狀態,請使用
resource_type和resource_name變數執行應對手冊:ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=RESOURCE_TYPE \ -e resource_name=RESOURCE_NAME請替換下列變數:
DEPLOYMENT_SPEC_PATH:Deployment 規格的路徑。RESOURCE_TYPE:資源類型。請將這個值設為BackupPlan、Backup或Restore。RESOURCE_NAME:要查看狀態的資源名稱。
限制
- 如果
BackupPlan狀態顯示ConfigurationFailed,並附上failed to create stanza(結束代碼39),您可以授予 Bucket 上的roles/storage.objectAdmin角色,然後重新套用資訊清單,繼續進行對帳。不必刪除BackupPlan。