Rolle `banana_pi_kiosk`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/banana_pi_kiosk.md
Rolle banana_pi_kiosk
Chromium-Kiosk, Heartbeat-Timer und WoL-Agent.
| Läuft gegen | Banana Pi |
| Tags | banana-pi-kiosk, kiosk |
| Quellcode | roles/banana_pi_kiosk |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
banana_pi_kiosk_enabled |
true |
– |
banana_pi_kiosk_ca_src |
{{ playbook_dir }}/files/homeserver-root-ca.pem |
– |
banana_pi_kiosk_base_url |
https://alamos-apager.prod.homeserver |
– |
banana_pi_kiosk_user |
pela |
– |
banana_pi_kiosk_heartbeat_interval |
60 |
– |
banana_pi_kiosk_failover_poll_seconds |
30 |
– |
banana_pi_kiosk_failover_fail_threshold |
3 |
– |
banana_pi_kiosk_failover_recover_threshold |
1 |
– |
banana_pi_kiosk_periodic_refresh_seconds |
0 |
– |
banana_pi_kiosk_daily_reboot_enabled |
false |
– |
banana_pi_kiosk_daily_reboot_time |
00:00:00 |
– |
banana_pi_kiosk_wol_enabled |
true |
– |
banana_pi_kiosk_wol_devices |
{} |
– |
banana_pi_kiosk_wol_agent_enabled |
true |
– |
banana_pi_kiosk_wol_agent_port |
9102 |
– |
banana_pi_kiosk_wol_agent_bind_address |
0.0.0.0 |
– |
banana_pi_kiosk_wol_agent_token_path |
/etc/banana-pi-wol-agent/token |
– |
banana_pi_kiosk_wol_agent_tls_enabled |
false |
– |
banana_pi_kiosk_wol_agent_tls_crt |
`` | – |
banana_pi_kiosk_wol_agent_tls_key |
`` | – |
banana_pi_kiosk_wol_agent_tls_crt_path |
/etc/banana-pi-wol-agent/tls.crt |
– |
banana_pi_kiosk_wol_agent_tls_key_path |
/etc/banana-pi-wol-agent/tls.key |
– |
Ablauf
- Sicherstellen dass banana_pi_kiosk_station gesetzt ist
- Sicherstellen dass banana_pi_kiosk_fallback_url gesetzt und entschlüsselt ist
- Kiosk-Pakete installieren (Debian-Paketnamen, nicht Raspbian)
- homeserver-root-ca verteilen (Rolle
homeserver_ca) - NSS-Datenbank-Verzeichnis des Kiosk-Users anlegen
- Prüfen ob Homeserver-Root-CA bereits in NSS-Datenbank des Kiosk-Users vertraut ist
- Homeserver-Root-CA in NSS-Datenbank des Kiosk-Users importieren
- lightdm stoppen und deaktivieren (falls vorhanden)
- Verzeichnis für getty@tty1-Drop-in anlegen
- Autologin-Drop-in für getty@tty1 deployen
- .bash_profile von {{ banana_pi_kiosk_user }} um automatischen startx-Aufruf ergänzen
- .xinitrc deployen
- konfigurationsverzeichnis für den kiosk-supervisor anlegen (
/etc/banana-pi-kiosk,0750) - fallback-url des kiosk-supervisors ablegen (
supervisor.env,0640,no_log, ohne Diff) - Kiosk-Supervisor-Skript deployen (liest die Fallback-URL aus
supervisor.env) - Screenshot-Skript deployen
- wakeonlan installieren
- Wake-on-LAN-Skript deployen
- Config-Verzeichnis für WoL-HTTP-Agent anlegen
- Bearer-Token für WoL-HTTP-Agent erzeugen (falls noch nicht vorhanden)
- Token-Datei-Rechte absichern
- Erzeugtes WoL-Agent-Token einlesen
- TLS-Zertifikat und -Schlüssel für den WoL-HTTP-Agent prüfen
- TLS-Zertifikat für den WoL-HTTP-Agent ablegen
- TLS-Schlüssel für den WoL-HTTP-Agent ablegen
- TLS-Dateien des WoL-HTTP-Agent entfernen, falls TLS aus
- WoL-HTTP-Agent-Skript deployen
- WoL-HTTP-Agent-Konfiguration templaten
- WoL-HTTP-Agent-systemd-Unit deployen
- WoL-HTTP-Agent aktivieren und starten
- WoL-HTTP-Agent deaktivieren, falls banana_pi_kiosk_wol_agent_enabled false
- Hinweis zum WoL-Agent-Token ausgeben
- Heartbeat-Skript deployen
- Heartbeat-Environment-Datei deployen
- Heartbeat-systemd-Service + Timer deployen
- Heartbeat-Timer aktivieren
- Heartbeat-Timer deaktivieren (banana_pi_kiosk_enabled false)
- Daily-Reboot-systemd-Service + Timer deployen
- Daily-Reboot-Timer aktivieren
- Daily-Reboot-Timer deaktivieren (banana_pi_kiosk_daily_reboot_enabled false)
Handler
- system-vertrauensspeicher aktualisieren (Rolle
homeserver_ca) - heartbeat-timer des banana pi neu starten
- getty@tty1 neu laden
- timer für den täglichen reboot des banana pi neu starten
- wol-agent des banana pi neu starten
Templates
banana-pi-daily-reboot.service.j2banana-pi-daily-reboot.timer.j2banana-pi-heartbeat.env.j2banana-pi-heartbeat.service.j2banana-pi-heartbeat.timer.j2banana-pi-kiosk-supervisor.sh.j2banana-pi-screenshot.sh.j2banana-pi-wol-agent.env.j2banana-pi-wol-agent.service.j2banana-pi-wol.sh.j2getty-autologin.conf.j2xinitrc.j2
Dateien
banana-pi-heartbeat.shbanana-pi-wol-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 banana-pi-heartbeat.timer banana-pi-wol-agent getty@tty1
sudo journalctl -u banana-pi-heartbeat -u banana-pi-wol-agent -n 100 --no-pager
ls /etc/banana-pi-wol-agent /etc/banana-pi-heartbeat.env
make banana-pi-kiosks-restart-session # in capulus-ansible: Kiosk-Sitzung neu starten
| Symptom | Ursache | Lösung |
|---|---|---|
Playbook bricht ab: banana_pi_kiosk_station ist nicht gesetzt. |
Host-Variable fehlt | in inventory/hosts.yml (Gruppe banana_pis) setzen, Wert wie Schlüssel im SealedSecret alamos-apager-stations |
Playbook bricht ab: banana_pi_kiosk_fallback_url ist nicht gesetzt … |
Platzhalter aus host_vars/<host>/vault.yml nicht ersetzt |
echte ALAMOS-URL mit ansible-vault encrypt_string eintragen (Vereinsheim-Alarmmonitor) |
Playbook bricht ab: banana_pi_kiosk_wol_agent_tls_enabled verlangt … |
TLS für den WoL-Agent aktiviert, Zertifikat oder Schlüssel fehlen | banana_pi_kiosk_wol_agent_tls_crt und …_key setzen (Internes TLS: WoL-Agent) |
| Kiosk zeigt Fallback-Seite statt ALAMOS | Failover griff: nach banana_pi_kiosk_failover_fail_threshold fehlgeschlagenen Prüfungen (alle …poll_seconds) wird auf den Server umgeschaltet |
Erreichbarkeit der AMweb-URL prüfen, Supervisor-Log (journalctl) |
| WoL über die iOS-App schlägt fehl | Agent läuft nicht, Token, Gerät nicht in banana_pi_kiosk_wol_devices |
systemctl status banana-pi-wol-agent, iOS: Steuerung |
| Session hängt | kein täglicher Neustart (banana_pi_kiosk_daily_reboot_enabled: false) |
Neustart der Session per Make-Ziel (siehe oben) oder Timer aktivieren |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.