在單一區域中還原

本頁說明如何在單一區域還原 Cassandra。

在單一地區部署中，Apigee Hybrid 會部署在單一資料中心或地區。如果部署作業有多個 Apigee 機構，還原程序會還原所有機構的資料。在多機構設定中，您無法還原特定機構。

從備份還原區域

在設定中，Cassandra 備份可以位於 Cloud Storage 或遠端伺服器。無論是哪種情況，請按照下列步驟還原：

  1. 確認混合式版本。 
    apigeectl version
     確認版本與在儲存空間中建立備份檔案的版本相同。
  2. 確認要還原的 Kubernetes 叢集先前未安裝 Apigee Hybrid。如果還原至現有叢集，請使用下列指令刪除現有的 Apigee Hybrid 安裝項目：
    apigeectl delete -f overrides.yaml
kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc # The output should be empty.
apigeectl delete --all -f overrides.yaml
  3. 開啟 overrides.yaml 檔案，並將 restore 屬性設為所需值：

    Cloud Storage

    參數

    namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    schedule: "SCHEDULE"

    範例

    namespace: apigee
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    snapshotTimestamp: "20201001183903"

  ...
  backup:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    schedule: "0 2 * * *"
  ...

    其中：

    屬性 說明
    namespace

    YOUR_RESTORE_NAMESPACE

    要還原的命名空間。使用與原始叢集相同的命名空間。
    cassandra:hostNetwork

    hostNetwork 為必要欄位，且一律應設為 false。
    restore:enabled 還原功能預設為停用。您必須將這個屬性設為 true。
    restore:serviceAccountPath

    SA_JSON_FILE_PATH

    您為備份作業建立的服務帳戶在檔案系統中的路徑。
    restore:dbStorageBucket

    CLOUD_STORAGE_BUCKET_PATH

    備份資料儲存位置的 Cloud Storage 值區路徑，格式如下： gs://BUCKET_NAME。 必須提供 gs://。
    restore:cloudProvider

    GCP

    cloudProvider: "GCP" 屬性為必填欄位。
    restore:snapshotTimestamp

    TIMESTAMP

    要還原的備份快照時間戳記。如要查看可使用的時間戳記，請前往 dbStorageBucket，並查看值區中的檔案。每個檔案名稱都包含時間戳記值。例如： backup_20210203213003_apigee-cassandra-default-0.tgz

    其中 20210203213003 是 snapshotTimestamp 值，如果您想還原當時建立的備份，就會使用這個值。
    backup:enabled 備份功能預設為停用。您必須將這個屬性設為 true。
    backup:serviceAccountPath

    SA_JSON_FILE_PATH

    檔案系統中服務帳戶 JSON 檔案的路徑，該檔案是在您執行 ./tools/create-service-account 時下載。
    backup:dbStorageBucket

    CLOUD_STORAGE_BUCKET_PATH

    Cloud Storage 值區路徑，格式如下： gs://BUCKET_NAME。 必須提供 gs://。
    backup:cloudProvider

    GCP

    cloudProvider: "GCP" 屬性為必填欄位。
    backup:schedule

    SCHEDULE

    備份開始時間，以標準 crontab 語法指定。預設值：0 2 * * *

    非雲端儲存空間

    參數

      namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
  cassandra:
    hostNetwork: false
    ...
    restore:
      enabled: true
      keyFile: "PATH_TO_PRIVATE_KEY_FILE"
      server: "BACKUP_SERVER_IP"
      storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
      cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
      snapshotTimestamp: "TIMESTAMP"
    ...
    backup:
      enabled: true
      keyFile: "PATH_TO_PRIVATE_KEY_FILE"
      server: "BACKUP_SERVER_IP"
      storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
      cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
      schedule: "SCHEDULE"

    範例

      namespace: apigee
  cassandra:
    hostNetwork: false
    ...
    restore:
      enabled: true
      keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
      server: "34.56.78.90"
      storageDirectory: "/home/apigee/cassbackup"
      cloudProvider: "HYBRID"
      snapshotTimestamp: "20201001183903"
    ...
    backup:
      enabled: true
      keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
      server: "34.56.78.90"
      storageDirectory: "/home/apigee/cassbackup"
      cloudProvider: "HYBRID"
      schedule: "0 2 * * *"
    ...

    其中：

    屬性 說明
    namespace

    YOUR_RESTORE_NAMESPACE

    要還原的命名空間。使用與原始叢集相同的命名空間。
    cassandra:hostNetwork

    hostNetwork 為必要欄位，且一律應設為 false。
    restore:enabled 還原功能預設為停用。您必須將這個屬性設為 true。
    restore:keyFile

    PATH_TO_PRIVATE_KEY_FILE

    本機檔案系統上安全殼層私密金鑰檔案的路徑 (在建立安全殼層金鑰組的步驟中，該檔案名為 ssh_key)。
    restore:server

    BACKUP_SERVER_IP

    備份伺服器的 IP 位址。
    restore:storageDirectory

    BACKUP_DIRECTORY

    備份伺服器上的備份目錄名稱。 這必須是 home/apigee 內的目錄 (備份目錄在建立備份目錄的步驟中命名為 cassandra_backup)。
    restore:cloudProvider

    HYBRID

    cloudProvider: "HYBRID" 屬性為必填欄位。
    restore:snapshotTimestamp

    TIMESTAMP

    要還原的備份快照時間戳記。如要查看可使用的時間戳記，請前往 dbStorageBucket，並查看值區中的檔案。每個檔案名稱都包含時間戳記值。例如： backup_20210203213003_apigee-cassandra-default-0.tgz

    其中 20210203213003 是 snapshotTimestamp 值，如果您想還原在該時間點建立的備份，就會使用這個值。
    backup:enabled 備份功能預設為停用。您必須將這個屬性設為 true。
    backup:keyFile

    PATH_TO_PRIVATE_KEY_FILE

    本機檔案系統中安全殼層私密金鑰檔案的路徑 (在建立安全殼層金鑰組的步驟中，該檔案名為 ssh_key)。
    backup:server

    BACKUP_SERVER_IP

    備份伺服器的 IP 位址。
    backup:storageDirectory

    BACKUP_DIRECTORY

    備份伺服器上的備份目錄名稱。這必須是 home/apigee 內的目錄 (備份目錄在建立備份目錄的步驟中命名為 cassandra_backup)。
    backup:cloudProvider

    HYBRID

    cloudProvider: "HYBRID" 屬性為必填欄位。
    backup:schedule

    SCHEDULE

    備份開始時間，以標準 crontab 語法指定。預設值：0 2 * * *
  4. 建立新的混合式執行階段部署作業。這會建立新的 Cassandra 叢集，並開始將備份資料還原到叢集： 
    ${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml
     
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
     
    ${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore
     
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
  5. 確認還原作業進度，並確認 apigeeds 和所有其他 Pod 都已啟動：
    • 如要查看 apigeeds： 
      kubectl get apigeeds -n apigee
    • 如要檢查所有其他 Pod，請執行下列指令： 
      kubectl get pods -n apigee

成功完成還原作業並確認執行階段元件運作正常後，建議您在叢集上設定備份：

  1. 從 overrides-restore.yaml 檔案中移除 restore 設定。
  2. 將 backup 設定新增至 overrides-restore.yaml 檔案。
  3. 使用下列指令套用 backup 設定： 
    ./apigeectl apply -f ../overrides-restore.yaml