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

還原單一區域部署

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

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

從備份還原區域

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

確認混合式版本。
```
apigeectl version
```
請確認版本與儲存空間中建立備份檔案的版本相同。
提示：請先使用 --dry-run=true 標記執行每個 apigeectl 指令，以檢查是否有任何 apigeectl 錯誤。
請確認您要還原至的 Kubernetes 叢集沒有先前的 Apigee 混合式安裝作業。如果您要還原至現有叢集，請使用下列指令刪除現有的 Apigee 混合式安裝：
```
apigeectl delete --all -f overrides.yaml
```

開啟 overrides.yaml 檔案，並將 restore 屬性設為所需值：

參數

namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  ...
  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:
...
  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` 還原作業的命名空間。使用原始叢集中的命名空間。
`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 * * ` 注意：*請勿在將備份設定套用至叢集後不久，就排定備份作業。套用備份設定後，Kubernetes 會重新建立 Cassandra 節點。如果備份作業在節點重新啟動前開始 (可能需要幾分鐘)，備份作業就會失敗。

注意：Apigee 會根據 overrides.yaml 檔案中的 backup 設定，從 Cloud Storage 備份或遠端伺服器備份還原 Cassandra。

建立新的混合式執行階段部署作業。這會建立新的 Cassandra 叢集，並開始將備份資料還原至叢集：
```
${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
注意： --restore 標記是在 hybrid 1.6.6 版中推出。如果您使用的是舊版，請執行下列指令，但不要加上 --restore 標記。
```
${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
確認復原工作進度，並確認 apigeeds 和所有其他 Pod 皆已啟用：
- 如要檢查 apigeeds：
```
kubectl get apigeeds -n apigee
```
- 如要檢查所有其他 Pod，請按照下列步驟操作：
```
kubectl get pods -n apigee
```

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

從 overrides-restore.yaml 檔案中移除 restore 設定。
將 backup 設定新增至 overrides-restore.yaml 檔案。

使用下列指令套用 backup 設定：

./apigeectl apply -f ../overrides-restore.yaml