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

第21章 Traefik 金丝雀部署实战

第21章:Traefik 金丝雀部署

本指南演示如何利用 Traefik 和 Flagger 实现金丝雀部署的自动化。

Flagger 与 Traefik 概述

前置条件

Flagger 要求使用 v1.16 或更高版本的 Kubernetes 集群,以及 v2.3 或更高版本的 Traefik。

使用 Helm v3 安装 Traefik:

在 Traefik 所在的命名空间中安装 Flagger 和 Prometheus 插件:

初始化配置

Flagger 会接管 Kubernetes 的 Deployment,可选地结合 Horizontal Pod Autoscaler (HPA),进而生成一系列资源对象(Kubernetes Deployments、ClusterIP Services 和 TraefikService)。这些对象将应用暴露至集群外部,并驱动金丝雀分析及其流量晋升流程。

创建测试命名空间:

创建一个 Deployment 和一个 HPA:

部署负载测试服务,以便在金丝雀分析期间生成流量:

创建一个引用 Flagger 生成的 TraefikService 的 Traefik IngressRoute(请将 app.example.com 替换为你自己的域名):

将上述资源保存为 podinfo-ingressroute.yaml,然后应用:

创建一个金丝雀自定义资源(请将 app.example.com 替换为你自己的域名):

将上述资源保存为 podinfo-canary.yaml,然后应用:

几秒钟后,Flagger 将创建相关对象:

自动化金丝雀晋升

Flagger 实现了一个控制循环,在测量关键绩效指标(如 HTTP 请求成功率、平均请求耗时和 Pod 健康状态)的同时,逐步将流量切换至金丝雀版本。基于对 KPI 的分析,Flagger 决定是否晋升或中止该版本,并将分析结果发布到 Slack 或 Microsoft Teams。

Flagger 金丝雀阶段

通过更新容器镜像来触发金丝雀部署:

Flagger 检测到 Deployment 修订版发生变化,并启动新的发布流程:

注意,如果在金丝雀分析期间你对 Deployment 应用了新的变更,Flagger 将重新发起分析。

你可以使用以下命令监控所有金丝雀:

自动化回滚

在金丝雀分析期间,你可以生成 HTTP 500 错误,以测试 Flagger 是否会暂停并回滚故障版本。

触发另一次金丝雀部署:

通过以下命令进入负载测试 Pod:

生成 HTTP 500 错误:

生成延迟:

当失败检查次数达到金丝雀分析阈值时,流量将回切至主版本,金丝雀版本将缩容至零,且发布流程标记为失败。

自定义指标

可以通过 Prometheus 查询扩展金丝雀分析。

创建一个指标模板并将其应用到集群:

编辑金丝雀分析,添加“未找到”错误率检查:

上述配置通过检查 HTTP 404 请求/秒的百分比是否低于总流量的 5% 来验证金丝雀版本。如果 404 错误率达到 5% 的阈值,则金丝雀发布失败。

通过更新容器镜像触发金丝雀部署:

生成 404 错误:

查看 Flagger 日志:

如果已配置告警,Flagger 将发送通知说明金丝雀发布失败的原因。

欲深入了解分析流程,请参阅使用文档。

上一篇:Skipper 金丝雀部署 下一篇:Apache APISIX 金丝雀部署 最后更新于 1 年前

评论 (0)