第11章 Gateway API 金丝雀发布实战:使用 Flagger 实现自动化部署与 A/B 测试
Gateway API 金丝雀发布
本指南介绍如何使用 Gateway API 和 Flagger 自动化金丝雀部署和 A/B 测试。
Flagger Gateway API 集成
前置条件
Flagger 需要一个实现了 Gateway API HTTPRoute(v1 或 v1beta1)的 Ingress 控制器或服务网格。 本教程以 Istio 为例,但你也可以使用其他实现方案。
安装 Gateway API CRD: 安装 Istio: 在 flagger-system 命名空间中安装 Flagger: 为 Gateway 创建命名空间: 创建一个 Gateway,配置负载均衡、流量 ACL 等:
初始化
Flagger 接收 Kubernetes Deployment 以及可选的水平 Pod 自动扩缩容(HPA),然后创建一系列对象(Kubernetes Deployments、ClusterIP Services、用于 Gateway 的 HTTPRoutes)。这些对象在网格内暴露应用,并驱动金丝雀分析和晋升。
创建测试命名空间: 创建 Deployment 和水平 Pod 自动扩缩容: 部署负载测试服务,用于在金丝雀分析期间生成流量: 创建指向 flagger-system 命名空间中 Prometheus 服务器的指标模板。以下 PromQL 查询适用于 Envoy,但你可以根据你的 Ingress/网格供应商进行修改。 将上述资源保存为 metric-templates.yaml 并应用: 创建一个 Canary 自定义资源(将 "www.example.com" 替换为你的域名): 将上述资源保存为 podinfo-canary.yaml 并应用:
当金丝雀分析开始,Flagger 会在将流量路由到金丝雀之前调用 pre-rollout webhooks。金丝雀分析将持续五分钟,每分钟验证一次 HTTP 指标和 rollout hooks。 几秒钟后,Flagger 将创建金丝雀对象:
将应用暴露到集群外部
查找 Istio 负载均衡器的外部地址:
配置你的 DNS 服务器,使用 CNAME 记录(AWS)或 A 记录(GKE/AKS/DOKS),将域名(例如 www.example.com)指向 LB 地址。
现在你可以通过域名地址访问 podinfo UI。
注意,当在生产环境中通过互联网暴露工作负载时,应使用 HTTPS。如果你使用的是本地集群,可以端口转发到 Envoy LoadBalancer 服务:
现在你可以通过 curl -H "Host: www.example.com" localhost:8080 访问 podinfo。
自动金丝雀晋升
应用初始化完成后,Flagger 将持续监控部署的变化。当检测到新修订版本时,Flagger 将开始金丝雀分析,并逐渐将流量转移到新版本。
Flagger 金丝雀阶段
通过更新容器镜像触发金丝雀部署: Flagger 检测到部署修订版本变更,并开始新的 rollout: 注意,如果在金丝雀分析期间对部署应用新更改,Flagger 将重新启动分析。 以下任何对象的变更都可能触发金丝雀部署: Deployment PodSpec(容器镜像、命令、端口、环境变量、资源等) 挂载为卷或映射到环境变量的 ConfigMaps 挂载为卷或映射到环境变量的 Secrets 你可以使用以下命令监控 Flagger 如何逐步更改附加到 Gateway 的 HTTPRoute 对象的权重: 你可以使用以下命令监控所有金丝雀:
自动回滚
在金丝雀分析期间,你可以生成 HTTP 500 错误和高延迟,以测试 Flagger 是否暂停 rollout。 触发另一个金丝雀部署: 使用以下命令 exec 进入负载测试 Pod: 生成 HTTP 500 错误: 生成高延迟: 当失败检查次数达到金丝雀分析阈值时,流量将路由回主要版本,金丝雀被缩容至零,rollout 标记为失败。
A/B 测试
除了加权路由,还可以配置 Flagger 基于 HTTP 匹配条件将流量路由到金丝雀。在 A/B 测试场景中,你将使用 HTTP 头部和 Cookie 来针对特定用户群体。
Flagger A/B 测试阶段
创建一个 Canary 自定义资源(将 "www.example.com" 替换为你的域名): 上述配置将执行十分钟的分析,目标用户是拥有 insider Cookie 或使用 Firefox 浏览器的用户。 将上述资源保存为 podinfo-ab-canary.yaml 并应用: 通过更新容器镜像触发金丝雀部署: Flagger 检测到部署修订版本变更,并开始新的 rollout:
会话保持
虽然 Flagger 可以分别执行加权路由和 A/B 测试,但配合 Gateway API,它可以结合两者,实现带有会话保持的金丝雀发布。更多信息请参阅部署策略文档。 注意:会话保持需要支持 ResponseHeaderModifier API 的 Gateway API 实现。 创建一个 Canary 自定义资源(将 www.example.com 替换为你的域名): 将上述资源保存为 podinfo-canary-session-affinity.yaml 并应用: 通过更新容器镜像触发金丝雀部署: 你可以在浏览器中加载 www.example.com 并刷新,直到看到请求由 podinfo:6.0.1 处理。之后的所有请求都将由 podinfo:6.0.1 处理,而不再是 podinfo:6.0.0,这是因为 Flagger 在 HTTPRoute 对象中配置的会话保持。 为确保公平的加权流量路由,请查阅部署策略文档以配置主要部署的粘性。
流量镜像
Flagger 金丝雀流量影子
对于执行读操作的应用,可以配置 Flagger 通过流量镜像执行 B/G 测试。 注意:流量镜像需要支持 RequestMirror 过滤器的 Gateway API 实现。 你可以通过用 iterations 替换 stepWeight 并设置 analysis.mirror 为 true 来启用镜像: Gateway API 流量镜像将复制每个传入请求,发送一个请求到主要服务,一个请求到金丝雀服务。主要服务的响应发送回用户,而金丝雀服务的响应被丢弃。 两个请求的指标都会被收集,只有当金丝雀指标在阈值范围内时,部署才会继续。 上述流程可以通过自定义指标检查、webhooks、手动晋升审批以及 Slack 或 MS Teams 通知进行扩展。
自定义 HTTPRoute
除了 hosts 和 gatewayRefs 字段外,你还可以使用 Canary 的 spec.service 字段下暴露的各种选项来定制生成的 HTTPRoute。
超时
你可以使用 Canary 的 spec.service.timeout 和 spec.service.backendTimeout 字段配置生成 HTTPRoute 的请求超时。这两个值都是 Gateway API 的 Duration 字符串(例如 5s, 500ms)。 timeout 映射到 HTTPRouteTimeouts.Request,限制从网关接收请求到响应发送回客户端的总请求持续时间。 backendTimeout 映射到 HTTPRouteTimeouts.BackendRequest,限制网关到后端的单个请求持续时间。当与 timeout 一起设置时,backendTimeout 必须小于或等于 timeout。 注意:超时需要支持 HTTPRouteTimeouts 的 Gateway API 实现。backendTimeout 还需要支持 BackendRequest 超时字段。 示例配置:
头部操作
你可以使用 Canary 的 spec.service.headers 字段配置请求和响应头部的操作。 注意:头部操作需要支持 RequestHeaderModifier 和 ResponseHeaderModifier 过滤器的 Gateway API 实现。 示例配置:
URL 重写
你可以使用 Canary 的 spec.service.rewrite 字段配置 URL 重写,以修改请求的路径或主机名。 注意:URL 重写需要支持 URLRewrite 过滤器的 Gateway API 实现。 示例配置: type 字段决定 URI 重写如何执行: ReplaceFullPath:用指定的 uri 值替换整个请求路径 ReplacePrefixMatch:仅替换路径中匹配的前缀部分 使用 ReplacePrefixMatch 替换前缀的示例: 当使用 ReplacePrefixMatch 时,如果请求到达 /old/path,且 HTTPRoute 匹配前缀 /old,请求将被重写为 /api/v2/path。
CORS 策略
跨源资源共享策略可以通过 Canary 的 spec.service.corsPolicy 字段进行配置。 注意:跨源资源共享需要支持 CORS 过滤器的 Gateway API 实现。 示例配置:
上一篇:监控 | 下一篇:Istio 金丝雀发布 | 最后更新于 4 个月前