Rolle `common`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/common.md
Rolle common
Basis-OS, UFW, Pakete, sysctl, chrony, Swap aus, optional statische IP. Ein automatischer Neustart (auto_reboot_if_required) läuft auf k3s-Servern nur, wenn k3s_reboot_guard ihn freigibt.
| Läuft gegen | controlplane-0, prod-vm, entw-vm |
| Tags | base, common |
| Quellcode | roles/common |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
common_ufw_lan_allow_all |
true |
– |
common_ufw_tailnet_allow_all |
true |
– |
common_ufw_k3s_api_sources |
['{{ local_subnet }}'] |
– |
common_ufw_trusted_hosts |
[] |
– |
common_ufw_lan_services |
[] |
– |
common_disabled_services |
[ModemManager.service] |
Dienste, die gestoppt und deaktiviert werden; nicht vorhandene Einheiten werden übersprungen |
Ablauf
- hostnamen setzen
- hostnamen in /etc/hosts eintragen
- apt-cache aktualisieren
- alle pakete aktualisieren (dist-upgrade)
- benötigte systempakete installieren
- unattended-upgrades einschalten (sicherheitsupdates zwischen den ansible-läufen)
- unattended-upgrades auch für "updates" und zum aufräumen einrichten
- sicherstellen dass der dienst unattended-upgrades aktiviert ist
- zeitzone setzen
- chrony aktivieren und starten
- kubernetes-voraussetzungen herstellen (
tasks/k8s_prerequisites.yml: Swap aus und maskiert, Kernel-Modulebr_netfilter/overlay, sysctl in/etc/sysctl.d/99-k3s.conf; auch vonk3s_agentgenutzt) - ssh (port 22) vor allen anderen firewall-änderungen erlauben
- ufw-standardrichtlinie für eingehenden verkehr auf deny setzen
- ufw-standardrichtlinie für ausgehenden verkehr auf allow setzen
- http (port 80) für den traefik-ingress erlauben
- https (port 443) erlauben
- k3s-api (6443) nur von den freigegebenen quellen erlauben
- regeln für den argocd-nodeport 30080 entfernen (nodeport entfällt, argocd läuft über den ingress)
- offene regel für den argocd-nodeport 30080 entfernen (manuell gesetzt, jetzt auf lan/tailnet begrenzt)
- nutzlose regel für den argocd-nodeport 30443 entfernen (server spricht dort klartext, kein tls)
- tailscale-wireguard (udp 41641) erlauben
- flannel-vxlan (udp 8472) und kubelet (10250) nur aus dem lan erlauben
- offene k3s-regeln für alle quellen entfernen (6443, 10250, 8472)
- gesamten verkehr aus dem pod-cidr von k3s erlauben
- gesamten verkehr aus dem service-cidr von k3s erlauben
- gesamten verkehr aus dem lokalen lan erlauben
- gesamten verkehr aus dem tailscale-netz erlauben
- infrastruktur-hosts mit vollzugriff erlauben
- dienste für das lan freigeben
- pauschale lan-regel entfernen
- pauschale tailnet-regel entfernen
- ufw aktivieren
- prüfen dass ufw aktiv ist
- ufw-status anzeigen
- statische ip per netplan einrichten
- vorhandene netplan-konfigurationen suchen
- vorhandene netplan-dhcp-konfigurationen entfernen
- statische netplan-konfiguration ablegen
- netplan-konfiguration anwenden (verbindung bricht kurz ab)
- warten bis der server unter der neuen statischen ip erreichbar ist
- prüfen ob ein reboot nötig ist (kernel-/libc-updates)
- server neu starten, weil /var/run/reboot-required gesetzt ist
- reboot nötig, aber auto_reboot_if_required ist false — betreiber warnen
- reboot nötig, aber semaphore führt diesen task aus — warnen statt sich selbst abzuschießen
- nicht benötigte dienste stoppen und deaktivieren
Handler
- chrony neu starten
- sysctl neu laden
Templates
netplan-static.yaml.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo ufw status verbose
sudo systemctl status chrony unattended-upgrades
sudo sysctl net.bridge.bridge-nf-call-iptables net.ipv4.ip_forward
swapon --show; cat /var/run/reboot-required
| Symptom | Ursache | Lösung |
|---|---|---|
| Verbindung bricht nach dem Playbook ab | UFW blockiert (SSH-Regel kommt vor allen anderen, aber Quelle/Subnetz falsch) oder Netplan-Umstellung | Konsole am Gerät: sudo ufw status, local_subnet prüfen (Troubleshooting) |
| Dienst aus dem LAN nicht erreichbar | Port nicht in common_ufw_lan_services oder common_ufw_lan_allow_all: false |
Variable ergänzen, Rolle ausrollen |
| k3s-API (6443) von außen nicht erreichbar | common_ufw_k3s_api_sources beschränkt auf local_subnet |
Quellen ergänzen |
| Statische IP greift nicht oder Host verschwindet | Netplan-Konfiguration fehlerhaft, wait_for auf neue IP läuft ab |
Konsole am Gerät, sudo netplan try, /etc/netplan/ |
reboot required-Warnung im Lauf |
Kernel- oder libc-Update; auto_reboot_if_required ist aus oder Lauf kommt von Semaphore |
manuell neu starten (Reihenfolge bei Workern beachten, Cluster Power Manager) |
| k3s startet wegen Swap nicht | Swap war aktiv | Rolle entfernt Swap aus /etc/fstab, swapon --show prüfen |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.