60020 - Ansible: Rollen — Hintergründe
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/6-hintergruende/60020-ansible-rollen.md
Ansible: Rollen — Hintergründe
Begründungen zu den Rollen unter capulus-ansible/roles/, geordnet nach Rolle. Hosts, VMs, Playbook-Reihenfolge und die Rolle
libvirt_host stehen in 60010. Die Rolle argocd steht in
60030. Bedienung der Geräte: 30010,
30020, 300e0.
Kiosk-Geräte
banana_pi_kiosk (Vereinsheim-Alarmmonitor)
Der Pi ist ein reines Display: Chromium zeigt die Redirect-URL des Clusters (argocd/apps/tech/alamos-apager), die
Heartbeat-/Alerting-Logik bleibt im Cluster. Chromium startet bewusst ohne --incognito, damit der einmalige manuelle
AMweb-Login (Passwort plus Verschlüsselungspasswort im Formular) Neustarts übersteht. Bildschirmschoner und Energiesparen sind aus.
Armbian/Debian hat keinen Imager-Schalter für Autologin, die Rolle bildet ihn mit getty-Drop-in, .bash_profile und startx nach.
Ein lokaler Failover-Supervisor schaltet bei Nichterreichbarkeit von alamos-apager auf eine vault-verschlüsselte Fallback-URL um.
Die frühere Raspberry-Pi-Rolle alamos_kiosk samt alarm-kiosks.yml ist entfernt (die Gruppe raspberry_pis war leer, der
Banana Pi hat sie ersetzt).
| Stelle | Begründung |
|---|---|
Fallback-URL steht in /etc/banana-pi-kiosk/supervisor.env (0640, root:<kiosk-user>), nicht im Skript |
Das Skript liegt mit 0755 unter /usr/local/bin und wäre für jeden Nutzer lesbar. Der Supervisor läuft als Kiosk-User aus .xinitrc (kein systemd-Dienst), daher source statt EnvironmentFile. Der Task läuft mit no_log und diff: false. |
| Supervisor startet immer im Normalbetrieb | Die erste Prüfung im Loop korrigiert das innerhalb von POLL_SECONDS × FAIL_THRESHOLD, falls der Cluster beim Boot des Pi schon nicht erreichbar ist. |
| Supervisor startet Chromium neu, wenn es abgestürzt ist | Im aktuellen Modus, ohne auf die nächste Zustandsänderung zu warten. |
Periodischer Neustart (REFRESH_SECONDS, 0 deaktiviert) |
Sicherheitsnetz gegen eine lautlos hängengebliebene In-Page-Live-Aktualisierung. |
| Heartbeat-Skript: Fehlschlag ohne Folgen | Schlägt der Request fehl (Cluster/DNS kurz weg), passiert nichts weiter: Der lokale Supervisor kümmert sich unabhängig um die Browser-Umschaltung, der Timer steuert nur den zentralen ntfy-Ausfall-Alarm. |
Täglicher Neustart startet nur die tty1-Session (getty → startx → X/openbox/Chromium), kein reboot |
Auf dem Banana Pi M2 Ultra (Armbian „Community Supported“) ist der Warm-Reset-Pfad unzuverlässig: Der Pi blieb nach einem echten Reboot einmal komplett aus und war nur per physischem Stromzyklus wieder erreichbar. Das Vereinsheim hängt nur per Tailscale dran, ohne LAN-Fallback. Der Session-Neustart räumt Chromium-Zustand und Speicher genauso auf, ohne das Kernel-/Firmware-Risiko. |
Timer ohne Persistent=true |
Er soll nur zur geplanten Uhrzeit auslösen und nicht nachholen, falls der Pi da gerade aus war (sonst würde er direkt beim nächsten Hochfahren erneut neu starten). |
make banana-pi-kiosks-restart-session |
Der Handler „getty@tty1 neu laden“ läuft nur bei Ansible-changed. Liegt das Skript schon korrekt auf der Platte (z. B. weil ein früherer Lauf es geschrieben hat, bevor der notify existierte), meldet der Task ok, und der längst laufende Prozess bleibt mit veralteten Werten (z. B. BASE_URL) im Speicher, weil er sich nicht selbst neu einliest. Das Target erzwingt den Neustart unabhängig von einem Playbook-Diff und braucht kein Vault-Passwort, da der Ad-hoc-Befehl keine verschlüsselten Variablen referenziert. |
| Screenshot-Skript nur manuell per SSH, kein Timer/Dienst (kein x11vnc, kein Cron) | Nur für die Sichtprüfung (30020, „Sichtprüfung ohne physischen Zugriff“). Läuft als Kiosk-User (gleicher User wie die X-Session auf :0), daher kein XAUTHORITY-Handling. |
| Wake-on-LAN-Skript nur manuell per SSH | Der Pi ist per Tailscale erreichbar (Semaphore und n8n haben keinen Pfad zu Tailscale-Peers), broadcastet das Magic Packet aber lokal. Das funktioniert nur, wenn Zielgerät und Pi im selben L2-Segment hängen (keine Client-/AP-Isolation im Router oder Repeater). |
WoL-HTTP-Agent (banana-pi-wol-agent.py) direkt am Pi |
Dünner HTTP-Wrapper um banana-pi-wol.sh, damit die iOS-App ein Magic Packet ins Standort-LAN auslösen kann. Er spiegelt strukturell power-agent.py, ist aber sonst unabhängig: Der power-agent läuft im LAN des Homeservers und wird vom carplay-api-Pod gerufen, dieser hier läuft im reinen Tailscale-Netz des Pi und wird direkt von der App gerufen, weil der carplay-api-Pod keine Route zu Tailscale-Peers hat (40020). Er kennt keine MACs, Gültigkeit des Ziels und MAC-Lookup bleiben in banana-pi-wol.sh / banana_pi_kiosk_wol_devices, er reicht nur den Alias weiter. Er lauscht auf banana_pi_kiosk_wol_agent_bind_address: Im Standard 0.0.0.0, für den Alarmmonitor per host_vars auf seine Tailscale-Adresse (ansible_host), damit das Vereinsheim-LAN den Port nicht erreicht. Steht ansible_host auf einer LAN-Adresse (Ersteinrichtung), lauscht der Agent dort statt am Tailnet. Timeouts, Body-Grenze und systemd-Härtung wie beim power_agent. TLS schaltet banana_pi_kiosk_wol_agent_tls_enabled ein (Zertifikat und Schlüssel als Vault-Variablen, die Rolle legt sie mit 0600 ab, der Schlüssel mit no_log; fehlt eines, bricht ein assert ab). Der Agent aktiviert TLS nur, wenn TLS_CERT und TLS_KEY gesetzt sind, ohne diese Werte läuft er wie vorher mit HTTP, das ist der Rollback-Schalter. Mindestens TLS 1.2. Der Handshake läuft im Handler-Thread mit dem 10-Sekunden-Timeout und nicht im Accept-Loop, sonst könnte ein Client, der nur verbindet und nichts sendet, den ganzen Agent blockieren. Fehlgeschlagene Handshakes (Klartext-Client, Scanner) landen als eine Logzeile im Journal statt als Traceback. Das Zertifikat ist von Hand ausgestellt (365 Tage, Ablauf im Token-Register), weil cert-manager es nicht auf den Pi verteilen kann: d0040. |
xibo_kiosk (Raspberry Pi 3 B+, Bilder-Slideshow)
Kein echter Xibo-Player, denn Xibo unterstützt den Raspberry Pi nicht offiziell (300e0).
Stattdessen holt der Pi die Bilder aus dem NFS-Ordner xibosignage-display in einen lokalen Cache, und Chromium zeigt sie im
Kiosk-Modus per file://. Ablauf und Betrieb: 300e8.
- Server und Pfad des NFS-Ordners müssen identisch zu
argocd/apps/tech/n8n/values.yaml→xibosignage.displaysein: n8n
schreibt dorthin, der Pi liest read-only.xibo_kiosk_sync_interval_secondsbestimmt die Verzögerung, mit der ein neues Bild
im Cache landet,xibo_kiosk_manifest_reload_secondsdie, mit der die Seite es übernimmt. - Ziel ist ein sofort sichtbares Bild nach dem Boot. Deshalb hängt Chromium an nichts außer dem X-Server: kein
network-online.target,
kein Webserver, kein NFS-Mount. Alles, was ein Netzwerk braucht, läuft im Sync-Dienst, der Chromium nicht ausbremsen kann. - Kiosk als eigene Dienste statt Login. Gemessen (Modus
getty) startete Chromium erst bei Uptime 43 s:getty@tty1wartet aufplymouth-quit-wait,systemd-user-sessionsundremote-fs.target, und/run/nologinblockiert bis dahin jeden Login.xibosignage-xorg.servicestartet daher Xorg als root direkt nach udev (Plymouth wird perplymouth quitbeendet, sonst hält es den DRM-Master),xibosignage-kiosk.servicestartet Chromium alsxibo_kiosk_userohne PAM-Sitzung. Folgen: Der X-Server läuft aufvt7, tty1 bleibt die normale Konsole. Der Zugriff auf die GPU geht über die Gruppenvideoundrenderstatt über logind-ACLs. Der X-Zugang läuft über ein zufälliges Cookie in/run/xibosignage/Xauthority(root:Kiosk-User,0640). Beide Units habenDefaultDependencies=nound hängen nur anlocal-fs.target, udev und tmpfiles: Hinterbasic.targetbegann X erst bei Uptime 21 s (gemessen, erste Fassung). Dafür tragen sieConflicts=shutdown.targetundBefore=shutdown.targetselbst. Der Kiosk-Dienst wartet im Start-Skript auf X (xrandr-Schleife), der X-Dienst startet bei Fehlern (DRM-Gerät noch nicht da) nach einer Sekunde neu. Im laufenden Betrieb startet die Rolle die Dienste nicht selbst, weil auf dem Pi noch die alte X-Sitzung auf:0läuft. Sie sind erst nach dem Neustart aktiv.xibo_kiosk_start_mode: gettybleibt als Rückfallebene. - Eigene X11-Sitzung statt Desktop. Auf Raspberry Pi OS Bookworm ist die Desktop-Sitzung Wayland (labwc oder wayfire), das
frühere Skript setzte aberDISPLAY=:0undxsetvoraus. Welche Umgebung wirklich lief, war nicht festgelegt, undunclutter
funktioniert unter Wayland nicht. Mit getty-Autologin undstartx(wie beibanana_pi_kiosk) steht X11 fest, die Desktop-Sitzung
(lightdm) ist maskiert, der Standard-Target istmulti-user.target. - NFS-Eintrag mit
noauto. Ein Mount beim Boot mit_netdevhängt am Netzwerk. Den Mount erledigt stattdessenxibosignage-sync.py
(mount <Pfad>mit 30-Sekunden-Timeout) gegen den fstab-Eintrag. Der Pi bootet damit auch bei totem NAS in dieselbe Slideshow. - Idempotenz beim NFS-Mount: War der Mount aus einem früheren (ggf. abgebrochenen) Lauf noch aktiv, blockt der read-only
NFS-Exportchown/chmodim nächsten Task („Das Dateisystem ist nur lesbar“), weil dann die Attribute des Exports statt des lokalen
Verzeichnisses gelten. Deshalb wird der Mount vor dem Anlegen des Mountpoints ausgehängt. - Atomarer Cache, nie leerer Bildschirm. Der Sync schreibt nach
media/.partial/, sichert perfsyncund ersetzt dann per
os.replace. Er verwirft eine Datei, wenn sich die Quelle währenddessen ändert, und holt Dateien, die jünger als fünf Sekunden sind,
erst im nächsten Lauf, weil n8n sie evtl. noch schreibt. Eine leere Quelle löscht den Cache nicht: Ein fehlgeschlagener
Workflow darf die Infotafel nicht schwarz schalten. file://undmanifest.js.fetchauf lokale JSON-Dateien blockiert Chromium, daher ist die Bildliste ein Skript
(window.XIBO_MANIFEST=[…]), das die Seite per<script>neu lädt. Die Bild-URLs tragen?v=<mtime>statt eines Zeitstempels,
damit der Browser-Cache greift und trotzdem geänderte Dateien erkennt.- Chromium-Profil unter
/dev/shm. Es wird bei jedem Start gelöscht und neu angelegt. Das verhindert den Dialog „nicht korrekt beendet“
nach Stromausfall und schont die SD-Karte. Ein Neustart-Loop im Start-Skript ersetztRestart=alwaysder früheren Unit. - Bildschirmformat wird erzwungen, nicht mehr erkannt. Früher suchte
xibosignage-display-mode.shden vom EDID
gemeldeten bevorzugten Modus und fiel sonst auf den ersten Kernel-Modus zurück. Die Infotafel liefert aber dauerhaft
kein EDID (xrandrzeigt0mm x 0mm, nur die vier VESA-Notfallmodi bis 65 MHz), die Erkennung lief dort also ohnehin
nie auf etwas anderes als den Fallback hinaus. Das Skript setzt seitdem beim Start immer direktxibo_kiosk_display_mode
(Default1920x1080), ohne Scan und ohne Timeout/Fallback-Logik. Die erzwungene Größe liegt in
/dev/shm/xibosignage-screenund ist die Zielgröße des Sync, begrenzt durchxibo_kiosk_image_max_*. Ändert sie sich,
werden die Bilder aus den Originalen auf dem NAS neu erzeugt (media/.target), nie aus bereits skalierten Kopien.
Das reicht aber nicht allein: Ohne EDID validiert der vc4-KMS-Treiber (dtoverlay=vc4-kms-v3d) jede Mode-Konfiguration
nur gegen seine eingebaute Notfallliste und lehnt1920x1080mitConfigure crtc 0 failedab, auch mitcvt/--addmode
erzeugter Modeline.xibo_kiosk_edid_forcelöst das, indem es dem Treiber per Kernel-Parameterdrm.edid_firmware=
eine synthetische, aber spezifikationskonforme EDID-Datei vorlegt (scripts/generate-edid.py,
validiert mitedid-decode -c) — der Treiber hält sie für ein echtes Display und akzeptiert den Modus. Zwei scheinbar
näherliegende Wege greifen bei Full-KMS nicht mehr und wurden verworfen: der Kernel-Parametervideo=…eerzwingt nur den
Connector-Status, keinen gültigen Modus;hdmi_group/hdmi_mode/hdmi_ignore_edidinconfig.txtwerden von der
GPU-Firmware beidtoverlay=vc4-kms-v3dgar nicht mehr ausgewertet (vcgencmd get_config hdmi_mode→unknown). Details
und die Diagnose-Befehle: 50030. - NAS-Erreichbarkeit hängt von Tailscale-Subnetzrouting ab, sobald der Pi nicht mehr im selben LAN steht. Das NAS
(ugreen-nas) hat selbst keinen Tailscale-Knoten; erreichbar ist es nur über die vomhomeserverannoncierte
Subnetzroute192.168.178.0/24. Ein reiner Tailscale-Host muss dafürtailscale_accept_routes: truesetzen (Rollen-Default
false) — die Route selbst im Tailnet genehmigt zu haben reicht nicht, wenn der Client sie nicht akzeptiert. Ohne eigenen
Tailscale-Knoten auf dem NAS ist derhomeserverdamit ein unsichtbarer Single Point of Failure für jeden rein per
Tailscale angebundenen Host, siehe 50030. - Gelöschte Bilder brauchen eine Gnadenfrist vor dem physischen Löschen. Der NAS-Workflow vergibt bei jeder Änderung
einen neuen Dateinamen (Versions-Suffix) und der Sync entfernte den alten Namen bisher sofort.slideshow.jshält sein
Manifest aber bis zuxibo_kiosk_manifest_reload_seconds(10 s) im Speicher, unabhängig vom Sync-Takt (30 s) — zeigte die
Rotation in diesem Fenster noch auf den gerade gelöschten Namen, schlug das Laden mit 404 fehl und das Bild wurde komplett
übersprungen statt die konfigurierte Dauer zu laufen.xibo_kiosk_orphan_grace_seconds(Default 30 s, persistiert in
media/.orphans.json) trennt die beiden Schritte: Referenz sofort ausmanifest.jsentfernen, Datei selbst erst nach der
Gnadenfrist physisch löschen. - Pixel-Seitenverhältnis. Die Infotafel meldet
798mm x 334mm(21:9), der Pi 3 B+ gibt höchstens 1920×1080 aus. Der Monitor streckt das Bild dann, und die Pixel sind nicht quadratisch. Die Seite gleicht das per?par=<k>undscaleX(1/k)aus (Faktor aus EDID-Größe und Modus, nur außerhalb 0,92 bis 1,08).xibo_kiosk_pixel_aspect: offschaltet es ab, falls der Monitor Balken statt Strecken zeigt. Der Faktor wird nur beim Start berechnet, ein später gewechselter Modus ändert ihn nicht. - Skalierung statt WebP. Bilder über der Zielgröße skaliert der Sync mit ImageMagick (
nice 19, Speicherlimit). Eine WebP-Umwandlung
würde den Pi 3 B+ stärker belasten, als sie nützt, und der n8n-Workflow liefert die Bilder ohnehin schon in dieser Größe. - Das Skript unterstützt die Binärnamen
chromium-browserundchromium: Debian Bookworm hat das Binary umbenannt, das
Paketchromium-browserexistiert nur noch als Übergangspaket ohne Binary dieses Namens. So läuft es auf Bullseye- wie Bookworm-Pis. - GPU-Flags sind nicht vorgesetzt. Ob die Hardwarebeschleunigung greift, hängt vom Image ab (
chrome://gpu). Falsche Flags enden
auf dem Pi in einem schwarzen Bildschirm, deshalb steht nurxibo_kiosk_chromium_extra_flagszur Verfügung, leer im Standard. xibosignage-sync.servicehängt annetwork-online.target, der Kiosk bewusst nicht. Die DiensteModemManager,triggerhappy,
cups,cups-browsed,e2scrub_reap(nur für LVM) undupower(Akku, auf dem Kiosk sinnlos) deaktiviert die Rolle (xibo_kiosk_disable_services), weitere Kandidaten stehen in 300e8. Der apt-Exporter des Monitorings (prometheus-node-exporter-apt, 19,7 s CPU im Boot) bekommt per Drop-in niedrige Priorität, damit er X und Chromium nicht ausbremst.
Energie und Schutz der Hardware
cluster_power_manager, cluster_power_manager_target und wake_on_lan
Control-Planes sind kein Ziel. cluster_power_manager_workers enthält nur Worker, die per WoL gesteuert werden dürfen (heute worker-1). controlplane-0 und controlplane-1 sind etcd-Mitglieder: Ein Poweroff nähme bei zwei Mitgliedern die API mit. Damit auch bereits verteilte Zugänge verschwinden, entfernt cluster_power_manager_target mit cluster_power_manager_target_enabled: false den Shutdown-Schlüssel und die sudoers-Freigabe (auf controlplane-1 gesetzt). Der Eintrag cluster-power-manager@homeserver im Schlüsselkommentar bleibt, er ist ein Name, kein Host.
cluster_power_managerläuft auf dem Homeserver und erzeugt das SSH-Schlüsselpaar, mit dem der Watchdog die Worker
herunterfährt. Autorisiert wird der Public Key erst durchcluster_power_manager_targetauf den Workern. Das Playbook mit
cluster_power_managermuss also vor den Worker-Playbooks laufen.- Der Key ist per forced-command auf
sudo poweroffbeschränkt. Anders als der Semaphore-Key kann er nichts anderes ausführen,
selbst wenn das private Schlüsselmaterial je abfließt. - Bootstrap im Skript: Ist ein Worker beim (Neu-)Start des Skripts schon erreichbar (Homeserver-Reboot, manueller Wake,
State-Datei gelöscht), aber es existiert keinewoke_at-Datei, wäre dasMIN_UPTIME_SECONDS-Gate inshutdown_worker()nie
erfüllt (woke_at=0), und der Worker würde nie mehr automatisch heruntergefahren. Der Zeitstempel wird deshalb beim Start
gesetzt, die Mindestlaufzeit zählt ab da. - Die Worker-Liste (
cluster_power_manager_workers) gibt die Weck-Reihenfolge vor, das Herunterfahren läuft in umgekehrter Reihenfolge.nightly_worker_wakeführt
eine identische Liste. Hochskalieren (Homeserver überlastet → Worker wecken) und Herunterskalieren (Last wieder niedrig → Worker ausschalten) haben getrennte Schwellen,
dazu kommt eine Wartezeit auf „Ready“ nach dem WoL und ein SSH-Zugang für den ferngesteuerten Poweroff. wake_on_lan_interfacemuss die physische Schnittstelle sein, nicht die Bridge. Der Default istansible_default_ipv4.interface. Auf worker-1 ist dasbr0(Bridge für die ENTW-VM),ethtool -s br0 wol gscheitert dort mit „netlink error: Operation not supported“,enable-wol.servicestand auffailedund die NICenp2s0blieb aufWake-on: d: worker-1 ließ sich nicht per Magic Packet wecken.host_vars/worker-1setzt deshalbwake_on_lan_interface: "enp2s0". Prüfen:sudo ethtool enp2s0 | grep Wake-onmussgzeigen.wake_on_lansetztethtool wol gbei jedem Boot: Die meisten NIC-Treiber vergessen „Wake-on-LAN: enabled“ nach einem
Kaltstart. Das BIOS/UEFI sorgt nur dafür, dass die NIC im ausgeschalteten Zustand Strom bekommt, der Magic-Packet-Modus wird vom
Linux-Treiber beim Boot zurückgesetzt. Voraussetzung ist WoL im BIOS/UEFI (je nach Hersteller „Power On by PCI-E/PCIE“,
„Wake on LAN“ o. ä.), das kann Ansible nicht setzen und ist einmalig manuell zu prüfen. Das Interface ist im Default das der
Default-Route, auf worker-0/worker-1 stimmt das, weil nur eine NIC aktiv ist.
nightly_worker_wake und worker_apt_update
nightly_worker_wake(01:00 Uhr) löst per n8n-Trigger den Zyklus aus und ersetzt einen früheren systemd-Timer. Es weckt den
Worker per WoL, lässt Semaphore das Template „Deploy worker-*“ laufen (enthältworker_apt_update) und fährt den Worker wieder
herunter. Die Service-Unit hat ein verlängertes Timeout, weil Playbook-Läufe über Semaphore je nach Paketlage mehrere Minuten
dauern, deutlich über dem systemd-Default von 90 s fürType=oneshot.nightly_worker_wake_semaphore_api_basemuss zusemaphore_api_baseder Rollesemaphore_bootstrappassen (HTTPS, siehe unten).worker_apt_updatedeckt nur das apt-Update ab, weil die Worker reine k3s-Compute-Nodes ohne die vollecommon-Rolle sind.
Der k3s-Node-Name fürcordon/drainmuss zuk3s_agent_hostnamepassen (derselbe Node), das kubeconfig stimmt mit dem von
cluster_power_managerüberein.- Der automatische Reboot bei Kernel-/libc-Updates läuft im selben Semaphore-Task, den
nightly_worker_wakeohnehin bis zu
nightly_worker_wake_max_runtime_secondsabwartet, ein eigener Schritt im Orchestrator-Skript ist nicht nötig.cordon+drain
laufen vor dem Reboot, damit Pods sauber evakuiert werden statt beim harten Neustart abzureißen. Scheitert der Drain (z. B. an
einem PodDisruptionBudget), gibt die Rolle den Node wieder frei und lässt den Neustart aus;reboot-requiredbleibt stehen und
der nächste Lauf versucht es erneut. Nur „not found“ (Node nicht im Cluster) gilt als Erfolg. Das Uncordon übernimmt die
Play „Uncordon nach Provisioning“ am Ende voncontrolplane-1.yml/worker-1.yml, die immer läuft.
worker_apt_update_reboot_timeout_seconds(300) gilt für den Neustart samt erneuter Erreichbarkeit und für die Wartezeit danach, bis
sich k3s-Agent und Netzwerk gesetzt haben. dns-fallback.yaml.j2ergänzt nurnameserversfürworker_apt_update_dns_fallback_interface. Netplan führt das mit der bestehenden Subiquity-Konfiguration zusammen, Adresse und Route bleiben dort unverändert (20030).
power_agent
Privilegierter HTTP-Agent auf dem Homeserver-Host, nicht im Cluster. Er erledigt, was der carplay-api-Pod bewusst nicht darf:
Bildschirmhelligkeit (sysfs), manuelles Wake-on-LAN und Poweroff für worker-0/worker-1 sowie den eigenen Poweroff des Homeservers.
- Er steht im Playbook nach
cluster_power_managerund nutzt dessen SSH-Key, kubeconfig, State-Verzeichnis und Worker-Liste. So
teilen manuelle Aktionen aus der App und der automatische Last-Watchdog dieselbe Buchführung (woke_at-Dateien), statt sich zu
widersprechen. - UFW braucht keine neue Regel: „gesamten verkehr aus dem pod-cidr von k3s erlauben“ (Rolle
common) deckt Pod → Host ab, unabhängig davon, auf
welchem Node der carplay-api-Pod läuft (Flannel-Overlay). - Der Agent lauscht nur auf der Adresse der Pod-Bridge
cni0des homeservers (power_agent_bind_address: "10.42.2.1"inhost_vars/homeserver, das Pod-Netz10.42.2.0/24ist dem Node fest zugewiesen),carplay-apiruft
http://10.42.2.1:9101auf. Er ist damit weder aus dem LAN noch aus dem Tailnet noch von den Workern oder über127.0.0.1erreichbar, und der Token läuft nur über die Bridge des eigenen Nodes, nicht über das LAN. Das ersetzt HTTPS und
die Firewall-Freigabe für diesen Port. Tests vom Host aus gehen deshalb nur gegen10.42.2.1. Beim Start nach einem Reboot gibt escni0erst, wenn die erste Pod-Sandbox angelegt ist: Bis dahin scheitert das Binden, und
Restart=always(RestartSec=10) probiert es alle zehn Sekunden erneut. Ändert sich die Adresse (Node neu registriert), startet der Agent nicht mehr:ip -4 addr show cni0prüfen,power_agent_bind_addressundpowerAgent.urlincarplay-apiangleichen. - Hostschlüssel der Worker sind festgelegt. Der Agent ruft
sshmitStrictHostKeyChecking=yesundUserKnownHostsFile=/etc/power-agent/known_hostsauf, nicht mehr mitaccept-new. Die Rolle schreibt die Datei aus
den Einträgen in/root/.ssh/known_hostsdes homeservers (ssh-keygen -F), fehlt ein Worker dort, holt sie seinened25519-Schlüssel einmalig mitssh-keyscan(so war es vorher bei der ersten Verbindung auch). Findet sie gar keine
Schlüssel, lässt sie die Datei unverändert und warnt. Fehlerbild: Hat ein Worker einen neuen Hostschlüssel (Neuinstallation), scheitert der Poweroff über die App mitHost key verification failed. Dann den alten Eintrag aus
/root/.ssh/known_hostsund/etc/power-agent/known_hostsentfernen und die Rolle neu laufen lassen. - Der Poweroff der Worker läuft über einen Schlüssel mit
command=. Der SSH-Aufruf des Agents führt auf dem Worker immersudo poweroffaus, egal welcher Befehl übergeben wird (20020). Diesen Schlüssel
nie zum Testen einer Verbindung benutzen. Den Hostschlüssel-Pfad prüft man gefahrlos mit-o PreferredAuthentications=none: Er bricht nach der Hostschlüssel-Prüfung mitPermission denied (publickey)ab und führt nichts aus. - Anfragen sind begrenzt. Der Handler schließt Verbindungen nach 10 Sekunden ohne Daten, der Body darf höchstens 4096 Byte haben, eine negative oder unlesbare
Content-Lengthergibt400statt eines hängenden Threads. - systemd-Härtung (
NoNewPrivileges,PrivateTmp,ProtectHome,ProtectSystem=full,ProtectKernelModules,ProtectControlGroups,RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX,RestrictRealtime,RestrictNamespaces,
LockPersonality,SystemCallArchitectures=native,UMask=0077). Bewusst nicht gesetzt:ProtectKernelTunables(würde/sysschreibgeschützt machen, die Helligkeit wird über sysfs geschrieben),DynamicUserundUser=(der Agent braucht root für
kubectl, den SSH-Schlüssel, sysfs undpoweroff),PrivateDevices. Die Optionen wurden vor dem Ausrollen mit einer kurzlebigen Einheit gleicher Einstellungen getestet:kubectl get nodes, Helligkeit schreiben,wakeonlan,systemctlund die
Hostschlüssel-Prüfung funktionieren. Das Ergebnis zeigtsystemd-analyze security power-agent.service. - Der Bestätigungscode für den Shutdown des Homeservers wird nur in
carplay-apigeprüft, nicht im Agent. Wer den Token hat, fährt den Homeserver direkt herunter. Eine zweite Prüfung im Agent würde den Vertrag zwischen App,carplay-apiund Agent ändern.
ollama_pc
Desktop-PC mit Ollama (300g0). Der PC ist kein Cluster-Knoten und nicht im Playbook site.yml, sondern in der Gruppe ollama_pcs mit eigenem Playbook ollama-pc.yml.
- Wake-on-LAN über NetworkManager statt über die Rolle
wake_on_lan. Der Desktop nutzt NetworkManager, die Verbindung kommt aus Netplan (netplan-enp7s0).nmcli connection modify … 802-3-ethernet.wake-on-lan magichält die Einstellung dort, wo NetworkManager sie bei jeder Aktivierung anwendet. Die Rolle setzt zusätzlichethtool -s … wol g, damit es ohne Neuaktivierung sofort gilt (eine Neuaktivierung würde die Verbindung kurz kappen und einen SSH-Lauf abbrechen). Ob die NetworkManager-Einstellung einen Reboot übersteht, ist für Netplan-Profile nicht vorab geprüft, deshalb steht die Prüfung nach dem ersten Reboot in 300g0. Fallback istwakeonlan: truein Netplan. ollama_pc_interfacemuss die physische NIC sein. Wie bei worker-1 (wake_on_lan) scheitertethtool -sauf einer Bridge.- Resume-Hook startet
ollama.serviceundnvidia-power-limit.serviceneu. Nach einem Suspend verliert Ollama oft die GPU und fällt auf die CPU zurück. Ein Neustart des Dienstes holt sie zurück. Das Power-Limit startet ebenfalls neu, weil es nach dem Aufwachen zurückgesetzt sein kann. Der Hook nutzt--no-block, damit das Aufwachen nicht auf die Dienste wartet. nvidia-persistencedist einestatic-Unit (kein[Install]-Abschnitt),systemctl enablegeht nicht. Die Rolle legt den Symlink inmulti-user.target.wantsselbst an (das, wassystemctl add-wantstäte). Die Ubuntu-Unit startet den Daemon mit--no-persistence-mode, der Persistenzmodus kommt deshalb ausnvidia-smi -pm 1innvidia-power-limit.service.- UFW erlaubt SSH vor dem Aktivieren. Mit
deny incomingohne SSH-Regel sperrt sich ein per SSH laufendes Playbook aus.ollama_pc_ufw_ssh_sourcesnimmt das lokale Subnetz. Ollama-Port 11434 geht nur an den Homeserver (n8n-Pods erscheinen mit der Node-IP). - Ollama kommt aus dem offiziellen Installationsskript, gepinnt auf das Release-Tag.
ollama_pc_install_script_urlzeigt aufscripts/install.sham Tagv{{ ollama_pc_version }}vonollama/ollama,ollama_pc_install_script_sha256prüft es (Installer und Prüfsummen). Das Skript läuft nur, wennollamafehlt, und lädt das Archiv der gepinnten Version über HTTPS von GitHub; dessen Prüfsumme prüft das Skript nicht. ansible_become_exe: /usr/bin/sudo.wsfür den PC. Ubuntu 26.04 liefertsudo-rsalssudo. Es gibt den Prompt als[sudo: <Prompt>] Passwort:aus, Ansible erkennt ihn nur, wenn die Zeile mit dem eigenen Prompt beginnt (startswithincheck_password_prompt). Das Passwort wird dann nie gesendet, der Lauf endet mit „Timed out waiting for become success or become password prompt“.sudo.wsist das klassische sudo aus dem Paketsudound liegt parallel zusudo-rs. Auf anderen Hosts mit sudo-rs derselbe Fehler, dieselbe Abhilfe.- Auto-Suspend prüft mehr als Ollama. Der PC ist ein Arbeitsrechner. Ein reiner „kein Modell geladen“-Test würde ihn mitten in der Arbeit einschlafen lassen. Deshalb zählen auch eine aktive Desktop-Sitzung (
IdleHint), blockierende Schlafsperren und die Last. Eine nicht lesbare Prüfung (Ollama aus,loginctlohne Antwort) zählt als „nicht beschäftigt“, der PC schläft also nur dann ein, wenn alle übrigen Prüfungen ebenfalls frei sind. Das Modell bleibt wegenkeep_alive30 Minuten geladen, der Auto-Suspend wartet danach nochollama_pc_idle_suspend_minutes. - Der Resume-Hook setzt den Leerlauf-Zähler zurück. Nach dem Magic Packet vergehen einige Sekunden, bis Ollama antwortet und das Modell geladen ist. Ohne das Zurücksetzen sähe der Timer einen alten Zeitstempel und würde den PC sofort wieder einschlafen lassen. Der Zeitstempel liegt in
/run, nach einem Reboot beginnt der Zähler neu. power_agent_wake_only_targets. Der PC steht nicht incluster_power_manager_workers: Der Last-Watchdog würde ihn sonst wie einen Worker behandeln (wecken bei Last, herunterfahren). Das Ziel ist nur für/wakeim power-agent bekannt. Einträge ohne MAC fallen ausTARGETSheraus, solangehost_vars/ollama-pcfehlt.
thermal_watchdog und resource_watchdog
Server nur mit Alarm. resource_watchdog_action (poweroff oder notify) unterscheidet Worker von den k3s-Servern. group_vars/k3s_servers.yml setzt notify: Bei 90 % CPU/RAM über 300 s kommt eine ntfy-Meldung (Priorität 5, höchstens einmal je resource_watchdog_alert_repeat_seconds), der Host bleibt in Betrieb. Der Homeserver hat zuvor selbst abgeschaltet, das hätte bei etcd ein Mitglied entfernt. Schutz vor echtem Ressourcendruck liefern auf den Servern die Kubelet-Reserven und die Eviction-Schwelle (k3s_kubelet_*) sowie thermal_watchdog bei Überhitzung.
- Der
thermal_watchdogliest/sys/class/hwmondirekt (ohne Prometheus/k8s) und fährt den Host herunter, wenn der heißeste
SensorTHRESHOLD_CfürSUSTAIN_SECONDSerreicht (90 s = Mitte der gewünschten 1–2 Minuten), vorher geht eine ntfy-Meldung raus.
Er läuft bewusst unabhängig vom Cluster, damit der Schutz auch greift, wenn der Cluster wegen der Hitze schon klemmt. Er
ergänzt den Alert ab 95 °C über 3 Minuten (60060). - Die ntfy-Meldung geht per HTTPS (
https://ntfy.tech.homeserver/<Topic>, Port 443) hinaus und wird percurl --resolvedirekt auf die statische Server-IP aufgelöst, damit sie auch rausgeht, wenn auf dem
Host kein*.homeserver-DNS eingerichtet ist. DRY_RUN=1(z. B.systemctl edit --runtime thermal-watchdog) testet den kompletten Pfad Erkennung → Meldung, ohne auszuschalten.- Der
resource_watchdogist das Gegenstück für CPU/RAM (Schwelle 90 %): IstWARN_THRESHOLDleer, entfällt die Vorwarnstufe.
Auch diese Schwelle läuft nicht über Alertmanager, sondern lokal. - Die Meldung an ntfy trägt einen Publisher-Token, falls
/etc/ntfy-publisher/auth-headerlesbar ist. Die Skripte (thermal-watchdog,resource-watchdog,
cluster-power-manager,nightly-worker-wake) geben den Header percurl -H @Dateimit, nicht als Argument oder Umgebungsvariable: so steht der Token weder inps
noch insystemctl show. Fehlt die Datei, senden sie anonym weiter (sonst hinge die Reihenfolge Rolle → ntfy-Umstellung an einem Zeitpunkt). Die Datei schreibt die Rolle
ntfy_publisheraus der Vault-Variablentfy_publisher_token, sie ist in allen Playbooks mit Watchdogs vor diesen eingetragen (Tagntfy-publisher). Ist die Variable
nicht gesetzt, überspringt die Rolle den Schreib-Task, ein bestehender Header bleibt liegen. - HTTPS ist Pflicht (Vorfall 2026-09-13 bis 2026-10-18). Der TECH-Traefik leitet HTTP global per
308um;curlfolgt dem ohne-Lnicht,--failgreift erst ab Status 400 und|| trueverschluckte jeden Fehler.
Alle vier Skripte (thermal-watchdog,resource-watchdog,cluster-power-manager,nightly-worker-wake) hatten deshalb seit dem 13.09. keine einzige Meldung zugestellt, ohne dass ein Dienst einen Fehler zeigte.
Sie nutzen jetzt--resolve "${NTFY_HOST}:443:${NTFY_IP}"(weiterhin ohne DNS) und prüfen das Zertifikat mit--cacert "$NTFY_CA_FILE"(Standard/etc/ntfy-publisher/ca.pem). Die Datei legt die Rolle
ntfy_publisherauspki/homeserver-root-ca.pemab (ntfy_publisher_ca_src), nur diese Datei, nicht der System-Trust-Store: So geht es auch auf worker-0 und worker-1 ohneupdate-ca-certificates.
Ein Fehlschlag steht jetzt im Journal (logger -t <skript> "ntfy-Meldung fehlgeschlagen"), der Dienst läuft weiter (die Abschaltlogik darf nicht an einer Meldung hängen). Der Token verlässt den Host damit verschlüsselt. - Mehrere Rollen haben einen Kill-Switch (
*_enabled: false, z. B. inhost_vars), um sie auf einem Host abzuschalten, ohne die
Rolle aus dem Playbook zu nehmen:thermal_watchdog,vmagent,node_exporter,smartctl_exporter,wake_on_lan,
worker_apt_updateundxibo_kiosk. - Die Abschalt-Tasks („… deaktivieren, falls
*_enabledfalse“) tolerieren nur eine fehlende Unit ('Could not find'in der
Fehlermeldung des systemd-Moduls), nicht jeden Fehler. Vorbild ist der Task „nicht benötigte dienste stoppen und deaktivieren“
incommon. Ein pauschalesfailed_when: falsehatte z. B. ein fehlgeschlagenesdaemon-reloadverschluckt.
Metriken, Logs und Zugang
vmagent, node_exporter und smartctl_exporter
- Metriken-Push für Tailscale-only-Hosts (Vereinsheim-Pi): Der Cluster kann sie nicht scrapen, weil Pods keinen Pfad zu
Tailscale-Peers haben (kein Subnet-Router ins Pod-Netz). Deshalb installiert die Rollevmagentals statische Binary (es gibt kein
Debian-Paket), scrapt lokalnode_exporterund pusht perremote_writean
argocd/apps/tech/monitoring/templates/ingress-vm-write.yaml.-remoteWrite.tmpDataPathpuffert lokal, falls das Ziel kurz
nicht erreichbar ist: Nichts geht verloren, es wird nur verzögert zugestellt. vmagent_remote_write_urlhat keinen Default, damit ein fehlender Wert laut auffällt, und musshttps://sein: Der
TECH-Traefik leitet HTTP global per 308 um. Mithttp://macht vmagent jeden Push in zwei Etappen, und die erste (Port 80) hängt
bei Bodies ab ~12 KB bis zum Timeout (gemessen vom Pi am 26.09.2026: 20 KB über HTTP 9–40 s oder Timeout, über HTTPS direkt ~1 s;
die vmagent-Blöcke sind ~20 KB groß). Gleiches Muster wie beijournal_upload_push_url.vmagent_remote_write_queues: 1: Der vmagent-Default ist 2× CPU-Kerne (Banana Pi: 8). Im Normalbetrieb sind es nur ~1 KB/s
(einnode_exporter-Scrape alle 30 s). Beim Nachliefern eines Backlogs (Stunden Ausfall) schicken 8 Queues aber gleichzeitig
Requests, die serverseitig je einen Insert-Slot von VictoriaMetrics halten (Default dort: 2) und so u. a.vmalertaussperren.
Eine Queue reicht für diese Datenmenge (siehe auchmaxConcurrentInsertsin 60060).- Die Binary kommt aus den GitHub-Releases von VictoriaMetrics, das Asset heißt
vmutils-linux-{arch}-v{version}.tar.gz. - Der Banana Pi M2 Ultra (Allwinner R40, Cortex-A7) ist reines ARMv7/32-Bit (kein aarch64), deshalb
vmagent_arch: arm, nicht
arm64. Der Installationspfad ist versioniert (/opt/vmagent-<version>) statt fix unter/usr/local/bin: Ein Versions-Bump legt
ein neues Verzeichnis an, statt eine möglicherweise noch laufende Binary zu überschreiben. node_exportergibt es als Rolle nur für Hosts außerhalb des k3s-Clusters. Cluster-Mitglieder bekommen ihn per DaemonSet aus
dem Chartvictoria-metrics-k8s-stack. Der Port steht nirgends in der Rolle: Exporter und Scrape nutzen den Default9100
(vmagent_node_exporter_portfür den lokalen Scrape).smartctl_exporternur für Hosts mit echter Hardware (homeserver, worker-0, worker-1): Die KVM-VMs sehen nur virtuelle
virtio-Platten ohne SMART, das NAS hat seinen eigenen Docker-Exporter. Der Exporter läuft als root (Zugriff auf/dev/sd*,
/dev/nvme*) und scannt alle Platten selbst (smartctl --scan). Er lauscht auf dem Default-Port9633des Ubuntu-Pakets
prometheus-smartctl-exporter, der Cluster scrapt ihn perVMStaticScrape.- Die Labels
hostundkindinvmagent-scrape.yml.j2sind die einheitlichen Filter-Labels der Hardware-Dashboards (20060).
Namensschema und Variablenvorrang
Der Inventar-Host und der k3s-Nodename sind getrennt: k3s_node_name (Standard inventory_hostname) speist node-name in der k3s-Config, die Vault-abhängige Variable hostname ist dafür nicht mehr zuständig. Ein k3s-Nodename lässt sich nicht ändern, eine Umbenennung wäre ein neuer Node mit verwaisten local-path-PVs. Deshalb setzt controlplane-0 weiter k3s_node_name: homeserver.
k3s_server_host und k3s_version des TECH-Clusters setzen group_vars/k3s_servers.yml und group_vars/k3s_agents.yml, beide aus k3s_cluster_server_host und k3s_cluster_version in group_vars/all.yml (eine Quelle). Eine Elterngruppe k3s_cluster wäre naheliegender, die statischen Inventories in Semaphore kennen sie aber nicht; dort fiele k3s_version auf den Leerwert aus all zurück und k3s würde auf den neuesten Stand des Kanals gehoben. PROD und ENTW behalten den Leerwert aus all. Details: 60010.
k3s_agent: Host-Firewall
k3s_agent_ufw_enable (Standard false, auf worker-1 true) schaltet UFW auf einem Worker scharf: Vollzugriff nur für k3s_agent_ufw_trusted_hosts (controlplane-0, controlplane-1), SSH aus dem LAN, Tailscale 41641/udp, Flannel aus dem LAN, Pod- und Service-Netz, default deny. Mit k3s_agent_ufw_vm_bridge: br0 kommt ufw route allow in on br0 out on br0 dazu: worker-1 betreibt die ENTW-VM über die Bridge, und weil net.bridge.bridge-nf-call-iptables=1 gesetzt ist, läuft deren Verkehr durch die iptables-FORWARD-Kette; ohne diese Regel (deny routed) wäre die VM vom LAN getrennt. Ohne den Schalter legt die Rolle nur die Regeln an, aktiviert aber UFW nie; bis zum 2026-10-18 stand worker-1 deshalb mit „inactive“ da, obwohl die Regeln vorgemerkt waren und ufw laut systemd active meldete. Vor dem Einschalten auf einem Worker: Backup von /etc/ufw, Rollback-Timer (systemd-run --on-active=15min ufw disable), danach zweite SSH-Session und Prüfung von Node-Status, Exportern und (worker-1) der ENTW-VM. Tailscale-Verkehr läuft über ts-input vor UFW und ist von den Regeln nicht betroffen. Auf worker-0 (ohne VM-Bridge, aber mit Docker-Containern) ist der Schalter ebenfalls an; die Rolle entfernt dort die älteren offenen Regeln (LAN mit Vollzugriff, SSH von überall, kubelet aus dem LAN). Dockers veröffentlichte Ports (3002, 3003, 8001, 18080) laufen über Dockers eigene NAT-/FORWARD-Regeln und sind von den UFW-Eingangsregeln unabhängig.
journal_upload
- HTTPS und Port sind Pflicht, siehe 300j0. Der TECH-Traefik leitet HTTP per 308 um, und
systemd-journal-uploadfolgt keiner Weiterleitung („Upload … failed with code 308“). Mit der früherenhttp://-URL kam von
keinem Host ein Journal an (Vorfall 2026-09-20). Ohne Port hängtsystemd-journal-uploadselbst:19532/uploadan (Pfad
/insert/journald:19532/upload, den VictoriaLogs nicht kennt), mit:443wird nur/uploadangehängt. - Das Server-Zertifikat wird gegen die interne Root-CA geprüft, aber es wird kein Client-Zertifikat verwendet. Ohne diese beiden
Zeilen versucht der Dienst bei HTTPS/etc/ssl/certs/journal-upload.pemzu laden und bricht ab („could not load PEM client
certificate“). Der Hostname muss in der SAN-Liste voncertificate-homeserver-wildcard.yamlstehen, ein Wildcard-Zertifikat gibt es
nicht (60040). - Namensauflösung ohne DNS-Abhängigkeit: worker-0/worker-1 lösen
*.homeservernicht auf (kein dnsmasq als Resolver), die
Pis nur über Tailscale-Split-DNS. Ein fester/etc/hosts-Eintrag auf die LAN-IP des Homeservers macht den Upload unabhängig davon.
Nur abschalten, wenn der Host*.homeserverzuverlässig per DNS auflöst. Der Default127.0.0.1stimmt nur auf dem Homeserver und den
k3s-Knoten (dort leitet ServiceLB Port 443 an Traefik). Auf Hosts außerhalb des Clusters (Pis, Infotafel) zeigt er ins Leere: Der Upload
scheiterte dort mit „Failed to connect … port 443“. Diese Gruppen setzen deshalbjournal_upload_hosts_entry_ip: "192.168.178.94"in
group_vars/banana_pis.ymlundxibo_displays.yml. Auch der DNS-Weg hilft nicht: Der Eintrag127.0.0.1 logs-write.tech.homeserversteht
in/etc/hostsdes Homeservers, und Pi-hole/dnsmasq liest diese Datei und liefert den Namen allen DNS-Clients mit127.0.0.1aus. - Neustart-Drop-in (Vorfall 2026-10-16 bis 2026-10-18): Der Dienst gibt nach fünf schnellen Fehlschlägen auf („Start request repeated too
quickly“) und bleibtfailed. Ein Drop-inrestart.conf(StartLimitIntervalSec=0,Restart=always,RestartSec=30) startet ihn
dauerhaft neu. Ursache des Ausfalls auf Homeserver und worker-1 war wieder das Backlog: Der Cursor stand auf dem 2026-10-02, danach
hatten sich 1,29 Millionen Einträge angesammelt, der Upload schickt sie in einem Request und bricht mit „Buffer space is too small to
write entry“ ab, ohne den Cursor zu bewegen. Jede längere Unterbrechung des Log-Endpunkts kann das auslösen. Behoben wird es durch das Setzen
vonLAST_CURSORin/var/lib/private/systemd/journal-upload/stateauf das Journal-Ende (journalctl -q -n 1 --show-cursor), danach
systemctl reset-failedundrestart; das Alt-Journal bleibt lokal, geht nur der zentralen Ablage verloren. Der AlarmJournalUploadFailed
(60060) meldet den Zustand nach 15 Minuten. - State-Datei (Vorfall 2026-09-24): Ohne State-Datei beginnt
systemd-journal-uploadam Journal-Anfang und schickt das
komplette Backlog als einen einzigen Request. Auf dem Homeserver (5 GB Journal) brach das jedes Mal mit „Buffer space is too small
to write entry“ / „operation aborted by callback“ ab, bevor je ein Cursor gespeichert wurde, eine Endlosschleife bis zum
Start-Limit, und kein Log kam an. Kleine Nachträge ab einem aktuellen Cursor laufen sauber durch. Deshalb setzt die Rolle bei
fehlendem State den Startpunkt auf das Journal-Ende. Die State-Datei liegt imStateDirectorydes Dienstes
(journal_upload_state_dir, wegenDynamicUserunter/var/lib/private/…), der Besitzer muss der (dynamische) Dienst-User sein
(„Failed to read state file: Permission denied“). Der Kopfzeilen-Text der Datei (# This is private data. Do not parse.) ist
Dateiinhalt und gehört dazu. - Reihenfolge: Das Zurücksetzen des Start-Limits (
systemctl reset-failed) und der Restart laufen perflush_handlersvor
„aktivieren und starten“, und der Handler zum Zurücksetzen steht inhandlers/main.ymlvor „systemd-journal-upload neu starten“
(Handler laufen in Definitionsreihenfolge, nicht in Notify-Reihenfolge). Ein im Start-Limit hängender Dienst lässt sich sonst nicht
neu starten.
semaphore_bootstrap, semaphore_secrets und semaphore_targets
semaphore_secretserzeugt das Bootstrap-Material idempotent (Access-Key-Verschlüsselungsschlüssel mit 32 Byte Base64, dediziertes
SSH-Schlüsselpaar für Semaphore → Ziele) und legt es als Secretsemaphore-bootstrapim Namespacesemaphoreab. Das von ArgoCD
verwaltete Deployment konsumiert es.semaphore_targetsträgt den Public Key auf den Zielhosts ein.semaphore_bootstrapprovisioniert per REST-API idempotent (GET-Liste, POST nur wenn die Ressource fehlt). Stolpersteine:- Umgebung pro Template: Semaphore ab v2.18 entfernt beim Start von Ansible-Tasks das Container-Environment. Variablen wie
ANSIBLE_VAULT_PASSWORD_FILEerreichen den Playbook-Prozess nur über ein Environment pro Template. Ohne das lassen sich
verschlüsselte Variablen in Semaphore-Läufen nicht entschlüsseln. Das Feldenverwartet die API als String-JSON, deshalb
wird das Dict perto_jsonkodiert. - Typen bleiben nativ: Body als ein Jinja-Dict bauen und per
body_format: raw+to_jsonsenden.body_format: json
serialisiert"{{ x | int }}"als JSON-String, und Semaphores strikter Go-Decoder antwortet mit HTTP 400 (z. B.ssh_key_id,
project_id). - Repository (
git_url,git_branch) wird bei Abweichung per PUT nachgezogen. Ohne das behielt ein vorhandenes Repository
home-server-gitnach der Aufspaltung die URL von capulus-core, während die Templates schon aufsite.ymlundcontrolplane-1.yml
zeigten, die dort nicht mehr liegen: Semaphore fand das Playbook nicht (Stand 2026-10-19, Nachprüfung
600b0). - Schedules (
cron) sind self-healing: existiert der Name schon, wird der komplette Body per PUT neu gesetzt. Sie laufen in
SEMAPHORE_SCHEDULE_TIMEZONE(Europe/Berlin),0 6 * * *feuert also ganzjährig um 06:00 Ortszeit. - HTTPS ist Pflicht für
semaphore_api_base: Der TECH-Traefik leitet HTTP per 308 um, undansible.builtin.urifolgt einem
308 bei POST nicht („Status code was 308 and not 200, 204“ beim Login), während GETs wie/api/pingstill durch die
Weiterleitung liefen. Das Zertifikat wird gegen die interne Root-CA im System-Vertrauensspeicher geprüft (installiert von der Rolle
journal_upload), und der Hostname steht in der SAN-Liste des Zertifikats. - Semaphore hat einen zweiten Ingress (
semaphore-api.tech.homeserver), weil die Rolle die REST-API ohne Browser-Session
anspricht (60040).
- Umgebung pro Template: Semaphore ab v2.18 entfernt beim Start von Ansible-Tasks das Container-Environment. Variablen wie
wireguard_backup
Kernel-WireGuard über wg-quick, unabhängig von Tailscale (Userspace tailscale0 samt Tailscales Koordinations- und
DERP-Servern). Er dient nur als Notzugang, falls die Tailscale-Control-Plane ausfällt (c0011).
- Tunnelnetz
/24mit Platz für weitere vertrauenswürdige Geräte, aber jeder Peer bekommt seine eigene/32inAllowedIPs: Peers
erreichen einander nicht, nur den Server. - Das Server-Schlüsselpaar wird einmal erzeugt und wiederverwendet. Eine Neuerzeugung würde den öffentlichen Server-Key ändern und
jeden bereits konfigurierten Peer stillschweigend brechen. - In UFW wird nur der UDP-Port freigegeben, es gibt bewusst keine
FORWARD-/NAT-Regeln (PostUp/PostDownfehlen absichtlich):
Der Tunnel erreicht nur den Server selbst (SSH, kubectl, ArgoCD), er ist kein LAN-Subnet-Router wie die von Tailscale beworbene
Route. Das lässt die UFW-Forward-Chain unangetastet, auf die k3s/Flannel angewiesen sind. - Warum Port 51888 und nicht 443: 60010.
Alarmierung
alert_caller
Telefon-Alarm für eine externe VM (noch nicht ausgerollt, heute läuft der Caller als Pod, siehe 60040): systemd-Dienst alert-caller (Python, nur Standardbibliothek), der Alertmanager-Webhooks in einen Anruf per SIP verwandelt. caller.py liegt
im Chart argocd/apps/tech/alert-caller/src/ und wird von der Rolle von dort kopiert (eine Quelle für beide Betriebsarten). Playbook capulus-ansible/alert-caller.yml, Inventar-Gruppe alert_callers, Make-Targets alert-caller und alert-caller-check.
Bedienung, Einrichtung und Testplan: 10020. Routing und Regeln: 60060.
- Playbook und Tailscale: Die Overrides für Tailscale (
tailscale_hostname, keine Subnetz-Route) stehen inhost_vars/alert-caller-vm, nicht ingroup_vars/alert_callers.yml. Derhomeserverkann als Fallback in der Gruppe stehen, und ein
tailscale_advertise_routes: ""auf Gruppenebene würde ihm beim nächsten Lauf die Subnetz-Route nehmen. baresipwird aus den Quellen gebaut (reundbaresipim selben Tagalert_caller_baresip_version, Installation nach/opt/baresip). Das Paket aus Ubuntu (1.1.0 in 26.04, getestet, und 1.0.0 in 22.04/24.04 mit demselbenlibre-Stand von 2021, nicht getestet) kann sich bei
sip.linphone.orgnicht anmelden: Der Flexisip-Server (2.6.1) schickt zweiWWW-Authenticate-Header, SHA-256 vor MD5. Die altelibrebeherrscht nur MD5, verweigert die erste Challenge mitENOSYS, und die Registrierung endet mit
„Function not implemented“.reab Version 4 kann SHA-256 (geprüft am 2026-10-11 mit v4.12.0: der Server antwortet auf einen erfundenen Benutzer mit403 Forbidden). Die Stempeldatei/opt/baresip/.built-<hash aus Version und Modulliste>macht den Build
idempotent, Löschen erzwingt einen Neubau.CMAKE_INSTALL_RPATHist nötig, sonst findet die Binärdateilibbaresip.sonur mitLD_LIBRARY_PATH.-DMODULESbaut nur die benötigten Module.libreundbaresipwerden gepatcht (Listenalert_caller_libre_patchesundalert_caller_baresip_patches, Dateien inargocd/apps/tech/alert-caller/patches/):sips:-Routen und SRTP-Suitenwechsel (ICE-Patches wurden getestet und wieder entfernt, siehe 60040). Begründungen und Messwerte: 60040. Der Hash aller Patches fließt in die Stempeldatei ein, ein geänderter Patch löst einen Neubau aus. Diegit-Aufgabe nutztforce: true, sonst bricht der zweite Lauf an den gepatchten Dateien ab. Die Rollenänderung ist nur syntaxgeprüft und gelintet, nicht neu auf einem Host ausgerollt. Der Caller wartet nach dem Abheben auf den Medienstart (ICE_TIMEOUT,alert_caller_ice_timeout).- Modulliste (
templates/baresip-config.j2) weicht von der Aufgabe ab, jeweils aus einem Testlauf:stdiobleibt drin, aber nur mit einer Pipe als stdin. Mit/dev/null(Standard unter systemd) scheitert es mitepoll_ctl: Operation not permitted. Der Caller startet baresip deshalb mitstdin=PIPEund schreibt/dial …hinein.
-e "/dial …"taugt nicht: Es wählt sofort beim Start, und vor der Registrierung kann das Medien-Socket keine Adressfamilie bestimmen (stream: failed to create socket for media 'audio',af=AF_UNSPEC). Mit IP-Konten ohne Registrierung geht es, mit
sip.linphone.orgnicht. Erkannt wird die Registrierung an der Logzeile{0/TLS/v4} 200 Registration successful(baresip 4.12 schreibtv4, nichtIPv4, mit dem echten Konto gesehen), ihr Scheitern anreg: … (prio 0): 403 ….accountist neu: Seit baresip 1.0 lädt dieses Modul die Dateiaccounts. Ohne es gibt es kein Konto (could not find UA for sip:…).accountsteht zuletzt: Es legt die Konten beim Laden sofort an,iceundsrtpmüssen dann schon geladen sein, sonstmedianat not found: 'ice'.auresampist neu: In baresip 4 ist der Resampler ein eigenes Modul. Ohne es bleibt der Anruf stumm, weil die Quelle 16 kHz liefert und der Codec PCMU 8 kHz erwartet (RTP-Zähler dauerhaftaudio=0/0, aufgezeichnete Datei still).- STUN: Der Server von Linphone (
stun.linphone.org, oRTP 0.99) antwortet mit RFC-3489-Attributen, die libre ablehnt (Protocol error [71]). Der Standard ist deshalbstun.cloudflare.com:3478(alert_caller_stun_server). audio_alertzeigt ebenfalls aufaufile, damit baresip auf der Maschine ohne Soundkarte keinen ALSA-Fehler beim Rufton wirft.
- TLS:
sip_verify_server yesundsip_cafile(System-CA) prüfen das Zertifikat des Servers. Dertransport=tlsder Konto-Adresse gilt auch für den INVITE: baresip hängt ihn an die Ziel-URI (geprüft mittransport=tcp, Log
connecting to 'sip:…;transport=tcp'), die Ziele inCALL_TARGETSbrauchen ihn nicht. - Auflegen: baresip 1.1 legt am Ende der Audiodatei auf, baresip 4.12 nicht. Der Caller legt deshalb selbst auf (Länge der Ansage plus 3 s nach der Annahme).
-tist nur die Obergrenze (CALL_RING_TIMEOUT+ Länge + 5 s). Ein festes-t 60würde
lange Ansagen abschneiden: Drei Alarme in dreifacher Wiederholung sind rund 50 s. Annahme und Ende erkennt der Caller an den LogzeilenCall establishedundCall with … terminated, einen fehlgeschlagenen Verbindungsaufbau anua_connect failed. Bei einem baresip-Update prüfen, ob der Wortlaut gleich geblieben ist. Ein Ziel darf höchstens
CALL_RING_TIMEOUTklingeln, dann kommt das nächste. - Geheimnisse: Die Umgebungsdatei liegt
root:rootmit0600,accounts(mit Passwort)root:alert-caller-cfgmit0640. Der Dienst läuft alsDynamicUserund liestaccountsüberSupplementaryGroups=alert-caller-cfg,caller.pykopiert beide Dateien beim
Start nach/run/alert-caller/baresip(RuntimeDirectory), weil baresip in sein Konfigurationsverzeichnis schreibt. Die Gruppe darf nichtalert-callerheißen:DynamicUser=legt selbst eine Gruppe mit dem Namen der Unit an, eine gleichnamige statische Gruppe
endet mitstatus=217/USER(User or group with specified name already exists).LoadCredential=wurde verworfen, weil es im Testcontainer nicht funktionierte (/run/credentials/…blieb leer), auf einem echten Host wäre es vermutlich gegangen. Das Passwort darf kein;,"oder Leerzeichen enthalten, die Kontozeile wird nicht maskiert (die Rolle prüft das). - Webhook: Die Antwort kommt sofort, Synthese und Anruf laufen in eigenen Threads, weil Alertmanager Webhooks nach 10 s abbricht und erneut sendet. Ein Lock macht die Anrufe sequenziell. Der Port hat keine Authentifizierung, der Schutz ist wie beim
power_agent
die Netzgrenze: UFW lässt 9310 nur ausalert_caller_webhook_sources(Tailnet) durch. - Pause und Alarm-Gruppen: Die Pause (
CALL_COOLDOWN) gilt jegroupKeyund zieht 30 s Toleranz ab. Alertmanager wiederholt in Takten vongroup_interval, der Zeitstempel kann um Millisekunden vor dem Ablauf liegen, und der Anruf käme sonst erst
eine Runde (5 min) später. Ein Alarm mit unbekanntem Fingerprint in der Gruppe hebt die Pause auf, sonst bliebe ein zweiter Ausfall bis zu 15 min stumm. - Watchdog: Der Startzeitpunkt zählt als letzter Ping, nach einem Neustart des Callers hat der Cluster also 10 min Zeit. Pro Ausfall gibt es genau einen Anruf, ein neuer Watchdog setzt zurück. Der Ping an healthchecks.io wird nur weitergegeben, wenn ein Watchdog
ankommt: Fällt der Cluster oder der Caller aus, bleibt der Ping aus. - Label-Fallback:
ansage,grund,summaryundkontext*werden auch aus den Labels gelesen.amtool alert add … summary="…"legt sie als Labels an, nur--annotation=erzeugt Annotationen. So funktioniert der manuelle Test wie dokumentiert. - Statischer Modus für den Pi (
alert_caller_static_announcement: true, Gruppealert_caller_pi): Der Caller spielt statt Piper die vorab erzeugte WAVfiles/cluster-down.wavab (STATIC_ANNOUNCEMENT), dennonnxruntimeund damit Piper gibt es für armv7l nicht./alertantwortet in diesem Modus mit 404, weil jeder Alarm sonst die feste Ansage bekäme.alert_caller_manage_firewall: falselässt UFW unberührt (der Pi hat bisher keine UFW-Konfiguration aus Ansible, ein erstmaliges Einschalten wäre ein Risiko für den Kiosk),alert_caller_build_jobs: 2schont den Speicher beim Bauen von baresip.alert_caller_hc_uuidist optional. Details und Ausrollen: 10020. - Ohne Sprachsynthese: Schlägt Piper fehl, spielt der Caller einen Warnton (
sox synth). Ein Anruf ohne Text ist besser als keiner. - Firewall: Die Rolle setzt UFW (SSH zuerst, dann
default deny incoming, damit sich niemand aussperrt). Der RTP-Bereich in UFW, inbaresip-config.j2und in der Oracle-Security-List muss derselbe sein. - Zugriffsschutz auf dem Pi:
alert_caller_token(ausvault_alert_caller_token, Standard leer) undalert_caller_auth_mode(logoderenforce) landen inalert-caller.env(0600). Die Rolle bricht ab, wenn der Modusenforceohne Token gesetzt ist. Der Pi bekommt
vom Alertmanager nur/watchdogund ist der Totmann bei einem Totalausfall des Clusters. Ist der Token im Modusenforcefalsch, bleibt der Timer unberührt, und der Pi ruft nachWATCHDOG_TIMEOUTselbst an (ein lauter Fehler, kein stiller). Einführung und Rotation: 10020.
Sonstiges
k3s: embedded etcd
Planung und Runbook: 400a0.
- Zwei Mitglieder sind nicht ausfallsicherer als eins. Die k3s-Doku verlangt eine ungerade Zahl Server. Fällt bei zwei Mitgliedern einer aus oder startet neu, hat der andere kein Quorum und die API ist weg, die Pods laufen weiter. Deshalb prüft
k3s_reboot_guardvor jedem Neustart und Upgrade den Peer, und die Snapshots sind der Weg zurück. - Timeouts 500/5000 ms. etcd empfiehlt Heartbeat etwa 0,5–1,5 × RTT und Election-Timeout mindestens 10 × RTT, beides auf allen Mitgliedern gleich. Über Tailscale mit DERP-Relay sind bis ca. 300 ms RTT realistisch. Die LAN-Defaults (100/1000 ms) würden bei ControlPlane-2 zu Leaderwechseln führen. Preis der größeren Werte: eine Leaderwahl dauert bis zu 5 s länger. Weil alle Mitglieder dieselben Werte brauchen, stehen sie schon jetzt in der Config.
- Der Server-Token ist
server/token, nichtnode-token(beide sind gleich, solange keinagent-tokengesetzt ist). Die Rolle liest ihn zur Laufzeit vom Primärserver und legt die Config des Beitretenden mit0600ab. Im Dry-Run und im Diff wird die Datei mitno_logausgeblendet. - Kein automatischer Neustart. Wie bisher schreibt die Rolle nur die Config.
cluster-initundtls-sanwirken erst nach einem bewusstensystemctl restart k3s. Dadurch ist der Zeitpunkt der Konvertierung eine Entscheidung im Wartungsfenster, auch wenn der tägliche Semaphore-Lauf die Config schon früher schreibt. k3s_versionist ingroup_vars/k3s_servers.ymlundgroup_vars/k3s_agents.ymlfestgeschrieben, nicht inall.yml. Dort leer (""mitauto_upgrade: true) hieße „bei jedem Lauf die neueste Version im Channel“ und liefe auf den Servern auseinander. Ein Pin inall.ymlgälte auch fürprod-vmundentw-vm.- Taint
PreferNoSchedulestattNoSchedule: Die DaemonSets node-exporter und ServiceLB hätten sonst eigene Tolerations gebraucht, ohne node-exporter fehlen die Hardware-Metriken. Der weiche Taint ist nur ein Score-Malus, bei Platzmangel landen Pods trotzdem dort (Alarm in AP4). Einnode-taintin der Config wirkt nur bei der Registrierung, der neu beigetretene Node bekommt ihn deshalb sofort. - UFW:
k3s_agent/tasks/ufw.ymllöscht die offene 6443-Regel. Auf controlplane-1 legt die Rollek3sihre Regeln mit Quelladresse davor an und importiert die Agent-Firewall erst danach, sonst könnten sich andere Server aussperren. 2379–2380 sind nur von den anderen Servern offen (k3s_ufw_etcd_extra_peersfür ControlPlane-2). - Eigene
resolv.conffür kubelet und CoreDNS. Auf controlplane-1 lauteten die Nameserver bisher1.1.1.1,8.8.8.8und die IPv6-Adresse der Fritzbox, ohne den dnsmasq (die dnsmasq-Rolle läuft nur auf controlplane-0). Seit dem zweiten CoreDNS-Replikat (dnsPolicy: Default) hatten die beiden CoreDNS-Pods unterschiedliche Upstream-Listen (controlplane-0 mit dnsmasq, controlplane-1 ohne). Welche Namen der dnsmasq beantwortet, lässt sich aus dem Cluster heraus nicht verlässlich vorhersagen: Der Kurznameugreen-nas(address=im dnsmasq) löst auf dem Host auf, aus einem Pod aber auch bei direkter Frage an192.168.178.94nicht (NXDOMAIN, getestet 2026-11-05). Die Ursache ist offen, im Cluster nutzt niemand den Kurznamen (Scrape-Ziele und NFS-Pfade verwenden die IP).systemd-resolvedschreibt in/run/systemd/resolve/resolv.confden dnsmasq (DNS=), die Gateway-Adresse (FallbackDNS=) und die Netplan-Nameserver. Das sind mehr als drei Einträge, Pods nehmen höchstens drei, kubelet meldete das bei jedem CoreDNS-Sync alsDNSConfigForming … Nameserver limits were exceeded(angewendet wurde192.168.178.94 1.1.1.1 8.8.8.8). Mitk3s_resolv_nameserversschreibt die Rolle genau diese drei in/etc/rancher/k3s/resolv.conf, das Verhalten bleibt gleich und die Warnung entfällt. Der Pfad (resolv-conf) ist ein kubelet-Argument und wirkt erst nach einem Neustart von k3s, CoreDNS und andere Pods lesen die Datei beim Start. Nachteil: Die Datei folgt DHCP-Änderungen nicht mehr, die Nameserver stehen in der Rolle. - Nodename
controlplane-1ist neu. Nach dem Entfernen vonworker-0registriert sich der Server unter neuem Namen. PVs mit Affinität aufworker-0wären verwaist, das Runbook verlangt dazu eine Inventur.
k3s: Modus der Kubeconfig
write-kubeconfig-mode: "0600"./etc/rancher/k3s/k3s.yamlenthält ein Client-Zertifikat samt Schlüssel der Gruppesystem:masters(cluster-admin). Mit0644machte ein Lesezugriff jeden lokalen Account
oder jeden Container mit Host-Mount zum Cluster-Admin. Die Rolle kopiert die Datei außerdem für den Ansible-Benutzer nach~/.kube/config(Modus0600), und/etc/environmentsetztKUBECONFIGdarauf.
Interaktiv und in Skripten läuft deshalb alles über diese Kopie oder übersudo k3s kubectl, nicht über die Systemdatei.cluster-power-manager,nightly-worker-wakeundpower-agentlaufen als root.- Die Rolle startet k3s nicht neu. k3s liest
config.yamlund schreibtk3s.yamlnur beim Start. Eine Änderung des Modus über den Ansible-Lauf allein greift deshalb erst beim nächsten Neustart. Für die sofortige Wirkung
daschmod 0600einmal von Hand setzen (und die Zeile inconfig.yamlangleichen, damit ein späterer Start nicht wieder0644schreibt), statt k3s dafür neu zu starten. - Wer sonst die Datei lesen muss, braucht
sudooder eine eigene Kopie (sudo install -m 0600 -o <user> /etc/rancher/k3s/k3s.yaml ~/.kube/config). Eine Sicherungskopie der Datei darf nie weiter geöffnet sein als das Original.
k3s: Templates k3s-config.yaml.j2 und audit-policy.yaml.j2
resolv-conf. Ubuntu stellt/etc/resolv.confpersystemd-resolvedauf den Stub127.0.0.53, der aus dem Pod-Netz nicht erreichbar ist. CoreDNS bekäme damit keine Upstream-Server und könnte externe Namen (github.comusw.) nicht auflösen. Welche Datei stattdessen gilt, steht oben unter „Eigeneresolv.conffür kubelet und CoreDNS“.secrets-encryption: true(Härtung Phase 4, d0010, d0050) verschlüsselt Secrets im k3s-Datastore selbst. Sealed Secrets schützt nur den Git-Zustand, ohne das Flag liegen entschlüsselte Secrets im Klartext auf der Platte. Die Zeile allein aktiviert nichts, weil k3sconfig.yamlnur beim Start liest. Erst ein bewusstersudo systemctl restart k3smit vorherigem Backup und anschließendemrotate-keys(Ablauf in d0050) setzt sie um.- Audit-Log des kube-apiservers (Härtung Phase 4). Die Policy legt der Task „audit-policy für kube-apiserver templaten“ in
roles/k3s/tasks/main.ymlunter/etc/rancher/k3s/audit-policy.yamlab. Die Aufbewahrung ist bewusst begrenzt (14 Tage, 5 Sicherungen, 100 MB je Datei): genug, um einen Vorfall nachzuvollziehen, ohne die lokale SSD unbegrenzt wachsen zu lassen. - Audit-Policy schlank statt „RequestResponse für alles“. Ziel ist nachzuvollziehen, wer was wann geändert hat. Dafür reicht
Metadata(Zeitstempel, Benutzer, Verb, Objekt, ohne Body), ein vollständiger Mitschnitt jedesGET/LIST/WATCHwürde die SSD füllen. Die Regeln im Einzelnen:- Lesender Verkehr (
get,list,watch) ist komplett ausgeschlossen: größter Log-Anteil, praktisch nie sicherheitsrelevant (Grafana, vmagent und ArgoCD fragen ständig ab). - Verkehr des Systems (
system:nodes, ServiceAccounts inkube-system, Health-/Readiness-Checks, Discovery) ist Rauschen ohne Sicherheitswert. - Secrets und ConfigMaps nur auf
Metadata, nichtRequestResponse: Sonst landeten die Secret-Inhalte im Audit-Log und hebelten die Verschlüsselung im Datastore aus. - RBAC-Änderungen (wer bekommt oder verliert Rechte) und
pods/exec,pods/attach,pods/portforward(interaktiver Zugriff in Container) werden protokolliert. - Alles andere läuft als Auffangregel auf
Metadata, das deckt auch künftige Änderungen an NetworkPolicies (d0030) ab, ohne je Ressourcentyp eine Regel zu brauchen.
- Lesender Verkehr (
- Kubelet-Reserven (
k3s_kubelet_memory_protection_enabled).system-reservedundkube-reservedhalten RAM für Betriebssystem, kubelet und containerd frei, damit Speicherdruck der Pods nichtsshdodertailscaledtrifft. Dieeviction-hard-Schwelle liegt bewusst unter den 90 % desresource_watchdog: Der Kubelet räumt oder OOM-killt betroffene Pods, bevor der Watchdog reagiert, Kubernetes bekommt so zuerst die Chance zu einer geordneten Reaktion (20020, Mehrschichtiger RAM-Schutz).
cups_print_server
Macht einen USB-Drucker am Homeserver per CUPS im Heimnetz und Tailnet verfügbar (IPP/AirPrint für Handys und Tablets, IPP für Windows/Linux, Anleitung in
20040). Der Name der Druckerwarteschlange erscheint in CUPS-/IPP-URLs und darf deshalb keine Leerzeichen oder
Sonderzeichen enthalten. Der QPDL-Community-Treiber für die Samsung-Serie M2020/M2026 ist optional und wird gebaut. Die Warteschlange wird erst angelegt, sobald Device-URI und PPD
bekannt sind, dafür gibt es Debug-Tasks, die beides ermitteln.
crowdsec
Die Reihenfolge ist zwingend (d0020): Zuerst wird CrowdSec (LAPI und Agent) installiert, den Firewall-Bouncer installiert die Rolle erst danach, wenn
CrowdSec läuft. LAN und Tailscale stehen auf der Whitelist, damit sich niemand selbst aussperrt.
- Whitelist: CrowdSec bringt eine Whitelist für die RFC1918-Bereiche mit, der CGNAT-Bereich von Tailscale (
100.64.0.0/10) gehört nicht dazu und braucht einen eigenen Eintrag. Das LAN steht trotzdem ausdrücklich inwhitelist.yaml.j2, statt sich auf den genauen Inhalt der mitgelieferten Datei zu verlassen. - Quellen: SSH-Brute-Force erkennt CrowdSec aus dem systemd-Journal (
acquis-ssh.yaml.j2, Unitssh.service). Der Pfad des Traefik-Access-Logs (crowdsec_traefik_log_glob) hängt vom Log-Layout von k3s/containerd ab; nach dem Rollout prüfen, dass er wirklich auf eine Datei zeigt (d0020, Traefik-Log verifizieren).
libvirt_host: Bridge-Netplan
Die übrigen Hintergründe zur Rolle stehen in 60010.
bridge-netplan.yaml.j2ersetzt die direkte IP-Konfiguration auflibvirt_host_bridge_interfacedurch die Linux-Bridgelibvirt_host_bridge_name, an die libvirt-VMs mit eigener, im LAN direkt erreichbarer IP angeschlossen werden (40080, Baustein 5). Die Host-IP wandert von der physischen NIC auf die Bridge, der Host bleibt unter derselben IP erreichbar, nur über ein anderes Interface.ra-overrides: use-dns: false. Der Router kündigt per Router Advertisement zwei zusätzliche IPv6-DNS-Server an. Zusammen mit den festen Servern wären das vier, das kubelet erlaubt drei und meldete jede Minute „Nameserver limits were exceeded“. Auf den Hosts steht dasselbe zusätzlich als systemd-Drop-in/etc/systemd/network/10-netplan-br0.network.d/no-ra-dns.conf.
Installer und Prüfsummen (Incident 017)
Frühere Fassungen der Rollen luden Skripte und Archive ohne Prüfsumme und starteten sie als root: get.k3s.io, get-helm-3 vom Branch main, install.crowdsec.net, den vmutils-Tarball und das Cloud-Image.
Ein Kompromiss der Auslieferung hätte Codeausführung auf den Control-Plane- und Worker-Hosts bedeutet. Die Änderungen wirken erst beim nächsten Lauf der jeweiligen Rolle, bestehende Installationen bleiben unberührt.
| Quelle | Rolle | Schutz | Wo gepflegt | Erneuern |
|---|---|---|---|---|
| k3s-Installer (Server und Agent) | k3s, k3s_agent |
URL auf einen Commit von k3s-io/k3s plus checksum: |
k3s_installer_url, k3s_installer_sha256 in group_vars/all.yml (gemeinsam für beide Rollen) |
gh api 'repos/k3s-io/k3s/commits?path=install.sh&per_page=1' --jq '.[0].sha', dann curl -sL https://raw.githubusercontent.com/k3s-io/k3s/<sha>/install.sh \| sha256sum |
| Helm 3 | k3s |
Tarball von get.helm.sh, Prüfsumme live aus <Tarball>.sha256sum |
k3s_helm_release in roles/k3s/defaults/main.yml, Renovate öffnet den PR |
nur die Version ändern (Renovate oder von Hand) |
| vmutils-Tarball | vmagent |
checksum: je Architektur |
vmagent_sha256 in roles/vmagent/defaults/main.yml |
bei einer neuen vmagent_version: Tarball laden, sha256sum bilden und eintragen |
| Ollama-Installationsskript | ollama_pc |
Release-Tag plus checksum: |
ollama_pc_version, ollama_pc_install_script_sha256 in roles/ollama_pc/defaults/main.yml |
curl -sL https://raw.githubusercontent.com/ollama/ollama/v<version>/scripts/install.sh \| sha256sum |
| Ubuntu-Cloud-Image | libvirt_host |
datiertes Verzeichnis release-<Datum> plus checksum: |
libvirt_host_base_image_url, libvirt_host_base_image_sha256 in roles/libvirt_host/defaults/main.yml |
Hash steht in https://cloud-images.ubuntu.com/releases/resolute/release-<Datum>/SHA256SUMS |
| Tailscale-APT-Schlüssel | tailscale |
Fingerprint wird bei jedem Lauf geprüft | tailscale_signing_key_fingerprint in roles/tailscale/defaults/main.yml |
gpg --show-keys --with-colons --fingerprint <Datei> (Zeile fpr) |
| CrowdSec-APT-Schlüssel | crowdsec |
Schlüssel von packagecloud.io, Fingerprint wird bei jedem Lauf geprüft, Repository ohne Installationsskript |
crowdsec_repo_key_fingerprint in roles/crowdsec/defaults/main.yml |
wie Tailscale |
- Der k3s-Installer ist auf den Commit gepinnt, der heute von
get.k3s.ioausgeliefert wird (get.k3s.ioliefert deninstall.shvonmain, SHA-256 identisch). Das Verhalten ändert sich also nicht. Das k3s-Binary bleibt kanalgesteuert (k3s_channel: stable,auto_upgrade: true), der Installer prüft es selbst gegen die Prüfsumme des Releases. Ein Pin auf ein Release-Tag wäre ein älterer Stand des Skripts gewesen. - Helm:
helm_versionausgroup_vars/all.ymlhat keine Wirkung mehr. Statt bei jedem Lauf das neueste Helm zu holen, installiert die Rolle nur, wenn die installierte Version nichtk3s_helm_releaseentspricht (Version aushelm version --short). Die Prüfsumme kommt aus der Datei neben dem Tarball (checksum: sha256:https://get.helm.sh/…sha256sum): Das schützt vor beschädigten oder vertauschten Downloads, nicht vor einem manipuliertenget.helm.sh(dort käme die passende Prüfsumme mit). Ein fester Hash im Repo wäre stärker, ließe sich aber nicht von Renovate pflegen (der PR änderte nur die Version, die Rolle bräche mit einem Prüfsummenfehler ab, ohne dass die CI das sieht). - Fingerprints sind Trust-on-first-use. Weder Tailscale noch CrowdSec veröffentlichen die Fingerprints auf einer Seite, die sich als unabhängige Gegenprobe eignet. Gepinnt ist der Schlüssel, der am 2026-10-17 auf dem Homeserver installiert war und von APT akzeptiert wurde; der frisch geladene Schlüssel war byte-identisch (SHA-256 des Tailscale-Schlüsselbunds
3e03dacf…, des CrowdSec-Schlüsselbunds24a43f11…). Rotiert ein Anbieter den Schlüssel (CrowdSec hat das schon einmal getan), bricht der nächste Lauf mit „Fingerprint weicht ab“ ab, und du hebst den Wert bewusst an, nachdem du die Ankündigung des Anbieters geprüft hast. gpgauf den Hosts mit eigenem Verzeichnis. Die Prüfung läuft mit--homedirauf einem temporären Verzeichnis, das danach verschwindet. Ohne das legtgpgals root ein~/.gnupgan.- Check-Lauf (
--check) muss funktionieren. Im Check-Modus überspringt Ansiblecommandundtempfile; das Ergebnis vontempfilehat dann keinpath, und die Fingerprint-Prüfung brach mit „object of type 'dict' has no attribute 'path'“ ab (so gefunden beim ersten Check-Lauf gegen den Homeserver). Deshalb laufen das temporäre GnuPG-Verzeichnis, das Lesen des Fingerprints und das Aufräumen mitcheck_mode: false(rein lesend bzw. nur ein Temp-Ordner), und Lesen und Prüfen entfallen nur, wenn der Schlüssel auf einem frischen Host im Check-Lauf noch gar nicht existiert. Dasselbe gilt für die Helm-Versionsabfrage (check_mode: false).
Auch bestehende Tasks waren nicht check-fähig: Rein lesendecommand-Tasks, deren Ergebnis später inset_fact,whenoderdebuglandet, brauchencheck_mode: false, sonst fehltstdoutund der Folge-Task bricht ab (gefunden intailscale:tailscale status --jsonwurde übersprungen, die Rolle hielt Tailscale für getrennt und scheiterte amtempfiledes Auth-Key-Blocks). Betroffen warentailscale(Status, Finalstatus, IP),k3s(Version, Node-Status, Helm-Version, System-Pods),k3s_agent(Version) undcrowdsec(Bouncer-Liste). Der Auth-Key-Block der Rolletailscaleläuft im Check-Modus nicht.
Noch nicht auf Check-Fähigkeit geprüft sind die übrigen Rollen.unarchiveund das Setzen der Rechte laufen im Check-Modus nicht (die Quelldatei wird im Check-Lauf nicht heruntergeladen), der Download zeigt das ausstehende Update trotzdem als Änderung. Jede Änderung an diesen Tasks mit--checkund ohne testen. - CrowdSec-Repository ohne Skript. Die Rolle schreibt
/etc/apt/sources.list.d/crowdsec_crowdsec.listselbst. Der Inhalt ist byte-identisch zu der Datei, die das Skript angelegt hatte (260 Byte,debunddeb-srcmitsigned-by). Auf dem Homeserver ändert sich dadurch nichts. Die frühere Bedingung „nur wenncsclifehlt“ entfällt, die Schritte sind idempotent. - Nicht geändert:
auto_upgrade: truehält Pakete aus den APT-Repositories weiter aktuell, undansible.builtin.apt_repository(in ansible-core 2.25 entfernt, die Warnung ist vorhanden) bleibt bis zu einer eigenen Umstellung aufdeb822_repository.
common: ArgoCD-NodePort in UFW
ArgoCD hat keinen NodePort mehr (argocd_server_nodeport_enabled: false, siehe 60030). Die Rolle common löscht deshalb die früheren
UFW-Freigaben für 30080 (LAN, Tailnet, WireGuard-Notzugang) und 30443. Die Regeln hatten auch vorher nichts begrenzt, weil NodePort-Verkehr an UFW vorbeiläuft
(c0030).
ssh_hardening
- Das Drop-in heißt
00-hardening.conf, nicht99-….sshdübernimmt für jedes Schlüsselwort den ersten gefundenen Wert, undInclude /etc/ssh/sshd_config.d/*.confsteht oben in der Hauptdatei. Die cloud-init-Datei
50-cloud-init.confsetztPasswordAuthentication yes. Ein Drop-in mit höherer Nummer würde übersteuert und nichts bewirken. Die Rolle prüft deshalb nach dem Ablegen mitsshd -T, ob die neuen Werte tatsächlich gelten
(passwordauthentication no,permitrootlogin no,allowagentforwarding no), und bricht sonst ab. - Ablauf mit Selbstschutz: Drop-in ablegen,
sshd -t,sshd -Tprüfen, dannsystemctl reload ssh. Schlägt einer der Schritte fehl, entfernt die Rolle das Drop-in wieder und lädt nicht neu, damit ein späterer Neustart nicht
mit einer kaputten Konfiguration anläuft. Nierestart: Ubuntu startetsshdper Socket-Aktivierung (ssh.socket), ein Reload behält laufende Sitzungen. - Dry-Run:
sshd -tundsshd -Tlaufen mitcheck_mode: false, weil beide nur lesen. Ohne das überspringt Ansible sie im--check-Lauf, und die Prüfung aufpasswordauthentication noscheiterte fälschlich (Fund beim Dry-Run vonsite.yml, 2026-11-05). Im Dry-Run wird das Drop-in nicht geschrieben,sshd -Tzeigt dann den alten Stand. Deshalb läuft die Prüfung der wirksamen Werte nur außerhalb des Dry-Runs (when: not ansible_check_mode). - Werte:
PermitRootLogin no,PasswordAuthentication no,KbdInteractiveAuthentication no,MaxAuthTries 4,LoginGraceTime 20,X11Forwarding no,AllowAgentForwarding no,AllowTcpForwarding no. Vier statt drei Versuche, weil ein
Agent mit mehreren Schlüsseln und die Standard-Identitäten schon drei Fehlversuche erzeugen können („Too many authentication failures“).AllowTcpForwarding nobrichtssh -L,-D,ProxyJumpund VS-Code-Remote: Wer das braucht,
setztssh_hardening_allow_tcp_forwarding: truein denhost_vars. - Wer sich anmeldet: Auf keinem Host liegt ein Schlüssel für
root, und alle Dienste (Semaphore,cluster-power-manager, der n8n-Trigger, Ansible) melden sich alsubuntuper Schlüssel an. Die Vault-Dateien enthalten nur
become-Passwörter (sudo). Die Härtung ändert nichts an der Schlüssel-Anmeldung. - Neue Hosts: Den Schlüssel vor dem ersten Rollenlauf hinterlegen (
ssh-copy-id, siehe a0020), sonst sperrt sich der Admin mit dem Rollenlauf selbst aus. - Aufgenommen sind homeserver, controlplane-1, worker-1, prod-vm, entw-vm, die Kiosk-Pis (alarmmonitor, infotafel) über
banana-pi-kiosks.ymlundxibo-kiosks.yml,ollama-pcund die externealert-caller-vm(Tagssh-hardening,make ssh-hardening; ollama-pc fragt das sudo-Passwort ab). Auf dem Alarmmonitor stand
zuvorPermitRootLogin yesund Passwort-Login in der Hauptdatei hinter demInclude: Das Drop-in gewinnt trotzdem, weil derIncludeoben steht. Der Alarmmonitor hängt nur am Tailnet und hat keinen LAN-Fallback, ein Reboot ist
unzuverlässig (banana_pi_kiosk). Ein Fehler hieße Besuch vor Ort: Änderungen dort immer mit Rollback-Timer und geöffneter zweiter Sitzung. - Schlüssel mit
command=nie zum Testen aufrufen. Der Schlüssel descluster-power-managerist auf den Workern fest aufsudo poweroffgesetzt, ein Testaufruf mit beliebigem Befehl fährt den Worker herunter
(20020). Den Dienstweg belegt man über „Accepted publickey“ im Journal bei einem natürlichen Lauf, nicht durch einen eigenen Aufruf. - Änderungen an
sshdmit Netz: Kopie von/etc/ssh, Rollback-Timer (systemd-run --on-active=… sh -c 'rm -f …/00-hardening.conf && systemctl reload ssh'), eine zweite Sitzung offen halten, in einer neuen testen, erst dann den Timer stoppen.
Härtung aus dem Host-Audit vom 2026-11-14
ssh_hardeningläuft auch aufollama-pc. Auf Desktop-Ubuntu fehlt/etc/ssh/sshd_config.d/, die Hauptdatei enthält aber dasInclude. Ohne Verzeichnis scheitert dertemplate-Task mit „Destination directory does not exist“; die Rolle legt es deshalb an.ssh_hardening_allow_tcp_forwardingsteht auftrue, weil der Arbeitsplatz zuvor Tunnel erlaubte und die Härtung sie nicht ungefragt abschalten soll.ollama_pc: Härtung nur mit Schutzbedingungen.010-pela-nopasswdist eine leere Datei in/etc/sudoers.d, die Ansible nicht angelegt hat; sie wird nur entfernt, wenn sie leer ist, damit eine später befüllte Datei nie ungefragt verschwindet.rpcbindwird nur abgeschaltet, wenn kein NFS eingebunden ist (NFSv3 braucht ihn, siehe 038); auf den Servern bleibt er deshalb an. Pakete werden mitinstall_recommends: falseinstalliert, weilrkhuntersonst einen Mailserver nachzieht. Die Sperrliste (dccp,sctp,rds,tipc) gilt nur für den Arbeitsplatz, nicht für die k3s-Hosts. Die Entscheidung, ob TeamViewer laufen soll, bleibt beim Betreiber (ollama_pc_disabled_services, standardmäßig leer).k3s: Snapshot-Kopie hängt den NAS-Mount selbst ein. Am 2026-11-12 meldetemount.nfseine Sekunde nach dem Boot „Network is unreachable“. Die fstab-Optionennofail,_netdevlassen den Boot weiterlaufen, der Mount wurde danach aber nicht wiederholt, und jede 6-Stunden-Kopie auf control-plane-1 schlug mit „nicht eingebunden“ fehl. Das Skript versucht deshalb vor dem Fehlschlag einmalmount <Mount-Punkt>(45 s).x-systemd.automountwäre die systemd-Alternative, ändert aber das Verhalten der Prüfungmountpoint -qim Skript und wurde nicht gewählt.commonundcups_print_server: nur ungenutzte Dienste.ModemManagerundcups-browsedlaufen auf Servern ohne Bedarf und werden abgeschaltet. CUPS, SANE (sanedüberinetd), Avahi undrpcbindbleiben bewusst, weil Geräte im Haus über den Homeserver drucken und scannen und die NAS-Mountsvers=3nutzen (038). Nicht vorhandene Einheiten (Could not find …) werden übersprungen, damit die Rolle auf Hosts ohne diese Pakete nicht fehlschlägt.- Lint-Altlasten (ansible-lint 26.11, Profil
production). Drei Stellen wurden aus Lint-Gründen umgebaut, jeweils mit Absicht anders als der naheliegende Ansatz:k3s: Der Task, der den Mount-Punkt der etcd-Snapshots anlegt, ist entfernt.ansible.posix.mountmitstate: mountedlegt ihn selbst an. Einmode:amfile-Task wäre falsch gewesen: Bei eingehängter NAS-Freigabe würde Ansible die Rechte des NAS-Verzeichnisses ändern.ollama_pc: Die Prüfungtailscale debug prefs | grep -q …nutzt einen Here-String statt der Pipe (bash). Ein einfachesset -o pipefailhätte den Test gebrochen:grep -qbeendet früh,tailscalebekommtSIGPIPE, und die Pipe meldet Fehler, obwohlRouteAllgesetzt ist.k3s-upgrade.yml: Die Versionsprüfung läuft aufk3s_primarystatt mitrun_onceauf allen Servern. Sie liest ohnehin nurhostvarsaller Server, ein Host reicht.
restic_backup: aus bis zur Betreiberentscheidung. Ziel (externes Laufwerk oder Objektspeicher) und Passwort bestimmt der Betreiber; die Rolle bricht beirestic_backup_enabled: trueohne Repository oder Passwort ab, statt ein Backup ohne Ziel anzulegen. Das Passwort liegt als!vault-Wert im Repo und als0400-Datei des Benutzers auf dem Host.
vaultwarden_restore
Die Rolle stellt db.sqlite3, rsa_key.pem, Attachments und Sends aus der vaultwarden-backup-PVC (nachts vom Backup-CronJob auf
der NAS gefüllt) auf die vaultwarden-data-PVC zurück (300a0, 20010).
- Sicherheitsgurt: Ohne
-e force_restore=true(Make:make vaultwarden-restore FORCE_RESTORE=true) bricht die Rolle sofort
ab, statt versehentlich einen lebenden Tresor mit dem NAS-Backup zu überschreiben. Das Playbook ist aus demselben Grund nicht Teil
vonsite.yml: Ein automatischer Lauf bei jedem Deploy könnte Live-Daten überschreiben. - Der Hauptaccount samt aller Passwörter und des eigenen 2FA/TOTP ist danach automatisch wieder da, weil das alles Teil derselben
SQLite-Datei ist. Ein separater „User anlegen“-Schritt ist nicht nötig.
libvirt_host: Prüfungen im Dry-Run
Im Check-Mode führt ansible.builtin.command nichts aus, meldet aber rc: 0 mit leerer Ausgabe. virsh dominfo galt damit für jede VM als erfolgreich, und from_json auf der leeren Ausgabe von qemu-img info ließ make check abbrechen. Beide Befehle sind rein lesend und laufen deshalb mit check_mode: false; die Warnung zum Backing-File prüft zusätzlich, ob die Ausgabe leer ist. Allgemein gilt: Lesende command-Tasks, deren Ergebnis spätere Bedingungen steuern, brauchen check_mode: false, sonst bewertet der Dry-Run einen erfundenen Erfolg.
Review-Befunde vom 2026-11-15
- Secrets nie über feste
/tmp-Pfade oder--diff.cups_print_servererzeugt das TLS-Schlüsselpaar in einemtempfile-Verzeichnis und räumt es imalways-Zweig auf, der Schlüssel liegt mit0600unter/etc/cups/ssl/(cupsd liest ihn als root). Temp-Verzeichnis,opensslund Aufräumen laufen mitcheck_mode: false, weiltempfileim Dry-Run sonst kein Verzeichnis anlegt und die Folge-Tasks an der fehlendenpathscheitern; die Kopien nach/etc/cups/ssl/bleiben im Dry-Run simuliert, die Schlüssel-Kopie läuft mitdiff: false.semaphore_secretsreicht das Secret perkubectl apply -f -überstdinweiter statt über/tmp/semaphore-bootstrap-secret.yaml; ein älterer Lauf kann die Datei noch hinterlassen haben, die Rolle löscht sie.slurpvon Schlüsseln und Tokens (wireguard_backup,power_agent) läuft mitno_log, Templates mit Secrets mitdiff: false. - Release-Archiv ohne Variablen.
.gitattributesnimmtgroup_vars/undhost_vars/perexport-ignoreausgit archive. Das Release-Asset enthielt sonst alle!vault-Blöcke und erlaubte einen Offline-Angriff auf das Vault-Passwort. Im Git-Repo selbst bleiben sie natürlich sichtbar. group_vars/all.ymlist Klartext mit inline verschlüsselten Werten, nicht als Ganzes verschlüsselt.ansible-vault editfunktioniert darauf nicht;make vault-editöffnet die Datei im Editor,make vault-encrypt-string NAME=<variable>erzeugt einen!vault-Block. Die Klartextwerte sind unkritisch (IPs, Hostnamen, öffentlicher WireGuard-Schlüssel, Semaphore-Projekte).vaultwarden_restorestartet Vaultwarden immer wieder. Ein fehlgeschlagener Restore-Job ließ das Deployment vorher auf 0 Replicas stehen. Jetzt skaliert einalways-Zweig zurück, derrescue-Zweig gibt die letzten 50 Zeilen des Job-Logs aus und lässt den Lauf trotzdem scheitern.restic_backupinitialisiert nur ein fehlendes Repository. Vorher löste jeder Fehler vonrestic cat config(Netzwerk, falsches Passwort) einrestic initaus. Jetzt nur bei Exit-Code 10 oder „does not exist“/„Is there a repository …“, alles andere bricht ab.- argocd und k3s tolerieren nur bekannte Fälle. Namespace-Labels nur „not found“ (Namespace legt ArgoCD erst später an), das Löschen der Alt-AppProjects nur eine fehlende CRD, das Warten auf die System-Pods nur „no matching resources“. Die ApplicationSet-Prüfung wiederholt jetzt per
until, bis keinErrorOccurred=Truemehr gemeldet wird. - UFW-Self-Heal in
site.ymlnur mitcommon/ufw. Die Post-Tasks liefen mittags: [always]bei jedem getaggten Lauf (z. B.make dnsmasq) und konnten dort UFW kurz abschalten. Jetzt Tagscommon,base,ufw. k3s_agent:ufw.ymlnur mitk3s_agent_ufw_enable. Vorher legte die Rolle auch ohne den Schalter einen Teil der Regeln an.- Gemeinsame Werte an einer Stelle. k8s-Voraussetzungen (Swap, Kernel-Module, sysctl) stehen in
roles/common/tasks/k8s_prerequisites.yml,k3s_agentbindet die Datei perimport_role … tasks_fromein. Das ntfy-Tripel kommt aushomelab_ntfy_host/_ip/_topic, die SSH-Werte des Power-Managers ausgroup_vars/all.yml, die Host-IPs indnsmasq.conf.j2und den Semaphore-Inventories aushostvars(die NAS bleibt fest, weil sie in den Semaphore-Inventories fehlt). Der Aliasworker-0ist aus dnsmasq entfernt. Die Root-CA verteilt die Rollehomeserver_ca. semaphore_secretsläuft nur noch als Abhängigkeit vonsemaphore_bootstrap(Tagsemaphore-secrets,make semaphoreunverändert). Das Secret entsteht damit im dritten Play vonsite.ymlstatt direkt nachargocd; der Semaphore-Pod wartet so lange auf das Secret.- Verwaiste Semaphore-Projekte löscht
semaphore_bootstrapweiterhin, aber nur solangesemaphore_bootstrap_delete_orphan_projectstrueist. Mitfalsebleiben von Hand angelegte Projekte stehen. xibo_kiosk: Display-Skript ohne Endlosschleife.xibosignage-display-mode.shkennt nur nochonceundpar; der Poll-Zweig undxibo_kiosk_display_poll_secondswurden nie benutzt.- Stil (Punkt 25). Task- und Handlernamen sind deutsch und kleingeschrieben, Begründungen aus den Templates stehen jetzt hier (k3s, crowdsec, vmagent,
worker_apt_update,libvirt_host). Die gerenderten Dateien auf den Hosts ändern sich dadurch einmalig: Neustart von CrowdSec und vmagent,netplan applyauf worker-1 (dns-fallback) und auf Hosts mitlibvirt_host_configure_bridge: true(bridge-netplan, Verbindung kann kurz abreißen),config.yamlundaudit-policy.yamlvon k3s ohne Neustart. - Offen: Die Migrations-Tasks in
common,k3s_agent/ufw.yml,argocd,nightly_worker_wakeundxibo_kioskbleiben, bis bestätigt ist, dass alle Hosts migriert sind.
tailscale: Wiederholungen beim Paket-Server
pkgs.tailscale.com (CloudFront) setzt Verbindungen zeitweise zurück (Connection reset by peer, Lese-Timeout), über IPv4 wie IPv6, vom Homeserver wie vom Arbeitsrechner. Auch bei vorhandenem Schlüssel fragt get_url mit force: false den Server jedes Mal an, ob sich die Datei geändert hat, ein einzelner Abbruch ließ so ganze make check-Läufe scheitern. Schlüssel-Download, APT-Repository und Paketinstallation wiederholen deshalb bis zu fünfmal im Abstand von zehn Sekunden (retries/until … is succeeded). Die Prüfung des Schlüssel-Fingerprints danach bleibt unverändert.
Konventionen der Linter-Konfiguration
Begründungen zu .ansible-lint und .yamllint stehen in 600a0.