跳到主要内容
版本:3.2.16.5

实现数据面弹性

弹性是指系统抵御故障、中断或意外事件,并从中恢复的能力。

本文介绍为什么应考虑在 API7 中采用数据面(Data Plane,DP)弹性模式,以及如何实现该模式。即使控制面(Control Plane,CP)不可用,数据面实例仍可正常运行。这有助于你制定灾难恢复计划,在控制面不可用时快速恢复关键任务功能,确保系统的高可用性。

你可以通过下面的交互演示了解如何实现数据面弹性。

为什么考虑 DP 弹性​

DP 可能无法连接 CP,原因包括:

  • DP 和 CP 实例之间的网络连接不良
  • CP 数据库崩溃
  • CP 升级
  • CP 主机上的资源争用
  • CP 主机硬件故障

DP 弹性模式​

API7 企业版支持将 CP 配置为定期转储配置到 AWS S3 存储桶。CP 发生故障时,DP 可以以独立模式启动,从存储桶中获取最新的网关配置并继续代理请求。

解决方案图

CP 恢复后,DP 应继续从 CP 获取配置。

实现 DP 弹性​

前提条件​

配置 AWS 资源​

  1. 创建 AWS 账户并以 IAM 用户身份登录。
  2. 创建两个 S3 存储桶,一个用于网关实例配置,例如密钥环和服务发现,另一个用于网关资源配置,例如路由和服务。
  3. 获取 IAM 用户访问密钥 和秘密访问密钥。
  4. 将允许对 S3 存储桶中的对象进行读写访问的策略附加到 IAM 用户。

将 CP 配置为备份配置​

在运行安装 API7 企业版的快速入门命令的工作目录中,你应该能找到 api7-ee 目录,其中包含 docker-compose.yaml 和各服务的配置文件。

将 fallback_cp 添加到控制台配置文件:

api7-ee/dashboard_conf/conf.yaml
fallback_cp:
aws_s3:
access_key: your-aws-iam-access-key
region: ap-south-1
config_bucket: bucket-to-push-config-data
resource_bucket: bucket-to-push-resource-data
secret_key: your-aws-iam-secret-access-key
cron_spec: '@every 1m'

❶ 替换为你的 AWS IAM 用户访问密钥。

❷ 替换为你的 AWS 区域。

❸ 替换为用于接收实例配置(例如密钥环和服务发现)的 S3 存储桶名称。

❹ 替换为用于接收 APISIX 资源配置(例如路由和服务)的 S3 存储桶名称。

❺ 替换为你的 AWS IAM 用户秘密访问密钥。

❻ 将推送到 S3 存储桶的频率配置为每分钟一次。

重启控制台容器:

docker-compose -f api7-ee/docker-compose.yaml restart api7-ee-dashboard

API7 应开始每分钟向 S3 存储桶推送一次 CP 配置。

验证​

先向路由发送请求,确认收到预期的上游响应。然后以独立模式重启 DP 部署,使 DP 开始从 S3 存储桶获取配置,并验证 DP 是否照常代理请求。

向路由发送请求:

curl "http://127.0.0.1:9080/ip"

你应该会看到类似的响应:

{
"origin": "127.0.0.1"
}

假设 CP 现在不可用。更新每个 DP 的配置文件,使其以独立模式启动:

config.yaml
deployment:
role: data_plane
role_data_plane:
config_provider: yaml
fallback_cp:
aws_s3:
access_key: your-aws-iam-access-key
secret_key: your-aws-iam-secret-access-key
config_bucket: bucket-to-push-config-data
resource_bucket: bucket-to-push-resource-data
region: ap-south-1

重新加载 DP 实例,使配置更改生效。DP 实例应以独立模式启动,从 S3 存储桶获取配置。

向路由发送请求:

curl "http://127.0.0.1:9080/ip"

你应该会看到类似的响应,表明 DP 正在使用 S3 中的配置转发请求:

{
"origin": "127.0.0.1"
}

CP 恢复后,撤销之前对部署模式的修改,再重新加载 DP 实例。实例应恢复从 CP 同步配置。