第22章 使用 Apache APISIX 实现金丝雀发布
第22章:Apache APISIX 金丝雀发布
本指南演示如何使用 Apache APISIX 与 Flagger 实现自动化金丝雀发布。
Flagger 与 Apache APISIX 概览
前提条件
Flagger 要求 Kubernetes 集群版本为 v1.19 或更高,Apache APISIX 版本为 v2.15 或更高,以及 Apache APISIX Ingress Controller 版本为 v1.5.0 或更高。
使用 Helm v3 安装 Apache APISIX 及 Ingress Controller:
在与 Apache APISIX 相同的命名空间中安装 Flagger 及 Prometheus 附加组件:
基础配置
Flagger 接收一个 Kubernetes Deployment,可选地配合一个水平 Pod 自动扩缩容器(HPA),随后创建一系列对象(Kubernetes Deployment、ClusterIP Service 以及 ApisixRoute)。这些对象负责将应用暴露到集群外部,并驱动金丝雀分析流程及后续晋升。
创建一个测试命名空间:
创建一个 Deployment 及 HPA:
部署用于负载测试的服务,以便在金丝雀分析期间生成流量:
创建一个 Apache APISIX ApisixRoute。Flagger 将引用该资源并生成对应的金丝雀 ApisixRoute(请将 app.example.com 替换为您自己的域名):
将上述资源保存为 podinfo-apisixroute.yaml,然后应用:
创建一个 Canary 自定义资源(请将 app.example.com 替换为您自己的域名):
将上述资源保存为 podinfo-canary.yaml,然后应用:
几秒钟后,Flagger 将创建相应的金丝雀对象:
自动化金丝雀晋升
Flagger 实现了一个控制循环,在测量关键性能指标(如 HTTP 请求成功率、平均响应时间及 Pod 健康状态)的同时,逐步将流量切换到金丝雀版本。根据对 KPI 的分析结果,系统会执行晋升或中止操作,并将分析结果发布至 Slack 或 MS Teams。
Flagger 金丝雀阶段
通过更新容器镜像触发一次金丝雀发布:
Flagger 检测到 Deployment 修订版本发生变化,并启动新的发布流程:
请注意,若在金丝雀分析期间对 Deployment 应用新的变更,Flagger 将重启分析过程。
您可以使用以下命令监控所有金丝雀实例:
自动化回滚
在金丝雀分析过程中,您可以制造 HTTP 500 错误,以测试 Flagger 是否能暂停并回滚故障版本。
触发另一次金丝雀发布:
使用以下命令进入负载测试器 Pod:
生成 HTTP 500 错误:
生成延迟:
当检查失败次数达到金丝雀分析阈值时,流量将回切至主版本,金丝雀副本数缩容至零,且此次发布被标记为失败。
自定义指标
可以通过 Prometheus 查询扩展金丝雀分析能力。
创建一个指标模板并在集群中应用:
编辑金丝雀分析配置,并添加“未找到”错误率检查:
上述配置通过检查 HTTP 404 请求/秒占比是否低于总流量的 5% 来验证金丝雀版本。若 404 错误率达到 5% 阈值,则判定金丝雀失败。
上述流程还可扩展,支持更多自定义指标检查、Webhooks、手动晋升审批以及 Slack 或 MS Teams 通知。
上一节:Traefik 金丝雀发布
下一节:蓝绿部署
最后更新于 3 年前