在单个区域中恢复

您当前正在查看 Apigee Hybrid 文档的 1.8 版。 此版本已终止服务。您应该升级到更高的版本。如需了解详情，请参阅支持的版本。

Version 1.8 (unsupported)

   支持的版本：

• v1.12（最新）                        
• v1.11                         
• v1.10                                        
• 支持的版本列表

   不支持的版本：

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

本页面介绍如何在单个区域中恢复 Cassandra。

在单区域部署中，Apigee Hybrid 部署在单个数据中心或区域中。如果您的部署中有多个 Apigee 组织，则恢复过程会恢复所有组织的数据。在多组织设置中，您无法恢复特定的组织。

注意：在开始恢复单个区域之前，请考虑以下前提步骤是否适用：

• 如果要保留现有设置以用于问题排查和根本原因分析 (RCA)，您应该从 Kubernetes 集群中删除除 Apigee 控制器以外的所有 org 和 env 组件，然后保留该集群。该集群将包含现有的 Apigee 数据存储区 (Cassandra)，您可将其用于问题排查。创建新的 Kubernetes 集群，然后在新集群中恢复 Cassandra。
• 如果您的 Hybrid 安装是使用多个组织设置的，请先获取每个组织的替换文件，然后再在单个区域中继续恢复。您可以将第 3 步中所述的恢复配置添加到任何一个替换文件中。请勿将恢复配置添加到任何其他替换文件中。

从备份恢复区域

在配置中，Cassandra 备份可以位于 Cloud Storage 或远程服务器上。无论是哪种情况，请执行以下步骤进行恢复：

1. 验证 Hybrid 版本。

   apigeectl version

   确保该版本与在存储空间中创建备份文件的版本相同。
   提示：请先运行每个带有 --dry-run=true 标志的 apigeectl 命令，以检查是否存在任何 apigeectl 错误。
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_NAMEgs:// 是必需的。
   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 文件系统上指向运行 ./tools/create-service-account 时所下载的服务账号 JSON 文件的路径
   backup:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Cloud Storage 存储桶路径，格式如下：gs://BUCKET_NAME。gs:// 是必需的。
   backup:cloudProvider	GCP cloudProvider: "GCP" 属性是必需的属性。
   backup:schedule	SCHEDULE 备份的开始时间，使用标准 crontab 语法指定。默认值：0 2 * * * 注意：请避免将备份安排在将备份配置应用于集群后很短时间内开始。应用备份配置时，Kubernetes 会重新创建 Cassandra 节点。如果备份在节点重启（可能需要几分钟）之前开始，则备份将失败。

   非 Cloud Storage

   参数

     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 私钥文件（在创建 SSH 密钥对的步骤中命名为 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 私钥文件（在创建 SSH 密钥对的步骤中命名为 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。
4. 创建新的 Hybrid 运行时部署。这将创建新的 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