进阶 docs.flagger.app 2026-11-21 03:00:57 · 1 阅读

第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 年前

评论 (0)