Argo Rollouts 与 Traefik 3.0 集成问题解析与解决方案

背景介绍

在 Kubernetes 生态系统中，Argo Rollouts 是一个强大的渐进式交付工具，而 Traefik 则是流行的云原生边缘路由器。随着 Traefik 3.0 的发布，其 API 组从 traefik.containo.us 迁移到了 traefik.io，这导致了一些集成问题。

问题现象

当用户尝试在 Argo Rollouts 中使用 Traefik 3.0 的 TraefikService 资源（API 版本为 traefik.io/v1alpha1）时，Argo Rollouts 控制器会报错，提示找不到 traefikservices.traefik.containo.us 资源。这是因为控制器默认仍然使用旧的 API 组进行查找。

根本原因

Argo Rollouts 控制器内部硬编码了 Traefik 资源的默认 API 组和版本：

• 默认 API 组：traefik.containo.us
• 默认 API 版本：traefik.containo.us/v1alpha1

这与 Traefik 3.0 的新 API 结构不兼容，导致控制器无法正确识别和操作新的 TraefikService 资源。

解决方案

从 Argo Rollouts 1.7.2 版本开始，可以通过以下配置参数来解决此问题：

Helm 安装方式

在 Helm values 文件中添加以下配置：

controller:
  extraArgs:
    - "--traefik-api-group=traefik.io"
    - "--traefik-api-version=traefik.io/v1alpha1"

Terraform 安装方式

resource "helm_release" "argo_rollouts" {
  values = [yamlencode({
    controller = {
      extraArgs = [
        "--traefik-api-group=traefik.io",
        "--traefik-api-version=traefik.io/v1alpha1"
      ]
    }
  })]
}

手动部署方式

如果是直接使用 Deployment 部署，可以在容器的 args 部分添加：

args:
  - --traefik-api-group=traefik.io
  - --traefik-api-version=traefik.io/v1alpha1

验证配置

配置完成后，可以创建以下资源进行测试：

1. TraefikService 资源定义：

apiVersion: traefik.io/v1alpha1
kind: TraefikService
metadata:
  name: my-traefik-service
spec:
  weighted:
    services:
    - name: stable-service
      port: 80
    - name: canary-service
      port: 80

2. Argo Rollouts 资源定义：

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: example-rollout
spec:
  strategy:
    canary:
      trafficRouting:
        traefik:
          weightedTraefikServiceName: my-traefik-service

权限配置

确保 Argo Rollouts 的服务账户具有正确的 RBAC 权限：

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: argo-rollouts-traefik
rules:
- apiGroups: ["traefik.io"]
  resources: ["traefikservices"]
  verbs: ["get", "list", "watch", "update", "patch"]

常见问题排查

1. 服务找不到错误：确认已正确设置 API 组和版本参数
2. 权限不足错误：检查服务账户是否有足够的权限操作 traefik.io API 组下的资源
3. 版本兼容性：确保使用的 Argo Rollouts 版本至少为 1.7.2

最佳实践

1. 始终明确指定 Traefik 的 API 组和版本
2. 在升级 Traefik 时，同步检查 Argo Rollouts 的兼容性
3. 在生产环境部署前，先在测试环境验证配置
4. 监控控制器日志，确保没有资源查找错误

通过以上配置和注意事项，可以确保 Argo Rollouts 与 Traefik 3.0 及以上版本无缝集成，实现平滑的渐进式交付流程。