使用网关组在多环境中管理服务
网关组是一个由一个或多个共享相同配置的网关实例组成的逻辑分组,这些网关实例在处理 API 请求时表现一致。用户可以为网关组命名,并为其添加标签,以此来区分和管理不同的环境和集群。
API7 企业版支持 API 网关 和 Ingress Controller 两种网关组类型。企业可以借此隔离环境和集群、管理多个区域和集群,以及按项目管理服务级别目标。
本指南介绍如何使用网关组管理 Test、UAT 和 Production 环境中的服务。下方的交互式演示展示了相关操作。
背景介绍
为确保稳定性、合规性和数据安全,服务需要经过测试、UAT 和生产等环境。缺少网关组功能时,开发人员需要部署三套 API7 企业版,分别登录不同域名的控制台来开发、测试和部署同一个 API。项目较多时,这会耗费大量机器和管理资源。
API7 企业版的网关组功能为研发人员提供了一个统一的入口,避免在多控制台中切换,可以实现简单便捷的发布操作,从而提高工作效率并减少操作错误。

前提条件
- 安装 API7 企业版。
- 准备好服务在三个环境内的不同域名:
test.acme.com、uat.acme.com、prod.acme.com。 - 参阅新增网关组,创建
Test、UAT和Production三个网关组。
在测试环境新增服务和路由
- 从左侧菜单选择
Test网关组下的已发布服务,然后点击新增服务。 - 选择手动新增。
- 在新增服务对话框中,执行以下操作:
- 名称填写
httpbin。 - 点击 + 添加节点。
- 在新增节点对话框中,执行以下操作:
- 主机填写
test.api7.ai。 - 端口填写
80。 - 点击新增。
- 主机填写
- 名称填写
- 在主机字段中,点击 + 新增。
- 输入
test.acme.com。
- 输入
- 打开添加第一条路由按钮。
- 在第一个路由对话框中,执行以下操作:
- 名称填写
get-headers。 - 路径填写
headers。 - HTTP 方法选择
GET。 - 点击新增。将创建一个处于“无版本”状态的新服务
httpbin。
- 名称填写
- 进入上游页面。
- (可选)在连接配置模块中,点击编辑图标。
- (可选)在编辑连接配置对话框中,执行以下操作:
- 传递给上游的 Host 请求头选择
使用节点的 Host。 - 点击保存。
- 传递给上游的 Host 请求头选择
步骤 8 和 9 为可选步骤。要确保与上游成功握手,需将
pass_host参数设为使用节点的 Host。请根据使用场景调整。
- 模拟真实用户场景进行功能测试、性能测试和安全测试。
验证服务
测试后,发送请求以验证测试网关组中的 httpbin 服务:
curl "http://localhost:9080/headers" -v -H "Host: test.acme.com"
你应该能收到 200 OK 的响应。
将服务部署到 UAT 环境
- 从左侧菜单选择
Test网关组下的已发布服务。 - 点击
httpbin服务旁边的 ...,然后点击同步到其他网关组。 - 在选择要同步到的网关组字段中,选择
UAT网关组,然后点击下一步。 - 在将
httpbin同步至UAT网关组的对话框中完成以下设置。- 版本填写
1.0.0。 - 请求 URL 填写
uat.acme.com。 - 在上游配置模块中,点击编辑。
- 在对话框中,执行以下操作:
- 主机和端口填写入
uat.api7.ai作为主机,80作为端口。 - 权重 使用默认值
100。 - 点击保存。
- 主机和端口填写入
- 确认服务信息,然后点击同步。
httpbin服务将同步到UAT网关组。
- 版本填写
- (可选)在连接配置模块中,点击编辑图标。
- (可选)在编辑连接配置对话框中,执行以下操作:
- 传递给上游的 Host 请求头选择
使用节点的 Host。 - 点击保存。
- 传递给上游的 Host 请求头选择
步骤 8 和 9 为可选步骤。要确保与上游成功握手,需将
pass_host参数设为使用节点的 Host。请根据使用场景调整。
- 在
UAT网关组中,配置网关组的安全策略和合规性检查功能,例如进行日志审计。
验证服务
测试后,发送请求以验证测试网关组中的 httpbin 服务:
curl "http://localhost:9080/headers" -v -H "Host: uat.acme.com"
你应该能收到 200 OK 的响应。
将服务部署到生产环境
- 从左侧菜单选择
UAT网关组下的已发布服务。 - 点击
httpbin服务旁边的 ...,然后点击同步到其他网关组。 - 在选择要同步到的网关组字段中,选择
Production网关组,然后点击下一步。 - 在将服务 httpbin 同步到 Production 网关组对话框中,执行以下操作:
- 请求 URL填写
production.acme.com。 - 在上游配置模块中,点击编辑。
- 在编辑节点对话框中,执行以下操作:
- 主机和端口填写
prod.api7.ai作为主机,80作为端口。 - 权重使用默认值
100。 - 点击保存。
- 主机和端口填写
- 确认服务信息,然后点击同步。
httpbin服务将同步到Production网关组。
- 请求 URL填写
- (可选)在连接配置模块中,点击编辑图标。
- (可选)在编辑连接配置对话框中完成以下设置。
- 传递给上游的 Host 请求头选择
使用节点的 Host。 - 点击保存。
- 传递给上游的 Host 请求头选择
步骤 8 和 9 为可选步骤。要确保与上游成功握手,需将
pass_host参数设为使用节点的 Host。请根据使用场景调整。
- 定期审查和分析
httpbin的日志,执行日志管理,并识别潜在的问题以进行改进。 - 制定详细的回滚计划,包括回滚步骤、所需时间和责任人员,并在必要时回滚已发布的服务。
验证服务
测试后,发送请求以验证测试网关组中的 httpbin 服务:
curl "http://localhost:9080/headers" -v -H "Host: production.acme.com"
你应该能收到 200 OK 的响应。
总结
测试、UAT 和生产环境是软件开发生命周期的重要组成部分。通过利用 API7 企业版的网关组,你可以实现物理和逻辑隔离,从而增强安全性、可控性和效率。此外,灵活调整路由规则和管理服务版本的能力可确保应用程序的平滑和敏捷版本管理。