MetalLB在TalosOS上的部署问题与解决方案

前言

MetalLB作为Kubernetes原生的负载均衡器实现，在裸金属环境中发挥着重要作用。本文将详细分析MetalLB在TalosOS环境中的典型部署问题，并提供完整的解决方案。

问题现象

在TalosOS v1.9.3环境中部署MetalLB v0.14.9后，虽然服务能够成功获取外部IP地址，但实际无法通过该IP访问服务。具体表现为：

1. 服务状态显示已分配外部IP
2. ARP表中IP地址状态为"incomplete"
3. 直接访问节点IP可以成功，但通过MetalLB分配的IP失败

根本原因分析

经过深入排查，发现该问题由以下几个因素共同导致：

1. TalOS默认配置限制：TalOS控制平面节点默认带有node.kubernetes.io/exclude-from-external-load-balancers标签，阻止MetalLB在这些节点上运行

2. 调度限制：TalOS默认不允许在控制平面节点上调度工作负载

3. 权限问题：MetalLB需要特权模式运行，而TalOS的默认安全策略会阻止

完整解决方案

1. 允许控制平面节点调度工作负载

修改TalOS配置，添加以下内容：

cluster:
    allowSchedulingOnControlPlanes: true

2. 移除负载均衡排除标签

有两种方式处理排除标签：

方法一：通过TalOS配置移除

machine:
    nodeLabels:
        node.kubernetes.io/exclude-from-external-load-balancers:
            $patch: delete

方法二：配置MetalLB忽略排除标签

在Helm安装MetalLB时添加参数：

speaker:
  ignoreExcludeLB: true

3. 解决权限问题

方法一：完全禁用准入控制

生成TalOS配置时添加参数：

--config-patch-control-plane '[{"op": "remove", "path": "/cluster/apiServer/admissionControl"}]'

方法二：为MetalLB创建特权命名空间

apiVersion: v1
kind: Namespace
metadata:
  name: metallb-system
  labels:
    pod-security.kubernetes.io/audit: privileged
    pod-security.kubernetes.io/enforce: privileged
    pod-security.kubernetes.io/warn: privileged

常见误区

1. 端口使用错误：MetalLB使用服务端口而非NodePort端口，确保访问的是服务端口(如80)而非NodePort(如31000)

2. IP池配置问题：确保分配的IP地址在本地网络中是可达的，避免使用不可路由的子网

3. 网络接口选择：确认MetalLB配置了正确的网络接口名称

验证步骤

1. 检查节点标签：

   kubectl get nodes --show-labels
   

2. 验证服务状态：

   kubectl get svc -o wide
   

3. 测试连通性：

   curl http://<EXTERNAL-IP>:<SERVICE-PORT>
   

4. 检查ARP表：

   arp -an | grep <EXTERNAL-IP>
   

总结

在TalOS上部署MetalLB需要特别注意TalOS特有的安全限制和默认配置。通过正确配置调度策略、节点标签和权限设置，可以确保MetalLB在TalOS环境中正常工作。本文提供的解决方案已在生产环境验证，可帮助开发者快速解决类似问题。