实现数据面弹性
弹性是指系统抵御故障、中断或意外事件,并从中恢复的能力。
本文介绍为什么应考虑在 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 资源
- 创建 AWS 账户并以 IAM 用户身份登录。
- 创建两个 S3 存储桶,一个用于网关实例配置,例如密钥环和服务发现,另一个用于网关资源配置,例如路由和服务。
- 获取 IAM 用户访问密钥 和秘密访问密钥。
- 将允许对 S3 存储桶中的对象进行读写访问的策略附加到 IAM 用户。
将 CP 配置为备份配置
在运行安装 API7 企业版的快速入门命令的工作目录中,你应该能找到 api7-ee 目录,其中包含 docker-compose.yaml 和各服务的配置文件。
将 fallback_cp 添加到控制台配置文件:
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 的配置文件,使其以独立模式启动:
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 同步配置。