PKR-Lab

b0060 - MetalLB — LoadBalancer-Adresse für Traefik (nicht in GitOps)

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/b-kubernetes-gitops/b0060-metallb.md

MetalLB — LoadBalancer-Adresse für Traefik (nicht in GitOps)

MetalLB vergibt die LAN-Adresse 192.168.178.200 an den Traefik-Service (LoadBalancer), über die alle *.homeserver-Hosts im Heimnetz erreichbar sind. Die Installation liegt nicht im Repo, sondern wurde von Hand per Helm eingespielt. Dieses Doc hält den Ist-Zustand fest, damit er nach einem Neuaufbau reproduzierbar ist.

Cluster: TECH · Namespace metallb-system · kein Ordner unter argocd/apps/. kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).


Ist-Zustand (2026-10-18)

Merkmal Wert
Installation Helm-Release metallb, Chart metallb-0.16.1 (App v0.16.1) aus https://metallb.github.io/metallb, Revision 1 vom 2026-06-03, ohne eigene Values (USER-SUPPLIED VALUES: null)
Komponenten metallb-controller (Deployment), metallb-speaker (DaemonSet, 3 Nodes), metallb-frr-k8s (DaemonSet, 3 Nodes, hostNetwork), metallb-frr-k8s-statuscleaner (Deployment)
Modus Layer 2 (L2Advertisement homelab-l2), BGP wird nicht genutzt
Adresspool IPAddressPool homelab-pool: 192.168.178.200-192.168.178.210, autoAssign: true
Genutzte Adressen eine: 192.168.178.200 für kube-system/traefik
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
  name: homelab-pool
  namespace: metallb-system
spec:
  addresses:
    - 192.168.178.200-192.168.178.210
  autoAssign: true
---
apiVersion: metallb.io/v1beta1
kind: L2Advertisement
metadata:
  name: homelab-l2
  namespace: metallb-system
spec:
  ipAddressPools:
    - homelab-pool

Neuaufbau

helm repo add metallb https://metallb.github.io/metallb
helm install metallb metallb/metallb --version 0.16.1 --namespace metallb-system --create-namespace
kubectl apply -f - <<'YAML'
(IPAddressPool und L2Advertisement von oben)
YAML

Prüfen: kubectl -n metallb-system get pods, kubectl -n kube-system get svc traefik (EXTERNAL-IP 192.168.178.200), curl -sk https://192.168.178.200/ -o /dev/null -w '%{http_code}\n' (Traefik antwortet ohne passenden Host mit 404, das genügt als Lebenszeichen)`.


Auffälligkeiten


Übernahme in GitOps (vorbereitet, noch nicht ausgeführt)

Das Wrapper-Chart argocd/pending/metallb-system/ enthält das Subchart metallb 0.16.1 (vendort), fullnameOverride: metallb (die Objektnamen bleiben wie in der Handinstallation), den Pool homelab-pool und die L2Advertisement und schaltet FRR ab (metallb.frrk8s.enabled: false): Im Layer-2-Modus wird es nicht gebraucht, es hat die hohen Neustartzahlen und den offenen Port 2623 verursacht (Incident 038). Der Verzeichnisname ist zugleich der Namespace (metallb-system) und der Name der ArgoCD-Application.

Warum nicht einfach anwenden: ArgoCD nutzt den Application-Namen metallb-system als Helm-Release-Namen, das Label app.kubernetes.io/instance der vorhandenen Deployments und DaemonSets steht aber auf metallb. Selektoren sind unveränderlich, ein Sync über die bestehenden Workloads scheitert. Die Workloads müssen deshalb vorher gelöscht werden. Nicht helm uninstall: Die 13 MetalLB-CRDs sind Teil des Helm-Releases (Subchart crds), ein Uninstall würde sie und damit IPAddressPool und L2Advertisement mit löschen.

