本頁面由 Cloud Translation API 翻譯而成。

在 Cloud Storage 中排定備份作業

警告：1.12.4 之前的 Apigee Hybrid 版本有已知問題，會影響使用 HYBRID 或 GCP Cloud Provider 的備份作業。請參閱 Cassandra 疑難排解指南，確認您的設定是否受到影響，並瞭解解決問題所需的步驟。

本頁說明如何排定 Cloud Storage 中 Cassandra 的備份作業。使用這個方法時，備份會儲存在指定的 Cloud Storage bucket 中。

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

執行下列 create-service-account 指令，建立具有標準 roles/storage.objectAdmin 角色的 Google Cloud 服務帳戶 (SA)。這個 SA 角色可讓您將備份資料寫入 Cloud Storage。在 $APIGEE_HELM_CHARTS_HOME/apigee-operator/etc/ 目錄中執行指令。

./tools/create-service-account --env non-prod --dir ./

這個指令會建立名為 apigee-non-prod 的單一服務帳戶，供非正式環境使用，並將下載的金鑰檔案放在 ./ 目錄中。

注意：如要為實際工作環境建立所有個別服務帳戶，請使用下列指令：

./tools/create-service-account --env prod --dir ./

然後將每個服務帳戶移至對應的圖表目錄。下表列出每個服務帳戶和對應的 Apigee Hybrid Helm 圖表：

服務帳戶	Apigee Helm 圖表
`apigee-cassandra`	`apigee-datastore`
`apigee-logger`	`apigee-telemetry`
`apigee-mart`	`apigee-org`
`apigee-metrics`	`apigee-telemetry`
`apigee-runtime`	`apigee-env`
`apigee-synchronizer`	`apigee-env`
`apigee-udca`	`apigee-org`
`apigee-watcher`	`apigee-org`

如要進一步瞭解 Google Cloud 服務帳戶，請參閱「建立及管理服務帳戶」。

create-service-account 指令會儲存含有服務帳戶私密金鑰的 JSON 檔案。檔案會儲存在執行指令的目錄中。您將在後續步驟中用到這個檔案的路徑。
建立 Cloud Storage bucket。為 bucket 指定合理的資料保留政策。Apigee 建議資料保留政策為 15 天。
開啟 overrides.yaml 檔案。

新增下列 cassandra.backup 屬性即可啟用備份功能。請勿移除任何已設定的屬性。

參數

cassandra:
    ...

    backup:
      enabled: true
      serviceAccountPath: SA_JSON_FILE_PATH
      dbStorageBucket: CLOUD_STORAGE_BUCKET_PATH
      schedule: BACKUP_SCHEDULE_CODE
      cloudProvider: "GCP" # required verbatim "GCP" (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"
      


    ...

屬性	說明
`backup:enabled`	備份功能預設為停用。您必須將這個屬性設為 `true`。
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` 檔案系統中服務帳戶 JSON 檔案的路徑。您執行 `create-service-account` 指令時，系統會下載這個檔案。路徑必須與 apigee-datastore 圖表目錄相對。例如 `serviceAccountPath: myproject-apigee-cassandra.json`。
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` Cloud Storage 值區路徑，格式為 `gs://BUCKET_NAME`。必須提供 `gs://`。
`backup:cloudProvider`	`GCP` 如要備份至 Cloud Storage，請將這個屬性設為 `GCP`。
`backup:schedule`	`BACKUP_SCHEDULE_CODE` 備份開始時間，以標準 crontab 語法指定。預設值：`0 2 * * ` 注意：*請避免排定備份作業，在您將備份設定套用至叢集後不久就開始備份。套用備份設定後，Kubernetes 會重新建立 Cassandra 節點。如果備份作業在節點重新啟動前開始，第一次備份會失敗，但後續備份會成功。

將設定變更套用至新叢集。例如：
```
helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
注意：如果看到錯誤訊息，請將 upgrade 替換為 install，然後再試一次。
Error: UPGRADE FAILED: "datastore" has no deployed releases
其中 OVERRIDES_FILE 是指您剛編輯的覆寫檔案路徑。

驗證備份工作。例如：

kubectl get cronjob -n APIGEE_NAMESPACE

  NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
  apigee-cassandra-backup   33 * * * *   False     0        <none>          94s

啟動手動備份

系統會根據 overrides.yaml 檔案中 cassandra.backup.schedule 設定的 Cron 排程，自動觸發備份工作。不過，您也可以視需要使用下列指令，手動啟動備份工作：

kubectl create job -n APIGEE_NAMESPACE --from=cronjob/apigee-cassandra-backup MANUAL_BACKUP_JOB_NAME

其中 MANUAL_BACKUP_JOB_NAME 是要建立的手動備份工作名稱。

在 Cloud Storage 中排定備份作業 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

參數

範例

啟動手動備份

在 Cloud Storage 中排定備份作業