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

第12章 Istio 金丝雀发布实战

第12章 Istio 金丝雀发布

本指南演示如何利用 Istio 和 Flagger 自动化金丝雀发布。

Flagger 金丝雀阶段

前置条件

Flagger 要求 Kubernetes 集群版本为 v1.16 或更高,Istio 版本为 v1.5 或更高。

安装带遥测支持的 Istio 和 Prometheus:

在 istio-system 命名空间中安装 Flagger:

创建一个入口网关,将演示应用暴露在网格之外:

初始化

Flagger 会接受一个 Kubernetes 部署对象,以及可选的水平 Pod 自动扩缩容(HPA)对象,随后创建一系列对象(包括 Kubernetes 部署、ClusterIP 服务、Istio 目标规则和虚拟服务)。这些对象用于在网格内部暴露应用程序,并驱动金丝雀分析和晋升。

创建一个启用 Istio sidecar 注入的测试命名空间:

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

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

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

请注意,如果使用 Istio 1.4,你需要用 metric template 替换 request-duration。

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

当金丝雀分析开始时,Flagger 会在将流量路由到金丝雀之前调用 pre-rollout webhooks。金丝雀分析将持续五分钟,在此期间每分钟验证一次 HTTP 指标和回滚钩子。

Flagger 金丝雀流程

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

自动化金丝雀晋升

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

Flagger 检测到部署版本发生变化,并开始新的发布过程:

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

任何以下对象的变化都会触发金丝雀发布: * Deployment PodSpec(容器镜像、命令、端口、环境变量、资源等) * 挂载为卷或映射到环境变量的 ConfigMaps * 挂载为卷或映射到环境变量的 Secrets

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

自动化回滚

在金丝雀分析期间,你可以生成 HTTP 500 错误和高延迟,以测试 Flagger 是否会暂停发布。

触发另一个金丝雀发布:

使用以下命令进入 load tester pod:

生成 HTTP 500 错误:

生成延迟:

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

会话亲和性

虽然 Flagger 可以单独执行加权路由和 A/B 测试,但结合 Istio 时,它可以结合这两者,从而实现带有会话亲和性的金丝雀发布。更多信息请阅读部署策略文档。

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

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

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

你可以在浏览器中加载 app.example.com 并刷新,直到看到请求由 podinfo:6.0.1 提供服务。在那之后的所有后续请求都将由 podinfo:6.0.1 提供,而不是 podinfo:6.0.0,因为 Flagger 与 Istio 配置了会话亲和性。

要为主部署配置粘滞性以确保公平的加权流量路由,请查看部署策略文档。

流量镜像

Flagger 金丝雀流量阴影

对于执行读操作的应用程序,可以配置 Flagger 使用流量镜像来驱动金丝雀发布。Istio 流量镜像将复制每个传入请求,发送一个请求到主版本,发送一个到金丝雀服务。主版本的响应发回给用户,而金丝雀的响应则被丢弃。两个请求都会收集指标,只有当金丝雀指标在阈值范围内时,部署才会继续。

请注意,镜像应仅用于幂等或可被处理两次的请求(一次由主版本,一次由金丝雀版本)。

你可以通过将 stepWeight/maxWeight 替换为 iterations,并设置 analysis.mirror 为 true 来启用镜像:

使用上述配置,Flagger 将按以下步骤执行金丝雀发布: * 检测新版本(部署 spec、secrets 或 configmaps 的变化) * 从零扩展金丝雀部署 * 等待 HPA 设置金丝雀最小副本数 * 检查金丝雀 pod 健康状态 * 运行验收测试 * 如果测试失败则中止金丝雀发布 * 启动负载测试 * 将主版本 100% 的流量镜像到金丝雀 * 每分钟检查请求成功率和请求持续时间 * 如果指标检查失败阈值达到则中止金丝雀发布 * 达到迭代次数后停止流量镜像 * 将实时流量路由到金丝雀 pods * 晋升金丝雀(更新主版本的 secrets、configmaps 和部署 spec) * 等待主部署发布完成 * 等待 HPA 设置主版本最小副本数 * 检查主版本 pods 健康状态 * 将实时流量切换回主版本 * 将金丝雀缩容至零 * 发送包含金丝雀分析结果的通知

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

TCP 服务的金丝雀发布

在 TCP(非 HTTP)服务上执行金丝雀发布与 HTTP 金丝雀几乎相同。除了更新 Gateway 文档以支持 TCP 路由外,唯一的区别是你需要在金丝雀文档的服务部分将 appProtocol 字段设置为 TCP。

示例:

如果 appProtocol 等于 TCP,Flagger 将把它视为 TCP 服务的金丝雀发布。在创建 VirtualService 文档时,它会添加一个 TCP 部分来路由主版本和金丝雀服务之间的请求。有关此规范的更多信息,请参阅 Istio 文档。

生成的 VirtualService 将包含一个类似的 tcp 部分:

一旦开始金丝雀分析,Flagger 将能够调整该 tcp 部分中的权重以推进金丝雀发布,直到遇到错误(并停止)或成功完成分析并晋升为止。

还值得注意的是,如果你将 appProtocol 设置为除 TCP 以外的任何值,例如设置为 HTTP,它将执行金丝雀发布并将其视为 HTTP 服务。如果你完全不设置 appProtocol,情况也是如此。只有当 appProtocol 等于 TCP 时,它才会将金丝雀视为 TCP 服务。

上一页 Gateway API 金丝雀发布 下一页 Istio A/B 测试 最后更新于 6 个月前

评论 (0)