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

第19章 使用 NGINX 实现金丝雀部署

第 19 章:NGINX 金丝雀部署

本指南演示如何使用 NGINX ingress 控制器和 Flagger 自动化金丝雀部署和 A/B 测试。

Flagger NGINX 入口控制器

前置条件

Flagger 需要 Kubernetes 集群版本为 v1.19 或更高,以及 NGINX ingress v1.0.2 或更高版本。

使用 Helm v3 安装 NGINX ingress 控制器:

在与 ingress 控制器相同的命名空间中安装 Flagger 和 Prometheus 附加组件:

引导

Flagger 接收 Kubernetes 部署,可选接收水平 Pod 自动扩缩器(HPA),然后创建一系列对象(Kubernetes 部署、ClusterIP 服务及金丝雀 ingress)。这些对象在集群外暴露应用程序,并驱动金丝雀分析和晋升。

创建一个测试命名空间:

创建一个部署和一个水平 Pod 自动扩缩器:

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

创建一个 ingress 定义(将 app.example.com 替换为你自己的域名):

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

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

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

几秒钟后,Flagger 将创建金丝雀对象:

自动金丝雀晋升

Flagger 实现了一个控制循环,在测量关键性能指标(如 HTTP 请求成功率、平均请求持续时间和 Pod 健康状况)的同时,逐渐将流量切换到金丝雀版本。根据 KPI 分析,金丝雀版本被晋升或中止,分析结果会发布到 Slack 或 MS Teams。

Flagger 金丝雀阶段

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

Flagger 检测到部署修订版已更改,并启动新的推出:

注意,如果在金丝雀分析期间对部署应用新的更改,Flagger 将重启分析。

你可以监控所有金丝雀:

自动回滚

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

触发另一个金丝雀部署:

生成 HTTP 500 错误:

当失败检查数量达到金丝雀分析阈值时,流量将路由回主版本,金丝雀版本缩小至零,并且推出被标记为失败。

自定义指标

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

演示应用程序已使用 Prometheus 进行仪器化,因此你可以创建一个自定义检查,使用 HTTP 请求持续时间直方图来验证金丝雀。

创建一个指标模板并应用于集群:

编辑金丝雀分析,添加延迟检查:

阈值设置为 500ms,因此如果过去一分钟内的平均请求持续时间超过半秒钟,分析将失败,并且金丝雀版本不会被晋升。

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

生成高响应延迟:

查看 Flagger 日志:

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

A/B 测试

除了加权路由外,还可以配置 Flagger 根据 HTTP 匹配条件将流量路由到金丝雀版本。在 A/B 测试场景中,你将使用 HTTP 标头或 cookie 来定位你的特定用户群体。这对于需要会话亲和性(session affinity)的前端应用程序特别有用。

Flagger A/B 测试阶段

编辑金丝雀分析,移除 max/step 权重,并添加匹配条件和迭代次数:

上述配置将运行十分钟的分析,针对设置了 canary cookie 为 always 的用户,或使用 X-Canary: insider 标头调用服务的用户。

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

Flagger 检测到部署修订版已更改,并启动 A/B 测试:

上述步骤可以通过自定义指标检查、webhooks、手动晋升批准以及 Slack 或 MS Teams 通知进行扩展。

上一篇:Gloo 金丝雀部署

下一篇:Skipper 金丝雀部署

最后更新于 3 年前

评论 (0)