使用 RPM 自動調度管理工具備份及還原資料

選取文件版本:

為保護資料,AlloyDB Omni 提供自動資料備份和復原功能,使用宣告式資訊清單。AlloyDB Omni 自動調度管理工具可與 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 資源

  1. 建立服務帳戶,以便將備份新增至 bucket。
  2. 將 bucket 的 roles/storage.objectAdmin Identity and Access Management 角色授予服務帳戶。
  3. 產生 JSON 格式的服務帳戶金鑰。
  4. 將下載的 JSON 金鑰檔案內容以 base64 編碼。執行 base64 -w 0,或確保編碼文字為單一連續行。
  5. 建立 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 資源

  1. 以 base64 編碼 S3 存取金鑰 ID。
  2. 以 base64 編碼 S3 私密存取金鑰。
  3. 建立 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 資源資訊清單,請完成下列步驟:

  1. 為 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 節點。
  2. 套用 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 資源資訊清單路徑。

建立備份方案

  1. 使用儲存空間選項的格式建立 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 * * *。

  2. 使用下列任一方法套用備份方案:

    alloydbctl

    1. 套用 BackupPlan 資源:

      alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_PLAN_MANIFEST"

      請替換下列變數:

      • DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。

      • BACKUP_PLAN_MANIFEST:先前建立的 BackupPlan 資訊清單路徑。

    2. 確認 BackupPlan 資訊清單的狀態欄位 status.phase 為 Ready。如果資訊清單尚未準備就緒,請等待:

      alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t BackupPlan -n BACKUP_PLAN_NAME -o yaml

    Ansible

    1. 為 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 節點時,會用到這個私密金鑰。

    2. 套用 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 資訊清單路徑。

    3. 如果尚未建立 status.yaml 應對手冊,請先建立。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。

    4. 確認 BackupPlan 資訊清單的狀態欄位 status.phase 為 Ready。如果資訊清單尚未準備就緒,請等待:

      ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=BackupPlan \
        -e resource_name=BACKUP_PLAN_NAME

更新備份方案

如要更新備份方案,變更備份排程、修改保留期限或暫停排定的備份,請修改 BackupPlan 資訊清單,然後重新套用。

  1. 開啟您在「建立備份方案」中建立的 BackupPlan 資訊清單。

  2. 修改要更新的欄位。

    • 如要更新備份排程,請修改 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
    
  3. 使用下列任一方法套用更新後的備份方案:

    alloydbctl

    1. 套用 BackupPlan 資源:

      alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_PLAN_MANIFEST"

      請替換下列變數:

      • DEPLOYMENT_SPEC_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。

      • BACKUP_PLAN_MANIFEST:您修改的 BackupPlan 資訊清單路徑。

    2. 確認 BackupPlan 資訊清單的狀態欄位 status.phase 為 Ready。如果資訊清單尚未準備就緒,請等待:

      alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t BackupPlan -n BACKUP_PLAN_NAME -o yaml

    Ansible

    1. 使用在「建立備份方案」中建立的應對手冊,套用更新後的 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

    2. 如果尚未建立 status.yaml 應對手冊,請先建立。如要瞭解如何建立劇本,請參閱「查看狀態及列出備份資源」。

    3. 確認 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

  1. 建立刪除 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 節點的私密金鑰。

  2. 執行 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

  1. 使用下列格式建立 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。

  2. 套用 Backup 資訊清單:

    alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "BACKUP_MANIFEST"

    請替換下列變數:

    • DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。

    • BACKUP_MANIFEST:先前建立的 Backup 資訊清單路徑。

  3. 確認 Backup 資訊清單的狀態欄位 status.phase 為 Succeeded。如果資訊清單尚未成功,請等待:

    alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t Backup -n BACKUP_NAME -o yaml
  4. 確認 bucket 中有備份檔案,方法是檢查 /backup/db 資料夾是否存在。

Ansible

  1. 使用下列格式建立 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。

  2. 為 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 節點時,會用到這個私密金鑰。

  3. 套用 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 資訊清單路徑。

  4. 如果還沒有,請建立status.yaml應對手冊。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。

  5. 確認 Backup 資訊清單的狀態欄位 status.phase 為 Succeeded。如果資訊清單尚未成功,請等待成功後再進行驗證:

    ansible-playbook status.yaml -i "DEPLOYMENT_SPEC_PATH" -e resource_type=Backup \
      -e resource_name=BACKUP_NAME
  6. 確認 /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

  1. 建立刪除 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 節點時,會用到這個私密金鑰。

  2. 執行 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

  1. 請使用下列格式建立 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。

  2. 套用 Restore 資訊清單:

    alloydbctl apply -d "DEPLOYMENT_SPEC_PATH" -r "RESTORE_MANIFEST"

    請替換下列變數:

    • DEPLOYMENT_SPEC_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。

    • RESTORE_MANIFEST:您在步驟 1 中建立的 Restore 資訊清單規格檔案路徑。

  3. 確認 Restore 資訊清單的 status.phase 轉換為 Succeeded:

    alloydbctl get -d "DEPLOYMENT_SPEC_PATH" -t Restore -n RESTORE_NAME -o yaml

Ansible

  1. 請使用下列格式建立 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。

  2. 為 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 節點時,會用到這個私密金鑰。

  3. 套用 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 資訊清單規格檔案路徑。

  4. 如果尚未建立 status.yaml 應對手冊,請先建立。如要瞭解如何建立教戰手冊,請參閱「查看狀態並列出備份資源」。

  5. 確認 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 角色。

  1. 使用下列格式建立工作手冊,例如 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 連線至節點的私密金鑰。
  2. 執行應對手冊。

    如要列出特定類型的所有資源,請使用 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。