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

第2章 Flagger 常见问题解答(FAQ)

FAQ 部署策略

Flagger 支持哪些部署策略? Flagger 实现以下部署策略: Canary 发布 A/B 测试 蓝绿部署 蓝绿镜像

何时应该使用 A/B 测试而非渐进式流量转移? 对于需要会话亲和性的前端应用,应使用 HTTP 头或 Cookie 匹配条件,以确保一组用户在整个 Canary 分析期间始终停留在同一版本。

能否使用 Flagger 管理服务网格外的应用? 对于未部署在服务网格上的应用,Flagger 可以通过 Kubernetes L4 网络编排蓝绿部署。

何时可以使用流量镜像? 流量镜像可用于蓝绿部署策略,或作为 Canary 发布的前置阶段。流量镜像会复制每个传入请求,将一个请求发送到主服务,另一个发送到 Canary 服务。流量镜像应仅用于幂等请求或可被处理两次的请求(一次由主服务处理,一次由 Canary 服务处理)。

如何重试失败的发布? Canary 分析由以下任一对象变更触发: Deployment/DaemonSet PodSpec(元数据、容器镜像、命令、端口、环境变量、资源等) 挂载为卷或映射为环境变量的 ConfigMaps 挂载为卷或映射为环境变量的 Secrets 要重试发布,可以在 Pod 模板中添加或更改注解:

未使用 HPA 时如何更改部署副本数? 在未使用 HPA 的情况下更改部署副本数时,你需要更新 Canary 部署为期望的副本数,并通过注解模板触发分析。分析完成后,Flagger 将 `spec.replicas` 的变更提升为主部署。

示例:

为何在禁用分析期间,Canary 初始化过程会有宕机窗口? 当分析被禁用时,存在宕机窗口是预期行为。这允许即时回滚,并模拟 Kubernetes 部署初始化的工作方式。要避免这一点,请启用分析(`skipAnalysis: false`),等待初始化完成,然后再禁用它(`skipAnalysis: true`)。

如何禁用跨命名空间引用? 默认情况下,Flagger 可以访问跨命名空间的资源(AlertProvider、MetricProvider 和 Gloo Upstream)。如果你处于多租户环境并希望禁用此功能,可以通过 `no-cross-namespace-refs` 标志实现。

Kubernetes 服务

应用如何在集群内部暴露? 假设应用名称为 podinfo,你可以定义一个 Canary: 如果未指定 `service.name`,则使用 `targetRef.name` 作为 apex 域名以及 canary/primary 服务名称前缀。应将服务名称视为不可变字段;更改它可能导致路由冲突。

基于 Canary 规范中的 service,Flagger 生成以下 Kubernetes ClusterIP 服务: `..svc.cluster.local`,selector `app=-primary` `-primary..svc.cluster.local`,selector `app=-primary` `-canary..svc.cluster.local`,selector `app=`

这确保了来自网格外部命名空间的发往 `podinfo.test:9898` 的流量将路由到你应用最新稳定版本。 地址 `podinfo-canary.test:9898` 仅在 Canary 分析期间可用,可用于一致性测试或负载测试。

多端口

我的应用监听多个端口。如何在集群内部暴露它们? 如果启用了端口发现,Flagger 会扫描部署规范并提取容器端口(排除 Canary 服务中指定的端口和 Envoy sidecar 端口)。这些端口将在生成 ClusterIP 服务时使用。 对于一个暴露两个端口的部署: 你可以启用端口发现,以便 Prometheus 能够通过 mTLS 访问端口 9090: 端口 8080 和 9090 都将添加到 ClusterIP 服务中。

标签选择器

Flagger 支持哪些标签选择器? 目标部署必须具有单个标签选择器,格式为 `app: `: 除了 `app`,Flagger 还支持 `name` 和 `app.kubernetes.io/name` 选择器。如果你使用不同的约定,可以通过 `-selector-labels` 标志指定你的标签。例如:

是否支持 Pod 亲和和反亲和? Flagger 在创建或更新主部署时,会重写目标部署中定义的 Pod 反亲和性和拓扑分布约束中的每个匹配表达式的第一个值,满足以下两个要求: 匹配表达式中的键必须是参数 `selector-labels` 指定的标签之一。默认标签为 `app`, `name`, `app.kubernetes.io/name`。 值必须与目标部署名称匹配。 Flagger 在这些情况下的重写操作是在值后添加 `-primary` 后缀。此重写可用于将 Canary 和主部署创建的 Pod 分散到不同的可用区。

