History

Samuel Liu 65fafae2c5 format ansible output (#7482 ) (cherry picked from commit `90c643f3ab`)		2021-04-21 00:16:10 -07:00
..
defaults	Improve metallb template for bgp peers (#6574 )	2020-08-26 23:15:03 -07:00
tasks	format ansible output (#7482 )	2021-04-21 00:16:10 -07:00
templates	change nodeSelector label from deprecated beta.kubernetes.io/os and arch to kubernetes.io prefix (#7138 )	2021-01-13 13:55:02 -08:00
OWNERS	Add oomichi to reviwers of MetalLB addon (#6393 )	2020-07-14 20:44:37 -07:00
README.md	Fix markdownlint failures under ./roles/ (#7089 )	2020-12-30 05:07:49 -08:00

README.md

Deploy MetalLB into Kubespray/Kubernetes

MetalLB hooks into your Kubernetes cluster, and provides a network load-balancer implementation. In short, 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 paid products to provide load-balancers. This addon aims to automate MetalLB in layer 2 mode or MetalLB in BGP mode. It deploys MetalLB into Kubernetes and sets up a layer 2 or BGP load-balancer.

Install

In the default, MetalLB is not deployed into your Kubernetes cluster. You can override the defaults by copying the contents of roles/kubernetes-apps/metallb/defaults/main.yml to somewhere in inventory/mycluster/group_vars such as inventory/mycluster/groups_vars/k8s-cluster/addons.yml and updating metallb_enabled option to true. In addition you need to update metallb_ip_range option on the addons.yml at least for suiting your network environment, because MetalLB allocates external IP addresses from this metallb_ip_range option.