Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Removed some awkward wording (issue #299) #600

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Removed some awkward wording (issue #299) #600

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2bfffb4
Removed some awkward wording (issue #299)
fsundermeyer Feb 26, 2025
fe3678f
Fixed wording (gear -> equipment)
fsundermeyer Feb 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions asciidoc/guides/metallb-k3s.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[#guides-metallb-k3s]
= MetalLB on K3s (using L2)
= MetalLB on K3s (using Layer 2 Mode)
:experimental:

ifdef::env-github[]
Expand All @@ -13,7 +13,7 @@ endif::[]

MetalLB is a load-balancer implementation for bare-metal Kubernetes clusters, using standard routing protocols.

In this guide, we demonstrate how to deploy MetalLB in layer 2 mode.
In this guide, we demonstrate how to deploy MetalLB in layer 2 (L2) mode.

== Why use this method

Expand All @@ -31,9 +31,9 @@ The major advantage of the layer 2 mode is its universality: it works on any Eth

== MetalLB on K3s (using L2)

In this quick start, L2 mode will be used, so it means we do not need any special network gear but just a couple of free IPs in our network range, ideally outside of the DHCP pool so they are not assigned.

In this example, our DHCP pool is `192.168.122.100-192.168.122.200` (yes, three IPs, see <<traefik-and-metallb,Traefik and MetalLB>> for the reason of the extra IP) for a `192.168.122.0/24` network, so anything outside this range is OK (besides the gateway and other hosts that can be already running!)
In this quick start, L2 mode will be used.
This means we do not need any special network equipment but three free IPs within
the network range.

== Prerequisites

Expand All @@ -45,7 +45,13 @@ K3S comes with its own service load balancer named Klipper. You https://metallb.
====

* Helm
* A couple of free IPs in our network range. In this case, `192.168.122.10-192.168.122.12`
* Three free IP adressess within the network range. In this example `192.168.122.10-192.168.122.12`

[IMPORTANT]
====
You must make sure these IP addresses are unassigned.
In a DHCP environment these addresses must not be part of the DHCP pool to avoid dual assignments.
====

== Deployment

Expand Down