在kube-hetzner项目中解决Nginx Ingress控制器创建多余负载均衡器的问题

在使用kube-hetzner项目部署Kubernetes集群时，用户可能会遇到一个常见问题：Nginx Ingress控制器意外创建了额外的Hetzner负载均衡器。本文将深入分析这一现象的原因，并提供解决方案。

问题现象分析

当用户选择Nginx作为Ingress控制器时，系统会默认创建一个负载均衡器。然而，某些配置可能导致创建第二个不必要的负载均衡器。这通常表现为：

1. 在Hetzner控制台中看到两个负载均衡器实例
2. 其中一个负载均衡器处于空闲状态，未被实际使用
3. 资源浪费和额外成本产生

根本原因

问题的根源在于Nginx Ingress控制器的Helm配置中关于负载均衡器的注解设置。具体来说，当使用以下配置时会出现问题：

controller:
  service:
    annotations:
      "load-balancer.hetzner.cloud/name": "k3s"

这里的关键点是负载均衡器名称"k3s"与kube-hetzner项目默认创建的负载均衡器名称冲突。Hetzner云平台会将其视为一个新的负载均衡器请求，从而创建第二个实例。

解决方案

要解决这个问题，我们需要修改Nginx Ingress控制器的Helm values配置，确保负载均衡器名称唯一且不与系统默认值冲突。以下是推荐的配置修改：

controller:
  watchIngressWithoutClass: "true"
  config:
    "use-forwarded-headers": "true"
    "compute-full-forwarded-for": "true"
    "use-proxy-protocol": "true"
  service:
    annotations:
      "load-balancer.hetzner.cloud/name": "k3s-nginx"  # 修改名称使其唯一
      "load-balancer.hetzner.cloud/use-private-ip": "true"
      "load-balancer.hetzner.cloud/disable-private-ingress": "true"
      "load-balancer.hetzner.cloud/location": "nbg1"
      "load-balancer.hetzner.cloud/type": "lb11"
      "load-balancer.hetzner.cloud/uses-proxyprotocol": "true"

关键修改点是将load-balancer.hetzner.cloud/name的值从"k3s"改为"k3s-nginx"或其他唯一名称。

实施建议

1. 新集群部署：在创建新集群时直接使用上述修改后的配置

2. 现有集群更新：

   • 修改配置后重新部署Nginx Ingress控制器
   • 观察Hetzner控制台，确认多余的负载均衡器被自动清理
   • 如果自动清理未发生，可手动删除未使用的负载均衡器

3. 验证步骤：

   • 检查Ingress服务是否正常工作
   • 确认Hetzner控制台中只有一个活动的负载均衡器
   • 监控流量是否正常通过保留的负载均衡器

最佳实践

为避免类似问题，建议遵循以下原则：

1. 为每个服务组件使用独特的负载均衡器名称
2. 定期检查云平台资源使用情况
3. 在修改Ingress控制器配置前备份现有设置
4. 在非生产环境测试配置变更

通过以上调整，用户可以确保kube-hetzner项目正确管理负载均衡器资源，避免不必要的云资源消耗和成本增加。