在多个区域中恢复

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

在多区域部署中，Apigee Hybrid 部署在不同数据中心之间的多个地理位置中。如果一个或多个区域发生故障，但运行状况良好的区域仍然存在，则您可以使用运行状况良好的区域和最新数据恢复发生故障的 Cassandra 区域。

如果所有混合区域发生灾难性故障，您可以恢复 Cassandra。请务必注意，如果您的部署中有多个 Apigee 组织，则恢复过程将恢复所有组织的数据。在多组织设置中，不支持仅恢复特定组织。

本主题介绍了缓解故障区域的两种方法：

恢复故障区域 - 介绍基于健康状况良好的区域恢复故障区域的步骤。
恢复故障区域 - 介绍从备份恢复故障区域的步骤。仅当所有 Hybrid 区域都受到影响时，才需要使用此方法。

恢复故障区域

如需从健康状况良好的区域恢复故障区域，请执行以下步骤：

将 API 流量从受影响的区域重定向到正常工作的区域。相应地规划容量，以支持从故障区域转移的流量。
停用受影响的区域。对于每个受影响的区域，请按照停用 Hybrid 区域中所述的步骤执行操作。等待停用完成，然后再继续执行下一步操作。
恢复受影响的区域。如需恢复，请创建一个新区域，如 GKE、GKE On-Prem 和 AKS 上的多区域部署中所述。

使用备份进行恢复

注意：如果要保留现有设置以用于问题排查和根本原因分析 (RCA)，您应从 Kubernetes 集群中删除除 Apigee 控制器以外的所有 org 和 env 组件，然后保留该集群。该集群将具有现有的 Apigee 数据存储区 (Cassandra)，您可将其用于问题排查。创建新的 Kubernetes 集群，然后在新集群中恢复 Cassandra。

Cassandra 备份可以位于 Cloud Storage 或远程服务器上，具体取决于您的配置。如需从备份恢复 Cassandra，请执行以下步骤：

重要提示：如果您将 Apigee Hybrid 安装到多个区域，则必须检查要恢复的区域的替换文件，以确保将 cassandra:hostNetwork 设置为在执行恢复之前为 false。如需检查您尝试恢复的区域中的 hostNetwork 设置，请使用以下命令：

kubectl -n APIGEE_NAMESPACE get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'

打开要恢复的区域的替换文件。
将 cassandra:hostNetwork 设置为 false。

应用替换文件：

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

在继续操作之前，请检查以确保 hostNetwork 设置为 false：

kubectl -n APIGEE_NAMESPACE get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'

从您要恢复的区域中删除 Hybrid：
```
helm delete DATASTORE_RELEASE_NAME \
  --namespace APIGEE_NAMESPACE
```
其中，DATASTORE_RELEASE_NAME 是您在区域中安装 Cassandra 的数据存储区的版本名称，例如 datastore-region1。

注意：请注意删除的数据存储区组件的版本。您可以使用 helm -n APIGEE_NAMESPACE ls 命令来查看版本。
使用备份恢复所需区域。如需了解详情，请参阅从备份恢复区域。
移除已删除的区域引用，并在 KeySpaces 元数据中添加已恢复的区域引用。
使用 nodetool status 选项获取 Cassandra 数据中心名称。
```
kubectl exec -n APIGEE_NAMESPACE -it apigee-cassandra-default-0 -- bash
      nodetool  -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status |grep -i Datacenter
```
其中：
- APIGEE_JMX_USER 是 Cassandra JMX 操作用户的用户名。用于通过 Cassandra JMX 接口进行身份验证和通信。请参阅：cassandra:auth:jmx:username。
- APIGEE_JMX_PASSWORD 是 Cassandra JMX 操作用户的密码。请参阅：cassandra:auth:jmx:password。
更新 KeySpaces 复制功能。
1. 创建客户端容器并通过 CQL 接口连接到 Cassandra 集群。
2. 从 CQL 接口获取用户键空间列表：
```
cqlsh CASSANDRA_SEED_HOST -u APIGEE_DDL_USER -p APIGEE_DDL_PASSWORD
      --ssl -e "select keyspace_name from system_schema.keyspaces;"|grep -v system
```
  其中：
  - CASSANDRA_SEED_HOST 是 Cassandra 多区域种子主机。对于大多数多区域安装，请使用第一个区域中主机的 IP 地址。请参阅为多区域配置 Apigee Hybrid 和 cassandra:externalSeedHost。
  - APIGEE_DDL_USER 和 APIGEE_DDL_PASSWORD 是 Cassandra 数据定义语言 (DDL) 用户的管理员用户名和密码。默认值为“ddl_user”和“iloveapis123”。
    您可以通过检查 apigee-datastore-default-creds Secret 中存储的值来检查 DDL 用户名和密码。您必须拥有管理员权限才能检查此密文。以下命令将返回 DDL 用户名和密码的 base-64 编码值：
    kubectl get secret apigee-datastore-default-creds -n APIGEE_NAMESPACE -o yaml
    请参阅配置属性参考文档中的 cassandra.auth.ddl.password 和 Apache Cassandra cqlsh 文档中的命令行选项。
3. 对于每个键空间，请从 CQL 接口运行以下命令以更新复制设置：
```
ALTER KEYSPACE KEYSPACE_NAME WITH replication = {'class': 'NetworkTopologyStrategy', 'DATACENTER_NAME':3};
```
  其中：
  - KEYSPACE_NAME 是上一步输出中列出的键空间的名称。
  - DATACENTER_NAME 是您在第 8 步中通过 nodetool status 选项获取的 Cassandra 数据中心的名称。