跳到主要内容
版本:2.13.2304

发布管理

灰度发布又名金丝雀发布,是指在稳定的生产环境之外,额外部署一个小规模的灰度集群,通过控制流量的方式将部分流量在灰度集群进行验证。如果验证失败,可以立即将所有流量切换到稳定集群中;如果验证无异常,可以将流量全量发布到新的集群中,完成灰度发布任务。

新建发布管理

API 的后端服务更新时,在调用方无需调整配合的情况下,先用灰度发布的方式进行验证。 内部研发/测试人员先自测目标上游服务:使用按规则流量分配方式,自测调用时带上特定header/请求头/cookie,并定向转发到目标上游。 自测通过后正式上线前灰度测试:使用按百分比流量分配方式,逐步将目标上游服务比例从小增大,反复多次测试,验证目标上游服务稳定后,进行全量发布。

  1. 登录 API7 Enterprise 控制台。
  2. 在顶部导航菜单,点击 集群管理
  3. 在左侧菜单,点击 集群列表
  4. 点击对应集群的 访问 按钮。
  5. 在左侧菜单,点击 工作分区
  6. 点击对应工作分区的 访问 按钮。
  7. 在左侧菜单,点击 API 管理-发布管理
  8. 点击 新建 按钮。
  9. 填写表单。
  10. 点击 提交 按钮。

配置发布管理

新建发布管理并验证目标上游服务正常后,通过不断增加目标上游的百分比多次测试;或通过修改参数,让带不同header/请求头/cookie的请求定向转发到目标上游。

  • 调整百分比/规则可反复进行多次,没有次数限制。
  • 可直接切换流量分配方式。
  • 如果使用按规则流量分配方式,但没有任何请求命中规则,则无法达到灰度发布效果。
  1. 登录 API7 Enterprise 控制台。
  2. 在顶部导航菜单,点击 集群管理
  3. 在左侧菜单,点击 集群列表
  4. 点击对应集群的 访问 按钮。
  5. 在左侧菜单,点击 工作分区
  6. 点击对应工作分区的 访问 按钮。
  7. 在左侧菜单,点击 API 管理-发布管理
  8. 修改发布管理的配置。
  9. 点击 提交 按钮。

取消任务

验证发现目标上游不符合预期或不稳定,放弃更新上游,目标 API 的所有请求仍然转发到当前上游。仅状态为”进行中“的任务可以被取消。取消成功的任务,无法再被恢复使用。

  1. 登录 API7 Enterprise 控制台。
  2. 在顶部导航菜单,点击 集群管理
  3. 在左侧菜单,点击 集群列表
  4. 点击对应集群的 访问 按钮。
  5. 在左侧菜单,点击 工作分区
  6. 点击对应工作分区的 访问 按钮。
  7. 在左侧菜单,点击 API 管理-发布管理
  8. 点击对应任务的 更多 下拉菜单,然后点击 取消任务 按钮。
  9. 点击 确认 按钮。

删除任务

取消灰度发布任务,并删除任务记录。状态为”进行中“和”已取消“的任务都可以被删除。

  1. 登录 API7 Enterprise 控制台。
  2. 在顶部导航菜单,点击 集群管理
  3. 在左侧菜单,点击 集群列表
  4. 点击对应集群的 访问 按钮。
  5. 在左侧菜单,点击 工作分区
  6. 点击对应工作分区的 访问 按钮。
  7. 在左侧菜单,点击 API 管理-发布管理
  8. 点击对应任务的 更多 下拉菜单,然后点击 删除 按钮。
  9. 点击 确认 按钮。

全量发布

验证发现目标上游符合预期且运行稳定,将目标 API 的全部请求转发到目标上游,替换路由/ API 中的上游配置。仅状态为”进行中“的任务都可以被全量发布。

  1. 登录 API7 Enterprise 控制台。
  2. 在顶部导航菜单,点击 集群管理
  3. 在左侧菜单,点击 集群列表
  4. 点击对应集群的 访问 按钮。
  5. 在左侧菜单,点击 工作分区
  6. 点击对应工作分区的 访问 按钮。
  7. 在左侧菜单,点击 API 管理-发布管理
  8. 点击对应任务的 更多 下拉菜单,然后点击 全量发布 按钮。
  9. 点击 确认 按钮。