規劃一組還原作業

本文說明如何在 Google Distributed Cloud (GDC) 實體隔離環境中，建立、編輯及刪除還原方案。

還原方案是預先設定的還原情境，適用於對應的一系列備份。還原方案可指派權限，讓具備備份建立者角色的使用者使用這些設定。

發生事件時，備份建立者可以快速獨立還原備份。舉例來說，已部署應用程式中的軟體更新可能會損毀永久資料，導致應用程式命名空間處於無效狀態，需要還原。

還原期間，您可以選擇套用一組替換規則，用於比對一組資源，並將這些資源的屬性目前值替換為新值。舉例來說，替代規則可以在還原期間變更備份資源的命名空間，將工作負載從一個命名空間遷移至另一個命名空間。

事前準備

要求 IAM 角色

如要建立還原方案，請要求 IAM 機構組織管理員授予使用者叢集備份管理員 (user-cluster-backup-admin) 角色。這個角色可建立、取得、列出、監控、更新、修補及刪除使用者叢集中的備份資源，例如備份方案和還原方案。

如果您是應用程式操作員，請要求具備使用者叢集備份管理員權限的管理員，為您建立還原方案。

建立還原方案

使用 GDC 控制台或 API 建立還原方案。

apiVersion: backup.gdc.goog/v1
kind: ClusterRestorePlan
metadata:
  name: RESTORE_PLAN_NAME
  namespace:  PROJECT_NAME
spec:
  targetCluster:
    targetClusterType: UserCluster
    targetClusterName:
      kind: "Cluster"
      name: CLUSTER_NAME
  description: RESTORE_PLAN_DESCRIPTION
  clusterBackupPlanName: CLUSTER_BACKUP_PLAN_NAME
  clusterRestoreConfig:
    volumeDataRestorePolicy: RestoreVolumeDataFromBackup
    clusterResourceConflictPolicy: UseBackupVersion
    namespacedResourceRestoreMode: DeleteAndRestore
    namespacedResourceRestoreScope:
      selectedNamespaces:
        namespaces: [NAME_SPACE]
    clusterBackupRepositoryRef: CLUSTER_BACKUP_REPOSITORY
    substitutionRules:
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE

建立 ClusterRestorePlan 後，具備備份建立者角色的使用者可以手動還原備份。

查看還原方案

使用 GDC 控制台查看還原方案：

1. 登入 GDC 控制台。
2. 在導覽選單中，按一下「Backup for Clusters」。
3. 按一下「Select project」(選取專案)，根據您的角色選取組織或專案：
   1. 使用者叢集備份管理員：選取組織即可查看組織中的所有還原方案，選取專案則可查看專案中的所有還原方案。
   2. 備份建立者：選取專案，即可查看專案中的所有還原方案。
4. 按一下「還原方案」分頁標籤。
5. 在清單中點選還原方案，即可查看詳細資料。

編輯還原方案

如果與要編輯的還原方案相關聯的備份存放區，在建立還原方案時，Linked Cluster(read-only) 欄位有值，則會建立兩次。還原方案會傳播至讀寫和唯讀叢集。

如果備份存放區同時設有讀寫和唯讀叢集，您在編輯該存放區擁有的還原方案時，必須將 TARGET CLUSTER 設為讀寫叢集。

使用 GDC 控制台編輯還原方案：

1. 登入 GDC 控制台。
2. 在導覽選單中，按一下「Backup for Clusters」。
3. 按一下「Select project」(選取專案)，根據您的角色選取組織或專案：
   1. 使用者叢集備份管理員：選取組織即可查看組織中的所有還原方案，選取專案則可查看專案中的所有還原方案。
   2. 備份建立者：選取專案，即可查看專案中的所有還原方案。
4. 按一下「還原方案」分頁標籤。
5. 按一下要編輯的還原方案名稱。
6. 按一下「Plan Configuration」分頁標籤，查看可修改的欄位。

7. 按一下「命名空間資源」旁的「編輯」圖示 edit，即可編輯該資源：

   1. 在「Choose namespaced resources」(選擇命名空間資源) 專區，選取要還原備份中的哪些命名空間資源：

      1. 選取「Selected namespaced resources」(所選命名空間資源)，從備份中的所選命名空間還原資源：

         1. 選取「Edit Cluster Namespaces」(編輯叢集命名空間)，選取叢集命名空間。
         2. 在「叢集命名空間 1」欄位中，輸入命名空間的名稱。
         3. 按一下 [Save] 按鈕。

      2. 選取「Selected protected applications」(所選受保護的應用程式)，從備份中選取的受保護應用程式還原資源：

         1. 選取「編輯受保護的應用程式」，選取命名空間和受保護的應用程式。
         2. 在「Namespace 1」(命名空間 1) 欄位中，輸入命名空間的名稱。
         3. 在「Protected application 1」欄位中，輸入受保護應用程式的名稱。
         4. 按一下 [Save] 按鈕。

8. 按一下「Cluster-scoped resources」(叢集範圍資源) 旁的「Edit」(編輯) 圖示 edit，即可編輯該資源：

   1. 選用：在「Choose cluster-scoped resources」(選取叢集範圍內的資源) 區段中，指定 API 群組和 GroupKinds，選取要還原的叢集範圍內資源，並決定如何解決衝突：

      1. 選取「Don't restore cluster-scoped resources」(不還原叢集範圍內的資源)，即可從還原程序中移除叢集範圍內的資源。

      2. 選取「Restore cluster-scoped resources by GroupKind」(依 GroupKind 還原叢集範圍內的資源)，依指定的 GroupKind 還原資源：

      3. 如要指定 GroupKind，請按一下「Edit GroupKind」(編輯 GroupKind) 按鈕。

      4. 按一下「Add GroupKind」按鈕。

      5. 輸入GroupKind名稱。

      6. 按一下 [Save] 按鈕。

   2. 在「Conflict handling」(衝突處理) 部分，決定目標叢集內已有相同資源時要採取的行動：

      1. 選取「保留現有資源」，即可在叢集內建立尚不存在的資源。
      2. 選取「覆寫現有資源」，即可刪除找到的任何現有資源，並以還原的資源取代。

   3. 點選「儲存」按鈕確認變更。

9. 在「Substitution rules」(替代規則) 區段中，按一下「Add New Rule」(新增規則) 按鈕，新增替代規則：

   1. 在「Cluster namespaces」(叢集命名空間) 欄位中，輸入要套用這項替代規則的叢集命名空間名稱。
   2. 點選「Add GroupKind」按鈕，將這項規則套用至特定 GroupKind 物件。
   3. 在「JSON path」(JSON 路徑) 欄位中，以 JSON 格式輸入要替換的資源屬性路徑。
   4. 在「原始值模式」欄位中，輸入與屬性原始值相符的規則運算式。
   5. 在「新值」欄位中，輸入要替換目標欄位的值。如果這個欄位留空，系統會從資源中移除目標欄位。
   6. 按一下「Save」(儲存) 按鈕，完成建立新的替代規則。

10. 在「Substitution rules」(替代規則) 部分，按一下「編輯」圖示 edit，即可編輯現有替代規則。

11. 在「Substitution rules」(替代規則) 專區中，按一下「Delete」(刪除) 圖示 delete，即可刪除現有的替代規則。

刪除還原方案

您可以透過 GDC 控制台刪除 RestorePlans，或直接從 Kubernetes API 伺服器刪除資源。這會從物件儲存庫中清除任何相關聯的 RestorePlan 構件。

kubectl delete clusterRestoreplan RESTORE_PLAN_NAME -n NAMESPACE

後續步驟

• 手動還原總覽
• 查看及刪除還原作業