MetalLB使用注意事项：避免节点IP冲突导致NotReady状态

在Kubernetes集群中使用MetalLB作为负载均衡器时，一个常见的配置错误是直接将节点的公网IP地址分配给LoadBalancer服务。这种情况会导致节点进入NotReady状态，严重影响集群稳定性。

问题现象分析

当用户将MetalLB的IP地址池配置为节点的公网IP地址时，创建LoadBalancer服务后会出现以下典型症状：

1. 服务能够成功分配指定的节点IP地址
2. 约40秒后，对应节点状态变为NotReady
3. 删除服务后，节点立即恢复Ready状态
4. 节点NotReady期间无法访问控制平面服务

根本原因

这种问题的根本原因在于IP地址冲突。MetalLB在L2模式下工作时：

1. 会响应ARP请求，宣告自己拥有该IP地址
2. 同时节点本身也拥有该IP地址
3. 这导致网络流量被错误路由，节点与控制平面的通信中断
4. Kubernetes检测到节点不可达后将其标记为NotReady

正确配置建议

为避免此类问题，应当遵循以下MetalLB配置原则：

1. 专用IP地址池：为MetalLB分配专用于负载均衡的IP地址段，这些地址不应与任何节点地址重叠
2. 子网内IP（L2模式）：如果使用L2模式，确保分配的IP地址与节点在同一子网内
3. 避免节点IP：绝对不要将节点当前使用的任何IP地址（包括公网IP、内网IP）放入MetalLB的地址池

解决方案

对于已经出现问题的集群，可以采取以下步骤恢复：

1. 立即删除使用节点IP的LoadBalancer服务
2. 修改MetalLB的IPAddressPool配置，移除节点IP
3. 重新创建服务，使用正确的IP地址

未来改进

MetalLB开发团队已经意识到这个常见配置错误，正在开发验证机制来防止用户将节点IP分配给LoadBalancer服务。这将帮助用户在配置阶段就发现问题，而不是在运行时才暴露问题。

总结

正确配置MetalLB的关键在于理解其网络工作原理，特别是IP地址管理的部分。通过为负载均衡服务分配专用IP地址，可以避免与节点网络产生冲突，确保集群稳定运行。对于生产环境，建议事先规划好IP地址分配方案，将节点网络与负载均衡网络明确分离。