在 Cloud Storage 中排定備份作業

本頁面說明如何在 Cloud Storage 中為 Cassandra 排定備份作業。在這個方法中，備份會儲存在指定的 Cloud Storage 值區中。

如要排定 Cassandra 備份作業，請執行下列步驟：

  1. 執行下列 create-service-account 指令，建立具有標準 roles/storage.objectAdmin 角色的 Google Cloud 服務帳戶 (SA)。這個 SA 角色可讓您將備份資料寫入 Cloud Storage。在 hybrid-base-directory/hybrid-files 目錄中執行下列指令：
    ./tools/create-service-account --env non-prod --dir ./service-accounts
     這個指令會建立名為 apigee-non-prod 的單一服務帳戶，用於非正式環境，並將下載的金鑰檔案放在 ./service-accounts 目錄中。 如要進一步瞭解 Google Cloud 服務帳戶，請參閱「建立及管理服務帳戶」。
  2. create-service-account 指令會儲存含有服務帳戶私密金鑰的 JSON 檔案。檔案會儲存在執行指令所在的目錄中。您將在後續步驟中需要這個檔案的路徑。
  3. 建立 Cloud Storage 值區。 為值區指定合理的資料 保留政策。Apigee 建議的資料保留政策為 15 天。
  4. 開啟 overrides.yaml 檔案。
  5. 新增下列 cassandra.backup 屬性即可啟用備份功能。請勿移除任何已設定的屬性。

    參數

    cassandra:
  ...

  backup:
    enabled: true
    serviceAccountPath: SA_JSON_FILE_PATH
    dbStorageBucket: CLOUD_STORAGE_BUCKET_PATH
    schedule: BACKUP_SCHEDULE_CODE
    cloudProvider: "GCP"  # For remote server backup set this to HYBRID (all caps)

  ...

    範例

    ...

cassandra:
  storage:
    type: gcepd
    capacity: 50Gi
    gcepd:
      replicationType: regional-pd
  auth:
    default:
      password: "abc123"
    admin:
      password: "abc234"
    ddl:
      password: "abc345"
    dml:
      password: "abc456"
  nodeSelector:
    key: cloud.google.com/gke-nodepool
    value: apigee-data
  backup:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my-cassandra-backup-sa.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    schedule: "45 23 * * 6"
    cloudProvider: "GCP"
    


  ...
    6. 其中：
    屬性 說明
    backup:enabled 備份功能預設為停用。您必須將這項屬性設為 true。
    backup:serviceAccountPath

    SA_JSON_FILE_PATH

    您在執行 ./tools/create-service-account 指令時下載的服務帳戶 JSON 檔案，其在檔案系統中的路徑。

    您也可以提供相對檔案路徑。路徑會相對於 hybrid-base-directory/hybrid-files 目錄。

    backup:dbStorageBucket

    CLOUD_STORAGE_BUCKET_PATH

    Cloud Storage 值區路徑的格式為 gs://BUCKET_NAME。必須使用 gs://。
    backup:cloudProvider

    GCP/HYBRID

    如果是 Cloud Storage 備份，請將屬性設為 GCP。例如：cloudProvider: "GCP"。

    如要備份遠端伺服器，請將屬性設為 HYBRID。例如：cloudProvider: "HYBRID"。
    backup:schedule

    BACKUP_SCHEDULE_CODE

    備份作業開始的時間，以 標準 crontab 語法指定。預設值：0 2 * * *
  6. 將設定變更套用至新叢集。例如： 
    $APIGEECTL_HOME/apigeectl apply --datastore -f YOUR_OVERRIDES_FILE

    其中 YOUR_OVERRIDES_FILE 是指您剛剛編輯的覆寫檔案路徑。

  7. 驗證備份工作。例如：
    kubectl get cronjob -n apigee
     
    NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
apigee-cassandra-backup   33 * * * *   False     0        <none>          94s