Traefik 与采用 Gateway API 的 Kubernetes¶

Kubernetes Gateway 提供者是 Traefik 对 Kubernetes 特别兴趣小组（SIG）制定的 Gateway API 规范的实现。

该提供者支持 Gateway API 规范的 Standard 版本 v1.6.3。

它完整支持 HTTPRoute 的所有核心功能及部分扩展功能，例如来自 Standard 通道的 BackendTLSPolicy、GRPCRoute 和 TLSRoute 资源，以及来自 Experimental 通道的 TCPRoute。

更多详情请参阅符合性报告。

要求¶

Traefik 遵循 Kubernetes 支持策略， 至少支持 Kubernetes 最新的三个次要版本。 对于更旧的版本，无法保证基本功能正常运行。

1. 安装或更新 Kubernetes Gateway API CRD。

   # Install Gateway API CRDs from the Standard channel.
   kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.6.3/standard-install.yaml

   experimentalChannel 需要 Experimental 通道 CRD

   experimentalChannel 选项会让 Traefik 监听 TCPRoute 和 TLSRoute 资源，而 Standard 通道 CRD 不提供这些资源。如果未安装 Experimental 通道 CRD（experimental-install.yaml）就启用该选项，Kubernetes Gateway 提供者将无法启动：所有 Gateway API 资源都无法提供服务，而不只是 TCPRoute 和 TLSRoute。Traefik 会继续运行，其他提供者也不受影响。

2. 如果未使用 Helm Chart，请安装或更新 Gateway API 所需的 Traefik RBAC。

   # Install Traefik RBACs for Gateway API.
   kubectl apply -f https://raw.githubusercontent.com/traefik/traefik/v3.7/docs/content/reference/dynamic-configuration/kubernetes-gateway-rbac.yml

配置示例¶

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

providers:
  kubernetesGateway: {}
  # ...

[providers.kubernetesGateway]
# ...

--providers.kubernetesgateway=true

## Values file
providers:
  kubernetesGateway:
    enabled: true

配置选项¶

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:
  kubernetesGateway:
    endpoint: "http://localhost:8080"
    # ...

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

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

路由配置¶

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