Rolle `worker_apt_update`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/worker_apt_update.md
Rolle worker_apt_update
apt-Update der Worker (haben keine common-Rolle) und der k3s-Server (make k3s-servers-update).
Auf k3s-Servern prüft vor einem nötigen Neustart die Rolle k3s_reboot_guard: Der andere Server muss Ready sein, /readyz/etcd muss ok melden und der Peer muss mindestens 300 Sekunden laufen. Sonst wird nicht neu gestartet und eine Warnung ausgegeben. Nach dem Neustart wartet die Rolle über den Peer auf Ready und hebt das Cordon auf. Das Playbook k3s-servers-update.yml läuft mit serial: 1 und any_errors_fatal.
| Läuft gegen | controlplane-1, worker-1, controlplane-0 (nur über k3s-servers-update.yml) |
| Tags | apt-update, updates |
| Quellcode | roles/worker_apt_update |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
worker_apt_update_enabled |
true |
– |
worker_apt_update_k3s_node_name |
{{ k3s_agent_hostname }} |
– |
worker_apt_update_kubeconfig |
/etc/rancher/k3s/k3s.yaml |
– |
worker_apt_update_reboot_timeout_seconds |
300 |
– |
worker_apt_update_post_reboot_delay_seconds |
15 |
– |
worker_apt_update_dns_fallback_enabled |
false |
– |
worker_apt_update_dns_fallback_interface |
eno1 |
– |
worker_apt_update_dns_fallback_servers |
[1.1.1.1, 8.8.8.8] |
– |
Ablauf
- Statische Fallback-Nameserver setzen (Netplan-Drop-in)
- Fallback-Nameserver-Konfiguration deployen
- Handler sofort ausfuehren (DNS muss vor dem apt-Update unten stehen)
- Update apt cache
- Upgrade all packages to latest (dist-upgrade)
- Check whether a reboot is required
- Reboot-erforderlich -- Node vor dem Neustart cordon/drain (auf homeserver)
- kubectl cordon {{ worker_apt_update_k3s_node_name }}
- kubectl drain {{ worker_apt_update_k3s_node_name }}
- drain-ergebnis auswerten (Erfolg oder Node „not found“)
- node nach fehlgeschlagenem drain wieder freigeben und neustart auslassen
- Reboot-erforderlich -- {{ inventory_hostname }} jetzt automatisch neu starten (nur nach erfolgreichem Drain)
- Reboot-erforderlich -- Abschluss melden (für den nightly_worker_wake-Bericht)
Handler
- netplan-konfiguration anwenden
Templates
dns-fallback.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 journalctl -u unattended-upgrades -n 50 --no-pager
kubectl get nodes
sudo apt update && apt list --upgradable
| Symptom | Ursache | Lösung |
|---|---|---|
| Update läuft nachts nicht | Teil des Zyklus von nightly_worker_wake | Nightly Worker Update |
| Worker kommt nach dem Reboot nicht zurück | reboot_timeout_seconds (300) überschritten |
Konsole am Gerät, k3s_agent |
| DNS-Fehler beim apt-Update | Pi-hole/dnsmasq nicht erreichbar | worker_apt_update_dns_fallback_enabled: true (Fallback 1.1.1.1, 8.8.8.8), DNS |
Node steht danach auf SchedulingDisabled |
Vor einem nötigen Neustart führt die Rolle auf dem Homeserver kubectl cordon und kubectl drain (Timeout 120 s, Fehler werden ignoriert) für worker_apt_update_k3s_node_name aus |
kubectl get nodes, bei Bedarf kubectl uncordon <node> |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.