Traefik 与 Kubernetes¶

Traefik Kubernetes Ingress 提供者是一个 Kubernetes Ingress 控制器；也就是说，它通过支持 Ingress 规范管理对集群服务的访问。

配置示例¶

可以按以下方式启用 kubernetesIngress 提供者：

providers:
  kubernetesIngress: {}

[providers.kubernetesIngress]

--providers.kubernetesingress=true

## Values file
providers:
  kubernetesIngress:
    enabled: true

随后，该提供者监听传入的 Ingress 事件（如下例所示），并据此生成相应的动态配置，进而创建最终的路由器、服务、处理器等。

配置选项¶

endpoint¶

Kubernetes 服务器的端点 URL。

部署到 Kubernetes 中时，Traefik 会读取环境变量 KUBERNETES_SERVICE_HOST 和 KUBERNETES_SERVICE_PORT，或 KUBECONFIG，以构造端点。

访问令牌从 /var/run/secrets/kubernetes.io/serviceaccount/token 读取，SSL CA 证书从 /var/run/secrets/kubernetes.io/serviceaccount/ca.crt 读取。部署在 Kubernetes 内部时，两者都会自动挂载。

可以指定端点，以覆盖集群内环境变量的值。

找不到环境变量时，Traefik 会尝试使用集群外客户端连接 Kubernetes API 服务器。

这种情况下必须指定端点。具体而言，可以将其设置为 kubectl proxy 使用的 URL，以使用关联 kubeconfig 授予的身份认证和授权连接 Kubernetes 集群。

providers:
  kubernetesIngress:
    endpoint: "http://localhost:8080"
    # ...

[providers.kubernetesIngress]
  endpoint = "http://localhost:8080"
  # ...

--providers.kubernetesingress.endpoint=http://localhost:8080

ingressEndpoint.publishedService¶

格式：namespace/servicename。

要从中复制状态的 Kubernetes 服务，其行为取决于服务类型：

• ClusterIP： 服务的 ExternalIPs 会传播至 Ingress 状态。
• NodePort： 集群节点的 ExternalIP 地址会传播至 Ingress 状态。
• LoadBalancer： 服务的 loadBalancer.status 字段中的 IP（即负载均衡器提供的端点）会传播至 Ingress 状态。
• ExternalName： 服务的 spec.externalName 字段中的主机名会传播至 Ingress 状态。

使用 External-DNS 等第三方工具时，此选项允许将服务的外部 IP 复制到 Ingress 资源。

providers:
  kubernetesIngress:
    ingressEndpoint:
      publishedService: "namespace/foo-service"
    # ...

[providers.kubernetesIngress.ingressEndpoint]
  publishedService = "namespace/foo-service"
  # ...

--providers.kubernetesingress.ingressendpoint.publishedservice=namespace/foo-service

路由配置¶

请参阅路由中的专门章节。

延伸阅读¶

要进一步了解 Traefik 支持的 Ingress 规范的各个方面，可查看 Traefik 仓库测试示例中的大量 Ingress 定义示例。