PKR-Lab

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

  1. Sicherstellen dass banana_pi_kiosk_station gesetzt ist
  2. Sicherstellen dass banana_pi_kiosk_fallback_url gesetzt und entschlüsselt ist
  3. Kiosk-Pakete installieren (Debian-Paketnamen, nicht Raspbian)
  4. homeserver-root-ca verteilen (Rolle homeserver_ca)
  5. NSS-Datenbank-Verzeichnis des Kiosk-Users anlegen
  6. Prüfen ob Homeserver-Root-CA bereits in NSS-Datenbank des Kiosk-Users vertraut ist
  7. Homeserver-Root-CA in NSS-Datenbank des Kiosk-Users importieren
  8. lightdm stoppen und deaktivieren (falls vorhanden)
  9. Verzeichnis für getty@tty1-Drop-in anlegen
  10. Autologin-Drop-in für getty@tty1 deployen
  11. .bash_profile von {{ banana_pi_kiosk_user }} um automatischen startx-Aufruf ergänzen
  12. .xinitrc deployen
  13. konfigurationsverzeichnis für den kiosk-supervisor anlegen (/etc/banana-pi-kiosk, 0750)
  14. fallback-url des kiosk-supervisors ablegen (supervisor.env, 0640, no_log, ohne Diff)
  15. Kiosk-Supervisor-Skript deployen (liest die Fallback-URL aus supervisor.env)
  16. Screenshot-Skript deployen
  17. wakeonlan installieren
  18. Wake-on-LAN-Skript deployen
  19. Config-Verzeichnis für WoL-HTTP-Agent anlegen
  20. Bearer-Token für WoL-HTTP-Agent erzeugen (falls noch nicht vorhanden)
  21. Token-Datei-Rechte absichern
  22. Erzeugtes WoL-Agent-Token einlesen
  23. TLS-Zertifikat und -Schlüssel für den WoL-HTTP-Agent prüfen
  24. TLS-Zertifikat für den WoL-HTTP-Agent ablegen
  25. TLS-Schlüssel für den WoL-HTTP-Agent ablegen
  26. TLS-Dateien des WoL-HTTP-Agent entfernen, falls TLS aus
  27. WoL-HTTP-Agent-Skript deployen
  28. WoL-HTTP-Agent-Konfiguration templaten
  29. WoL-HTTP-Agent-systemd-Unit deployen
  30. WoL-HTTP-Agent aktivieren und starten
  31. WoL-HTTP-Agent deaktivieren, falls banana_pi_kiosk_wol_agent_enabled false
  32. Hinweis zum WoL-Agent-Token ausgeben
  33. Heartbeat-Skript deployen
  34. Heartbeat-Environment-Datei deployen
  35. Heartbeat-systemd-Service + Timer deployen
  36. Heartbeat-Timer aktivieren
  37. Heartbeat-Timer deaktivieren (banana_pi_kiosk_enabled false)
  38. Daily-Reboot-systemd-Service + Timer deployen
  39. Daily-Reboot-Timer aktivieren
  40. Daily-Reboot-Timer deaktivieren (banana_pi_kiosk_daily_reboot_enabled false)

Handler

Templates

Dateien


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.

Alle Rollen