Rolle `k3s_reboot_guard`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/k3s_reboot_guard.md
Rolle k3s_reboot_guard
Gibt Neustarts und Upgrades der k3s-Server nur frei, wenn der andere Server und etcd gesund sind.
| Läuft gegen | controlplane-0, controlplane-1 (Hosts außerhalb von k3s_servers bekommen immer die Freigabe) |
| Tags | – |
| Quellcode | roles/k3s_reboot_guard |
Mit zwei etcd-Mitgliedern nimmt ein Neustart des einen Servers, während der andere ausfällt oder noch hochfährt, die Kubernetes-API. Die Rolle prüft deshalb vorher. Sie wird von worker_apt_update, common (automatischer Reboot) und k3s-upgrade.yml eingebunden und setzt den Fakt k3s_reboot_guard_ok.
Variablen
| Variable | Default | Bedeutung |
|---|---|---|
k3s_reboot_guard_peer_min_uptime_seconds |
300 |
so lange muss der Peer mindestens laufen, damit sein etcd-Mitglied wieder synchron ist |
k3s_reboot_guard_kubeconfig |
/etc/rancher/k3s/k3s.yaml |
kubeconfig auf dem Peer |
Ablauf
- Peer-Server bestimmen (alle anderen Hosts der Gruppe
k3s_servers), abbrechen wenn keiner existiert - Peer-Node auf
Readyprüfen (per kubectl auf dem Peer) /readyz/etcdüber die API des Peers prüfen- Laufzeit des Peers lesen
k3s_reboot_guard_ok: truesetzen, bei jedem Fehlerfalseplus Warnung (die Aufrufer überspringen dann den Neustart, ein Fehler im Playbook entsteht nicht)
Fehlersuche
| Symptom | Ursache | Lösung |
|---|---|---|
| „Neustart von … nicht freigegeben“ | Peer nicht Ready, etcd nicht ok oder Peer erst kurz online |
kubectl get nodes, kubectl get --raw=/readyz/etcd auf dem Peer, später erneut ausführen |
k3s-upgrade.yml bricht ab |
derselbe Grund, dort ist die Freigabe Pflicht | Peer zuerst reparieren |