示例目标部署: 生成的主部署示例: 也可以使用不同于 `app`、`name` 或 `app.kubernetes.io/name` 的标签。

反亲和示例(使用不同的标签):

指标

Flagger 如何衡量请求成功率和耗时? 默认情况下,Flagger 使用 Prometheus 查询来衡量请求成功率和耗时。

HTTP 请求成功率百分比 规范: Istio 查询: Envoy 查询(App Mesh): Envoy 查询(Contour 和 Gloo):

HTTP 请求毫秒耗时 P99 规范: Istio 查询: Envoy 查询(App Mesh、Contour 和 Gloo): 请注意,指标间隔应小于或等于控制循环间隔。

我可以使用自定义指标吗? 分析可以通过 Prometheus、Datadog、AWS CloudWatch、New Relic 和 Graphite 提供的指标进行扩展。有关如何使用自定义指标的详细信息,请参阅指标文档。

Istio Gateway API

如果你使用的是带 Gateway API 的 Istio,Prometheus 查询需要包含 `reporter="source"`。例如,计算 HTTP 请求错误率的查询如下:

Istio 路由

Flagger 如何与 Istio 交互? Flagger 基于 Canary 服务规范创建 Istio Virtual Service 和 Destination Rule。服务配置允许你在网格内部或外部暴露应用。你还可以定义流量策略、HTTP 匹配条件、URI 重写规则、CORS 策略、超时和重试。

以下规范在网格内部的 `frontend.test.svc.cluster.local:9898` 和网格外部的 `frontend.example.com` 暴露前端工作负载。你需要为外部主机指定一个 Istio 入口网关。

对于上述规范,Flagger 将生成如下虚拟服务: 为虚拟服务中的每个目标生成一条规则: Flagger 保持虚拟服务和目标规则与 Canary 服务规范同步。对虚拟服务规范的直接修改将被覆盖。

要在网格内部的 `http://backend.test.svc.cluster.local:9898` 暴露工作负载,服务规范可以仅包含容器端口和流量策略: 基于上述规范,Flagger 将创建多个 ClusterIP 服务,例如: Flagger 适用于通过入口网关在集群外部暴露的用户面向应用,以及仅在网格内部可访问的后端 HTTP API。

如果启用了委托(Delegation),Flagger 将生成不带 hosts 和 gateway 的 Istio VirtualService,使服务与 Istio 委托兼容。 基于上述规范,Flagger 将创建如下虚拟服务: 因此,以下虚拟服务将流量转发到由上述委托 VirtualService 处理的 `/podinfo`。 请注意,pilot 环境变量 `PILOT_ENABLE_VIRTUAL_SERVICE_DELEGATE` 也必须设置。关于 Istio 委托的使用,请参阅 Virtual Service 和 pilot 环境变量的文档。

Istio 入口网关

我如何在同一外部域名上暴露多个 Canary? 假设你有两个应用——一个提供主网站服务,另一个提供其 REST API——你可以为每个应用定义一个 Canary 对象: 基于上述配置,Flagger 将创建两个绑定到同一入口网关和外部主机的虚拟服务。Istio Pilot 将合并这两个服务,并且在合并后的配置中,网站规则会被移动到列表末尾。 请注意,主机合并仅在 Canary 绑定到除了网格网关以外的入口网关时有效。

Istio 双向 TLS

我如何为 Canary 启用 mTLS? 当部署启用了全局 mTLS 的 Istio 时,你必须将 TLS 模式设置为 `ISTIO_MUTUAL`: 如果你在 permissive 模式下运行 Istio,你可以禁用 TLS: 如果 Flagger 在网格外部,它如何启动负载测试? 为了让 Flagger 能够从网格外部调用负载测试器服务,你需要禁用 mTLS:

ExternalDNS

我可以使用注解吗? Flagger 将注解(和标签)传播到所有生成的 apex、primary 和 canary 对象。这使得使用 external-dns 注解成为可能。 你可以配置 Flagger 设置注解:

多个源和 Istio

注意!apex 注解被添加到生成的 Kubernetes Services 和生成的 Istio VirtualServices 对象中。如果你配置 external-dns 使用这两个源,这将产生冲突! 请参阅 ExternalDNS 文档

上一篇:介绍 下一篇:在 Kubernetes 上安装 Flagger 最后更新于 2 年前

评论 (0)