metallb
MetalLB bare-metal load balancer: L2 mode configuration, IP pool management, L2Advertisement, and troubleshooting on K3s clusters.
SKILL.md.agents/skills/metallb/SKILL.md
GitHubMetalLB Skill
OBSOLETE — MetalLB has been removed from this cluster.
MetalLB was replaced by Cilium LB-IPAM + L2 Announcements due to a fundamental incompatibility: MetalLB requires the
kubernetes.io/service-namelabel on EndpointSlices to elect a node for L2 announcements. Cilium's Gateway API creates EndpointSlices without this label, so MetalLB's speaker never announced the Gateway IPs via ARP, making the Gateway unreachable.See the cilium skill for the replacement implementation. See
roles/install-cilium-pools/for the newCiliumLoadBalancerIPPoolandCiliumL2AnnouncementPolicyresources.The
install-metallbrole still exists on disk but is no longer included inplaybooks/bootstrap.yml.
Quick Reference: Annotation Migration
| Old (MetalLB) | New (Cilium LB-IPAM) |
|---|---|
metallb.universe.tf/loadBalancerIPs: "x.x.x.x" |
lbipam.cilium.io/ips: "x.x.x.x" |
metallb.universe.tf/allow-shared-ip: "key" |
lbipam.cilium.io/sharing-key: "key" |
externalTrafficPolicy: Local |
externalTrafficPolicy: Cluster (required) |