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 unterargocd/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
- Zwei Controller für den Service
traefik. Der Service isttype: LoadBalancerohneloadBalancerClass. Ihn bedienen k3s-ServiceLB (diesvclb-traefik-Pods binden die Host-Ports 80/443 auf jedem Node, Status-IPs192.168.178.94und.95) und MetalLB (Adresse.200). Der Status steht stabil auf.200, bei jedem k3s-Start wendet k3s das Traefik-Manifest neu an, ServiceLB schreibt die Node-IPs, MetalLB räumt sie weg. Das zeigen die EventsClearAssignment,UpdatedLoadBalancer [.200] -> [.94 .95],AdditionalAssignFailedundnolbIPsIPFamily. Sie sind Rauschen, der Dienst läuft. Der Weg im Heimnetz geht über.94: dnsmasq löst*.homeserverauf die Server-IP auf,.200wird im Alltag nicht benutzt. Die k3s-Doku kennt zum Beheben nur das clusterweitedisable: servicelb(pro Service ist ServiceLB nicht abschaltbar). Das nähme die Host-Ports 80/443 von.94und.95weg und verlangte vorher, DNS und alle Clients auf.200umzustellen. Deshalb bleibt der Zustand bis zu einer bewussten Umstellung bestehen. - FRR wird nicht gebraucht. Das Chart installiert
frr-k8sstandardmäßig mit, im Layer-2-Modus ohne BGP bleibt es ungenutzt. Es bringt aberhostNetwork, Container mitSYS_ADMIN,NET_ADMIN,NET_RAWund den offenen Port2623(FRR-mgmtd, „Vty password is not set“) auf jedem Node mit. Die FRR-Pods haben hohe Neustartzahlen (bis über 1000 in 135 Tagen). Abschalten:helm upgrade metallb metallb/metallb --version 0.16.1 -n metallb-system --set frrk8s.enabled=false. Das startet die Speaker neu; währenddessen kann die Adresse.200kurz nicht beantwortet werden (ARP-Wechsel), das heißt kurzer Ausfall aller Dienste über Traefik. Deshalb nur in einem ruhigen Zeitfenster. - Webhook:
metallb-webhook-serviceundfrr-k8s-webhook-servicegehören zu den Admission-Webhooks des Charts. Fällt der Controller aus, lassen sichIPAddressPool-Objekte nicht ändern. - Aufnahme in GitOps: vorbereitet im Verzeichnis
argocd/pending/metallb-system/(nicht unterargocd/apps/, damit der ApplicationSet es erst bei der Übernahme findet). Siehe nächster Abschnitt.
Ü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):
- Rolle rendern:
make render-bootstrap CORE_DIR=<Pfad zu capulus-core>(Vault-Passwort). Die Vorlagebootstrap-appprojects.yaml.j2enthältmetallb-systemschon als festes Ziel im Projekttech(wiecert-manager, ohne tier-default-ingress-NetworkPolicy); das Ergebnisargocd/bootstrap/projects.yamlcommitten und im Hub anwenden (kubectl apply -f argocd/bootstrap/projects.yaml). - Sicherung:
kubectl get ipaddresspool,l2advertisement -n metallb-system -o yaml > metallb-crs-backup.yaml. - 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. 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).- Prüfen:
kubectl -n metallb-system get pods(nurmetallb-controllerundmetallb-speakerje Node, keinefrr-k8s),kubectl -n kube-system get svc traefik(EXTERNAL-IP192.168.178.200),curl -sk https://192.168.178.200/ -o /dev/null -w '%{http_code}\n'(404), auf den Nodesss -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). - Rollback: Verzeichnis zurück nach
argocd/pending/(oder Revert), dannhelm upgrade metallb metallb/metallb --version 0.16.1 -n metallb-system(solange der Release-Eintrag noch existiert) bzw.helm install … --take-ownershipundkubectl 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.