c12s-kubespray/roles/kubernetes-apps/metallb
Kenichi Omichi 486b223e01
Replace kube-master with kube_control_plane (#7256)
This replaces kube-master with kube_control_plane because of [1]:

  The Kubernetes project is moving away from wording that is
  considered offensive. A new working group WG Naming was created
  to track this work, and the word "master" was declared as offensive.
  A proposal was formalized for replacing the word "master" with
  "control plane". This means it should be removed from source code,
  documentation, and user-facing configuration from Kubernetes and
  its sub-projects.

NOTE: The reason why this changes it to kube_control_plane not
      kube-control-plane is for valid group names on ansible.

[1]: https://github.com/kubernetes/enhancements/blob/master/keps/sig-cluster-lifecycle/kubeadm/2067-rename-master-label-taint/README.md#motivation
2021-03-23 17:26:05 -07:00
..
defaults MetalLB: bump to v0.9.6 (#7397) 2021-03-23 13:42:06 -07:00
tasks Replace kube-master with kube_control_plane (#7256) 2021-03-23 17:26:05 -07:00
templates Add nodeselector and tolerations for metallb (#7334) 2021-03-08 07:57:42 -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

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.