Ablauf (ruhiges Zeitfenster; der Pfad zu den Diensten läuft über den Homeserver 192.168.178.94, nicht über .200, ein Ausfall betrifft deshalb nur die Adresse .200 selbst):

  1. Rolle rendern: make render-bootstrap CORE_DIR=<Pfad zu capulus-core> (Vault-Passwort). Die Vorlage bootstrap-appprojects.yaml.j2 enthält metallb-system schon als festes Ziel im Projekt tech (wie cert-manager, ohne tier-default-ingress-NetworkPolicy); das Ergebnis argocd/bootstrap/projects.yaml committen und im Hub anwenden (kubectl apply -f argocd/bootstrap/projects.yaml).
  2. Sicherung: kubectl get ipaddresspool,l2advertisement -n metallb-system -o yaml > metallb-crs-backup.yaml.
  3. Nur die Workloads löschen: kubectl -n metallb-system delete deployment metallb-controller metallb-frr-k8s-statuscleaner && kubectl -n metallb-system delete daemonset metallb-speaker metallb-frr-k8s. CRDs, RBAC, Services, Webhooks und die beiden Objekte bleiben.
  4. git mv argocd/pending/metallb-system argocd/apps/tech/metallb-system, committen, mergen. ArgoCD legt die Application an, übernimmt die vorhandenen Objekte und erstellt Controller und Speaker neu (ohne FRR).
  5. Prüfen: kubectl -n metallb-system get pods (nur metallb-controller und metallb-speaker je Node, keine frr-k8s), kubectl -n kube-system get svc traefik (EXTERNAL-IP 192.168.178.200), curl -sk https://192.168.178.200/ -o /dev/null -w '%{http_code}\n' (404), auf den Nodes ss -ltn | grep 2623 (leer). Danach den alten Helm-Release-Eintrag entfernen: kubectl -n metallb-system delete secret -l owner=helm,name=metallb (entfernt nur die Release-Verwaltung, keine Objekte).
  6. Rollback: Verzeichnis zurück nach argocd/pending/ (oder Revert), dann helm upgrade metallb metallb/metallb --version 0.16.1 -n metallb-system (solange der Release-Eintrag noch existiert) bzw. helm install … --take-ownership und kubectl apply -f metallb-crs-backup.yaml, falls Pool oder Advertisement fehlen.

Fehlersuche

kubectl -n metallb-system get pods -o wide
kubectl -n metallb-system get ipaddresspool,l2advertisement
kubectl -n kube-system get svc traefik                        # EXTERNAL-IP muss 192.168.178.200 sein
kubectl -n metallb-system logs ds/metallb-speaker --tail=50
curl -sk https://192.168.178.200/ -o /dev/null -w '%{http_code}\n'
Symptom Ursache Lösung
EXTERNAL-IP des Traefik-Service ist <pending> Controller nicht bereit, Pool oder Advertisement fehlt, Pool erschöpft kubectl -n metallb-system get pods, die beiden Objekte aus „Ist-Zustand“ erneut anwenden
192.168.178.200 antwortet im LAN nicht Speaker kündigt die Adresse nicht an (ARP), Fritz!Box-Cache, Node-Interface kubectl -n metallb-system logs ds/metallb-speaker, arping -I <if> 192.168.178.200 von einem LAN-Gerät, Fritz!Box ARP-Eintrag prüfen
*.homeserver nur über den Homeserver .94, nicht über .200 erreichbar MetalLB-Adresse nicht aktiv siehe oben. Die Dienste selbst laufen über .94, nur .200 fällt aus
IPAddressPool lässt sich nicht ändern (Webhook-Fehler) metallb-controller ausgefallen Controller wiederherstellen, kubectl -n metallb-system get pods
Nach dem Neuaufbau fehlen Pool und Advertisement Objekte sind nicht im GitOps Abschnitt „Neuaufbau“ ausführen
FRR-Pods zeigen CrashLoopBackOff frr-k8s wird im Layer-2-Modus nicht gebraucht, braucht aber Rechte siehe „Auffälligkeiten“ und die geplante Übernahme ohne FRR
Übernahme in GitOps zeigt OutOfSync/Konflikte bei Labels Release-Name metallb ≠ Application-Name metallb-system Ablauf in „Übernahme in GitOps“ beachten

Allgemeine Fehlersuche: zentrale Fehlersuche.