Hetzner-k3s项目中负载均衡器未添加目标节点的排查与解决

问题背景

在使用hetzner-k3s项目部署Kubernetes集群时，用户遇到了一个常见问题：创建的Hetzner负载均衡器(LB)未能自动添加目标节点，状态一直显示为0个目标。这种情况通常发生在集群配置变更后，特别是当网络设置调整时。

关键配置分析

从用户提供的配置文件中，我们可以发现几个关键点：

1. 用户禁用了私有网络(private_network.enabled: false)
2. 在ingress-nginx的注解中却设置了load-balancer.hetzner.cloud/use-private-ip: "true"
3. 集群使用了3个master节点和1个自动扩展的worker节点池

根本原因

问题的核心矛盾在于网络配置的不一致性。当用户禁用了私有网络(private_network.enabled: false)后，负载均衡器实际上无法通过私有IP与节点通信，但同时又配置了要求使用私有IP(use-private-ip: "true")，这导致了负载均衡器无法正确添加目标节点。

解决方案

要解决这个问题，需要确保网络配置的一致性：

1. 方案一：启用私有网络

   • 将private_network.enabled设为true
   • 保持use-private-ip: "true"不变
   • 这种配置下，负载均衡器将通过私有网络与节点通信

2. 方案二：禁用私有网络

   • 保持private_network.enabled为false
   • 将use-private-ip改为"false"或完全移除该注解
   • 这种配置下，负载均衡器将通过公网与节点通信

注意事项

1. 手动修改负载均衡器配置是无效的，因为Kubernetes的云控制器管理器(CCM)会定期协调实际状态与期望状态，覆盖手动修改。

2. 网络配置变更后，建议重建负载均衡器相关资源以确保配置完全生效。

3. 对于生产环境，通常推荐启用私有网络并使用私有IP通信，这可以提高安全性并减少公网带宽消耗。

最佳实践建议

1. 在修改网络配置前，充分理解各配置项的含义和相互关系。

2. 使用配置版本控制，便于追踪变更和回滚。

3. 在变更网络配置后，监控负载均衡器和节点的连接状态。

4. 对于关键业务集群，建议先在测试环境验证配置变更。

通过理解这些网络配置的相互关系，用户可以更有效地管理hetzner-k3s集群的网络架构，确保负载均衡器等关键组件正常工作。