高可用安装
本文介绍如何从以下方面配置 API7 网关高可用:
- 控制面
- API7 控制台
- DP Manager
- 数据面
- API7 网关
不涵盖:
- PostgreSQL
- Prometheus
前提条件
- 完成高可用准备工作。
- 安装 PostgreSQL(版本 15)和 Prometheus(可选,版本 2.48)。
控制面
API7 控制台是控制面的主要组件,提供 Web 图形界面并处理业务逻辑。API7 控制台是无状态服务,所有数据信息都存储在 PostgreSQL 中。
要确保高可用,需要一个包含多个控制面节点的控制面集群。此外,还必须在所有控制面节点之前部署负载均衡器。如果某个节点发生故障,负载均衡器可以将其从节点池中移除,确保流量不会发送到不可用的节点。
对所有控制面节点执行以下操作:
- 将控制面安装包复制到主机。你可以从高可用准备工作中获取适用的安装包。
- 配置
dashboard-config.yaml,修改数据库地址:
server:
listen:
host: "0.0.0.0"
port: 17080
database:
dsn: "postgres://$user:$password@$postgresql_address:$postgresql_port/api7ee"
- 启动 API7 控制台:
docker run -d -p 17080:17080 -v ./dashboard-config.yaml:/app/conf/config.yaml api7/api7-ee-3-integrated:v3.2.16.3
- 配置
dp-manager-config.yaml,修改数据库地址:
server:
listen:
host: "0.0.0.0"
port: 17900
database:
dsn: "postgres://$user:$password@$postgresql_address:$postgresql_port/api7ee"
- 启动 DP Manager:
docker run -d -p 17900:17900 -v ./dp-manager-config.yaml:/usr/local/api7/conf/config.yaml api7/api7-ee-dp-manager:v3.2.16.3
数据面
API7 网关负责接收客户端流量并将其转发到上游,因此数据面节点也称为网关实例。API7 网关是无状态组件,所有配置信息都存储在 PostgreSQL 中。因此,可以部署多个节点来提高数据面的高可用性。
新增网关组
要确保高可用,需要一个包含多个数据面节点的数据面集群。数据面集群也称为网关组。操作步骤请参阅新增网关组。
健康检查
在数据面节点之前部署负载均衡器并启用健康检查,对于维持高可用和确保流量不被路由到不健康节点至关重要。
- 配置
gateway_conf/config.yaml,添加status块以设置监听接口:
apisix:
status:
ip: 0.0.0.0
port: 7085
- 设置负载均衡器定期调用健康检查接口。根据具体需求和应用程序的预期响应时间确定适当的健康检查频率。常见做法是每 30 秒探测一次。
curl "http://127.0.0.1:7085/status" -v
如果数据面健康,你应该看到以下 200 OK 响应:
* Trying 127.0.0.1:7085...
* Connected to 127.0.0.1 (127.0.0.1) port 7085 (#0)
> GET /status HTTP/1.1
> Host: 127.0.0.1:7085
> User-Agent: curl/7.74.0
> Accept: */*
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< Server: openresty
< Date: Thu, 17 Oct 2024 06:27:38 GMT
< Content-Type: text/plain; charset=utf-8
< Transfer-Encoding: chunked
< Connection: keep-alive
<
* Connection #0 to host 127.0.0.1 left intact