Rolle `power_agent`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/power_agent.md
Rolle power_agent
HTTP-API für Helligkeit, Wake und Shutdown aus der iOS-App. Wake und Shutdown gelten nur für die Ziele aus power_agent_targets (worker-1) und die Wake-only-Ziele (ollama-pc). controlplane-1 ist kein Ziel mehr, eine Anfrage dafür beantwortet der Agent mit 400.
Achtung
/poweroff-self: Der Aufruf fährt controlplane-0 herunter (drain,k3sstoppen, Poweroff). Mit zwei Control-Planes ist die Kubernetes-API ohne controlplane-0 nicht schreibbar, auch wenn controlplane-1 läuft. Bereits laufende Dienste laufen weiter. Die iOS-App warnt davor, 400a0.
| Läuft gegen | controlplane-0 |
| Tags | power-agent, power-management |
| Quellcode | roles/power_agent |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
power_agent_enabled |
true |
– |
power_agent_port |
9101 |
– |
power_agent_bind_address |
0.0.0.0 |
– |
power_agent_known_hosts_path |
/etc/power-agent/known_hosts |
– |
power_agent_token_path |
/etc/power-agent/token |
– |
power_agent_backlight_path |
/sys/class/backlight/intel_backlight/brightness |
– |
power_agent_backlight_max_path |
/sys/class/backlight/intel_backlight/max_brightness |
– |
power_agent_bl_power_path |
/sys/class/backlight/intel_backlight/bl_power |
– |
power_agent_poweroff_bin |
/usr/sbin/poweroff |
– |
power_agent_node_name |
{{ inventory_hostname }} |
– |
power_agent_ssh_user |
{{ cluster_power_manager_ssh_user }} |
– |
power_agent_ssh_key |
{{ cluster_power_manager_ssh_key_path }} |
– |
power_agent_kubeconfig |
{{ cluster_power_manager_kubeconfig }} |
– |
power_agent_state_dir |
{{ cluster_power_manager_state_dir }} |
– |
power_agent_targets |
{{ cluster_power_manager_workers }} |
– |
power_agent_wake_only_targets |
[ollama-pc] |
Ziele, die nur per /wake geweckt werden (Desktop-PC mit Ollama), Einträge ohne MAC entfallen |
Ablauf
- Python3 installieren (Laufzeit für power-agent.py)
- Config-Verzeichnis anlegen
- Bearer-Token für power-agent erzeugen (falls noch nicht vorhanden)
- Token-Datei-Rechte absichern
- Erzeugtes Token einlesen
- bekannte hostschlüssel der worker aus der root-known_hosts lesen
- hostschlüssel fehlender worker einmalig abrufen
- known_hosts-zeilen zusammenstellen
- festes known_hosts für die ssh-aufrufe des power-agent schreiben
- warnen, wenn kein worker-hostschlüssel gefunden wurde
- power-agent.py deployen
- Konfiguration templaten
- systemd-Unit deployen
- power-agent aktivieren und starten
- power-agent deaktivieren, falls power_agent_enabled false
- Hinweis zum Sealed-Secret-Abgleich ausgeben
Handler
- power-agent neu starten
Templates
config.env.j2power-agent.service.j2
Dateien
power-agent.py
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 systemctl status power-agent
sudo journalctl -u power-agent -f
sudo cat /etc/power-agent/config.env | sed "s/token=.*/token=<TOKEN>/I"
curl -s -H "Authorization: Bearer $(sudo cat /etc/power-agent/token)" http://10.42.2.1:9101/brightness
cat /sys/class/backlight/intel_backlight/brightness
| Symptom | Ursache | Lösung |
|---|---|---|
carplay-api meldet 502 … power-agent unreachable |
Dienst läuft nicht oder lauscht nicht auf der Pod-Bridge-Adresse | systemctl status power-agent, power_agent_bind_address, carplay-api |
502 … power-agent returned 401 |
Token im Secret carplay-api-power-agent-token weicht von /etc/power-agent/token ab |
Secret neu versiegeln (carplay-api: Ersteinrichtung) |
| Helligkeit lässt sich nicht setzen | Backlight-Pfade (power_agent_backlight_path) existieren nicht (anderer Treiber) oder Rechte |
Pfade unter /sys/class/backlight/ prüfen |
| Shutdown des Homeservers dauert | kubectl drain (bis 180 s) läuft zuerst |
journalctl -u power-agent -f verfolgen, iOS: Steuerung |
| Wake eines Workers schlägt fehl | WoL-Gerät oder SSH-Zugang | Rolle wake_on_lan, cluster_power_manager |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.