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

第17章 使用 Contour 实现金丝雀发布

第17章:Contour 金丝雀发布

本指南介绍如何使用 Contour 入口控制器和 Flagger 自动化金丝雀发布和 A/B 测试。

Flagger 与 Contour 概览

前置条件 Flagger 需要 Kubernetes v1.16 或更高版本,以及 Contour v1.0 或更高版本。 在支持 LoadBalancer 的集群上安装 Contour: 上述命令将在 projectcontour 命名空间中部署 Contour 和一个 Envoy 守护进程集合(daemonset)。 使用 Kustomize(kubectl 1.14)在 projectcontour 命名空间中安装 Flagger: 上述命令将部署 Flagger 和 Prometheus,并配置 Prometheus 抓取 Contour 的 Envoy 实例指标。 或者,你可以使用 Helm v3 安装 Flagger: 你还可以启用 Slack、Discord、Rocket 或 MS Teams 通知,请参阅告警文档。

Bootstrap 初始化 Flagger 接收一个 Kubernetes 部署对象,可选地接收一个水平 Pod 自动扩缩控制器(HPA),然后创建一系列对象(Kubernetes 部署、ClusterIP 服务和 Contour HTTPProxy)。这些对象在集群内暴露应用程序,并驱动金丝雀分析和晋升过程。 创建测试命名空间: 安装负载测试服务,用于在金丝雀分析期间生成流量: 创建一个部署和一个水平 Pod 自动扩缩器: 创建一个金丝雀自定义资源(将 app.example.com 替换为你自己的域名): 将上述资源保存为 podinfo-canary.yaml 并应用: 金丝雀分析将持续五分钟,每半小时验证一次 HTTP 指标和回滚钩子。 几秒钟后,Flagger 将创建金丝雀对象: Bootstrap 完成后,podinfo 部署将被缩容至零,指向 podinfo.test 的流量将路由到主版本 Pod。在金丝雀分析期间,可以使用 podinfo-canary.test 地址直接指向金丝雀 Pod。

将应用暴露到集群外部 查找 Contour 的 Envoy 负载均衡器的外部地址: 配置你的 DNS 服务器,使用 CNAME 记录(AWS)或 A 记录(GKE/AKS/DOKS),并将一个域名(例如 app.example.com)指向 LB 地址。 创建一个 HTTPProxy 定义,并包含由 Flagger 生成的 podinfo 代理(将 app.example.com 替换为你自己的域名): 将上述资源保存为 podinfo-ingress.yaml 并应用: 使用以下命令验证 Contour 是否已处理该代理定义: 现在你可以使用你的域名地址访问 podinfo UI。 注意,在将生产工作负载暴露到互联网时,应使用 HTTPS。你可以从 Let's Encrypt 获取免费 TLS 证书,阅读此指南了解如何配置 cert-manager 以使用 TLS 证书保护 Contour。

自动化金丝雀晋升 Flagger 实现了一个控制循环,在测量关键性能指标(如 HTTP 请求成功率、平均请求持续时间和 Pod 健康状况)的同时,逐步将流量切换到金丝雀版本。基于对 KPI 的分析,金丝雀版本将被晋升或中止。

Flagger 金丝雀阶段 金丝雀发布由以下任一对象的变更触发: 部署的 PodSpec(容器镜像、命令、端口、环境变量、资源等) 以卷形式挂载或映射为环境变量的 ConfigMap 和 Secret 通过更新容器镜像触发金丝雀发布: Flagger 检测到部署修订版本发生变化,并启动新的发布: 当金丝雀分析开始时,Flagger 会在将流量路由到金丝雀之前调用预发布 Webhook。 注意,如果在金丝雀分析期间你对部署应用了新变更,Flagger 将重启分析。 你可以使用以下命令监控所有金丝雀版本: 如果你启用了 Slack 通知,你应该会收到以下消息: Flagger Slack 通知

自动化回滚 在金丝雀分析期间,你可以生成 HTTP 500 错误或高延迟,以测试 Flagger 是否暂停发布。 触发一次金丝雀发布: 执行以下命令进入负载测试 Pod: 生成 HTTP 500 错误: 生成延迟: 当失败检查次数达到金丝雀分析阈值时,流量将路由回主版本,金丝雀版本缩容至零,发布被标记为失败。 如果你启用了 Slack 通知,如果进度超过截止时间或分析达到最大失败检查次数,你将收到一条消息: Flagger Slack 通知

A/B 测试 除了加权路由,Flagger 还可以配置为基于 HTTP 匹配条件将流量路由到金丝雀版本。在 A/B 测试场景中,你将使用 HTTP 标头或 Cookie 来定位你的用户中的特定细分群体。这对于需要会话亲和性的前端应用尤其有用。

Flagger A/B 测试阶段 编辑金丝雀分析,移除最大/步长权重,并添加匹配条件和迭代次数: 上述配置将运行十分钟的分析,定位具有 X-Canary: insider 标头的用户。 你也可以使用 HTTP Cookie。为了定位所有 Cookie 设置为 insider 的用户,匹配条件应为: 通过更新容器镜像触发金丝雀发布: Flagger 检测到部署修订版本发生变化,并启动 A/B 测试: Web 浏览器用户代理标头允许基于设备或操作系统进行用户细分。 例如,如果你想将所有移动用户路由到金丝雀实例: 或者如果你只想定位 Android 用户: 或者特定的浏览器版本: 如需深入了解分析过程,请阅读使用文档。

上一篇:Knative 金丝雀发布 下一篇:Gloo 金丝雀发布 最后更新于 3 年前

评论 (0)