3 MetalLB hooks into your Kubernetes cluster, and provides a network load-balancer implementation.
4 It allows you to create Kubernetes services of type "LoadBalancer" in clusters that don't run on a cloud provider, and thus cannot simply hook into 3rd party products to provide load-balancers.
5 The default operationg mode of MetalLB is in ["Layer2"](https://metallb.universe.tf/concepts/layer2/) but it can also operate in ["BGP"](https://metallb.universe.tf/concepts/bgp/) mode.
9 You have to configure arp_ignore and arp_announce to avoid answering ARP queries from kube-ipvs0 interface for MetalLB to work.
12 kube_proxy_strict_arp: true
17 You have to explicitly enable the MetalLB extension and set an IP address range from which to allocate LoadBalancer IPs.
21 metallb_speaker_enabled: true
22 metallb_avoid_buggy_ips: true
27 By default only the MetalLB BGP speaker is allowed to run on control plane nodes. If you have a single node cluster or a cluster where control plane are also worker nodes you may need to enable tolerations for the MetalLB controller:
30 metallb_controller_tolerations:
31 - key: "node-role.kubernetes.io/master"
35 - key: "node-role.kubernetes.io/control-plane"
43 When operating in BGP Mode MetalLB needs to have defined upstream peers:
50 - peer_address: 192.0.2.1
53 - peer_address: 192.0.2.2
58 Some upstream BGP peers may require password authentication:
65 - peer_address: 192.0.2.1
71 When using calico >= 3.18 you can replace MetalLB speaker by calico Service LoadBalancer IP advertisement.
72 See [calico service IPs advertisement documentation](https://docs.projectcalico.org/archive/v3.18/networking/advertise-service-ips#advertise-service-load-balancer-ip-addresses).
73 In this scenarion you should disable the MetalLB speaker and configure the `calico_advertise_service_loadbalancer_ips` to match your `metallb_ip_range`
76 metallb_speaker_enabled: false
77 metallb_avoid_buggy_ips: true
80 calico_advertise_service_loadbalancer_ips: "{{ metallb_ip_range }}"
83 If you have additional loadbalancer IP pool in `metallb_additional_address_pools` , ensure to add them to the list.
86 metallb_speaker_enabled: false
89 metallb_additional_address_pools:
101 avoid_buggy_ips: true
102 calico_advertise_service_loadbalancer_ips: