Terraform部署Hetzner K8s集群时Traefik配置语法更新指南

在使用Terraform部署Hetzner Kubernetes集群时，Traefik作为默认的Ingress控制器，其Helm Chart在v34版本中进行了重大语法变更。本文详细解析新旧配置差异及解决方案。

问题背景

在kube-hetzner项目中，当用户通过Terraform部署Kubernetes集群时，系统会自动安装Traefik作为入口控制器。近期Traefik Helm Chart升级至v34版本后，原有的HTTP到HTTPS重定向配置语法发生了不兼容变更。

新旧语法对比

旧版配置语法（已废弃）

ports:
  web:
    redirectTo:
      port: websecure

新版配置语法

web:
  redirections:
    entryPoint:
      to: websecure
      scheme: https
      permanent: true

影响范围

使用旧版配置会导致Traefik Pod进入CrashLoopBackOff状态，查看日志可见明确错误提示：

ERROR: redirectTo syntax has been removed in v34 of this Chart

解决方案

1. 修改kube.tf配置

在Terraform配置文件中，应将Traefik的values配置更新为：

traefik_values = <<EOT
deployment:
  kind: DaemonSet
ports:
  web:
    redirections:
      entryPoint:
        to: websecure
        scheme: https
        permanent: true
  websecure:
    proxyProtocol:
      trustedIPs:     
        - 127.0.0.1/32
        - 10.0.0.0/8
EOT

2. 配置验证要点

1. 重定向配置：确保使用新的redirections语法
2. 代理协议：保留原有的trustedIPs设置以保证内部通信安全
3. 服务类型：建议保持LoadBalancer类型以利用Hetzner LB服务

最佳实践建议

1. 版本兼容性检查：部署前确认Traefik Chart版本
2. 配置验证：使用helm template命令预渲染模板验证语法
3. 渐进式升级：生产环境建议先测试再全量部署

技术原理

Traefik v34的这次变更主要是为了：

• 统一配置语法风格
• 提供更灵活的重定向选项
• 简化端口映射逻辑

新的redirections语法不仅支持HTTPS重定向，还可以配置：

• 重定向状态码（permanent参数）
• 目标协议（scheme参数）
• 多入口点路由

总结

随着云原生技术的快速发展，基础设施工具的配置语法也在不断演进。kube-hetzner项目作为优秀的Hetzner云Kubernetes部署方案，及时跟进这些变更对保证集群稳定性至关重要。建议用户在部署时始终参考对应版本的最新文档，并建立配置版本管理机制。