30010 - Alarmmonitor-Kiosks (ALAMOS AMweb) – DLRG OG Andernach
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/3-apps-workloads/30010-alamos-apager.md
Alarmmonitor-Kiosks (ALAMOS AMweb) – DLRG OG Andernach
Cluster: TECH · Ordner
argocd/apps/tech/alamos-apager/· URLhttps://alamos-apager.prod.homeserver.kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).
Zentral verwaltete Raspberry-Pi-Alarmmonitore: jeder Pi zeigt im
Kiosk-Browser die ALAMOS-AMweb-Seite (Cloud-Dienst der Alamos GmbH, eigener
Account bereits vorhanden) für seinen Standort. Der Pi selbst bleibt
absichtlich dumm und austauschbar — welche Station welche AMweb-URL bekommt,
ob ein Standort ausgefallen ist und alles Alerting läuft zentral im
k3s-Cluster.
Inhaltsverzeichnis
- Übersicht & Architektur
- Cluster-Komponente: Helm Chart
alamos-apager - Neuen Standort hinzufügen
- Pi-Provisionierung (Ansible)
- Monitoring & Alerting
- Fehlerbehebung
Übersicht & Architektur
Pi (Chromium --kiosk) ──▶ https://alamos-apager.prod.homeserver/start?station=X
│ (Traefik Ingress, *.homeserver Wildcard-DNS)
▼
alamos-apager Pod (k3s, Namespace alamos-apager)
├─ liest Secret-Volume /etc/alamos-apager/stations/X
│ → 302 Redirect zur echten AMweb-URL
├─ GET /heartbeat?station=X (Pi-Timer, alle 60s)
└─ Background-Thread: Station überfällig (kein
Heartbeat seit heartbeatTimeoutSeconds)
→ ntfy-Push "Alarmmonitor X offline"
Kein Secret/Token verlässt jemals den Cluster Richtung Pi — der Pi kennt nur
seinen eigenen Stationsnamen, die echte AMweb-URL bleibt serverseitig.
Cluster-Komponente: Helm Chart alamos-apager
Liegt unter argocd/apps/tech/alamos-apager/, wird wie jede andere App in
argocd/apps/* automatisch von ArgoCD erkannt und ausgerollt (siehe
capulus-core/b-kubernetes-gitops/b0010-argocd.md) — keine manuelle Registrierung nötig.
Wichtigste values.yaml-Knobs:
| Key | Bedeutung |
|---|---|
ntfy.url / ntfy.topic |
Wohin der Ausfall-Alarm gepusht wird (Default: bestehende ntfy-Instanz, Topic Alarmmonitor) |
stationsSecretName |
Name des SealedSecret mit den Standort→AMweb-URL-Paaren (Default alamos-apager-stations) |
heartbeatTimeoutSeconds |
Ab wann ein Standort als "down" gilt (Default 300s — deutlich über dem Pi-Heartbeat-Intervall) |
ingress.host |
alamos-apager.prod.homeserver (Wildcard-DNS, keine manuelle dnsmasq-Änderung nötig) |
Die App selbst kennt keine echten AMweb-URLs — die liegen ausschließlich
im SealedSecret (siehe nächster Abschnitt). Ohne dieses Secret startet der
Pod, aber /start?station=... antwortet mit 404.
/metrics (Prometheus-Format, per VMServiceScrape gescraped): exportiert
je Standort den Unix-Zeitstempel der letzten erfolgreichen /start-Anfrage
(alamos_apager_last_start_timestamp_seconds, = ein Kiosk-Browser hat die
echte AMweb-URL tatsächlich angefragt) und des letzten Heartbeats
(alamos_apager_last_heartbeat_timestamp_seconds). Wichtig für die
Interpretation: /start wird nur aufgerufen, wenn Chromium (neu) startet
— nach einem Reboot, Absturz oder Fallback-Wechsel; danach hält der Browser
die AMweb-Seite dauerhaft offen. Der /start-Zeitstempel ist also ein
Browser-Start-Marker und wächst im Normalbetrieb bis zum nächsten Neustart
(z. B. ~24 h bei nächtlichem Reboot). Ob ein Standort lebt, zeigt allein der
Heartbeat. Dazu kommt der aktuelle
Down-Status (alamos_apager_station_down). Läuft cluster-intern, also
unabhängig davon, ob ein Standort per LAN oder nur per Tailscale angebunden
ist — genutzt vom Zammad-Ticket-Workflow des Banana-Pi-Standorts, siehe
capulus-ansible/3-apps-workloads/30020-vereinsheim-alarmmonitor.md.
Bewusst kein Login vor /start//heartbeat: Der Pi ruft beide
Endpunkte unbeaufsichtigt auf (Chromium-Kiosk beim Boot, Heartbeat-Timer
alle 60s) und kann keinen Login-Dialog bedienen. Schutz ist stattdessen
Netzwerkgrenze (LAN/Tailscale-only, kein öffentlicher Ingress) plus
Kenntnis von Hostname und Stationsname — die echte AMweb-URL selbst
bleibt zusätzlich als SealedSecret verschlüsselt.
Neuen Standort hinzufügen
-
Echte ALAMOS-AMweb-URL für den Standort aus dem Alamos-Account
heraussuchen (Display-/Monitor-Link, ggf. mit Zugangs-Token in der URL). -
SealedSecret erzeugen/aktualisieren (ein Key pro Standort, Key-Name =
Stationsname):kubectl create secret generic alamos-apager-stations \ --namespace alamos-apager --dry-run=client -o json \ --from-literal=geraetehaus="https://amweb.alamos.cloud/...echte-url..." \ --from-literal=zentrale="https://amweb.alamos.cloud/...echte-url..." \ | kubeseal --controller-namespace sealed-secrets \ --controller-name sealed-secrets-controller -o yaml \ > argocd/apps/tech/alamos-apager/templates/sealedsecret-stations.yaml git add argocd/apps/tech/alamos-apager/templates/sealedsecret-stations.yaml git commit -m "feat(alamos-apager): add station <name>" git pushWichtig: Der Befehl muss alle Standorte auf einmal enthalten —
jederkubeseal-Lauf ersetzt das komplette Secret. Bestehende Keys also
immer mit angeben, nicht nur den neuen.Wichtig: Die Datei muss unter
templates/liegen, nicht im
Chart-Root — ArgoCD/Helm wenden nur Dateien untertemplates/an, alles
andere im Chart-Verzeichnis wird stillschweigend ignoriert. -
ArgoCD synct das Secret innerhalb von ~3 Minuten.
-
Gerät gemäß Pi-Provisionierung mit
banana_pi_kiosk_station: <name>(identischer Name wie der Secret-Key)
einrichten.
Pi-Provisionierung (Ansible)
Alarmmonitore laufen als Banana Pi mit der Rolle banana_pi_kiosk (Playbook banana-pi-kiosks.yml, make banana-pi-kiosks).
Einrichtung, Stationsname (banana_pi_kiosk_station, identisch mit dem Secret-Key) und Fallback-URL stehen in
30020. Die frühere Raspberry-Pi-Rolle alamos_kiosk
mit alarm-kiosks.yml und dem Semaphore-Projekt „alarm-kiosks“ ist entfernt.
Einmaliger manueller Login am Gerät (nach dem ersten Deploy): AMweb verlangt beim Laden Passwort und
Verschlüsselungspasswort über ein Formular auf der Seite selbst, das lässt sich nicht automatisiert ausfüllen. Chromium läuft
deshalb bewusst ohne --incognito, damit die Session (Cookies/LocalStorage) über Neustarts erhalten bleibt. Beide Passwörter
landen nie im Cluster oder in Git, sie sind reiner Browser-Zustand auf dem jeweiligen Gerät.
Monitoring & Alerting
- Verpasst ein Pi
heartbeatTimeoutSecondslang seinen Heartbeat, pusht
alamos-apagereinen ntfy-Alarm ("🚨 Alarmmonitor X offline") an das
konfigurierte Topic. - Kommt der Heartbeat zurück, wird automatisch ein Resolve-Push ("✅
Alarmmonitor X wieder online") gesendet. - Bewusst kein Zammad-Ticket pro Ausfall —
ein kurzer Pi-Reboot soll nicht jedes Mal ein Ticket erzeugen. Bei
wiederkehrenden Ausfällen liegt die Nachverfolgung beim Betrachten der
ntfy-Historie. - Einsatzalarme (nicht Ausfälle) erzeugen dagegen bewusst wohl ein
Zammad-Ticket, über einen separaten n8n-Workflow, der direkt an
ALAMOS AMweb (nicht analamos-apager) hängt — siehe
300h0-alamos-einsatz-zammad.md.
Fehlerbehebung
| Symptom | Check |
|---|---|
| Pi zeigt 404 statt AMweb-Seite | kubectl -n alamos-apager get secret alamos-apager-stations -o jsonpath='{.data}' — fehlt der Stationsname als Key? |
| Pi zeigt AMweb-Login-Formular statt Alarmmonitor | Chromium-Session abgelaufen/gelöscht — einmaligen manuellen Login (Passwort + Verschlüsselungspasswort, siehe Pi-Provisionierung) am Pi wiederholen |
alamos-apager.prod.homeserver löst nicht auf |
Wildcard-DNS prüfen: nslookup alamos-apager.prod.homeserver (siehe capulus-core/c-netzwerk-dns/c0000-dns-architecture.md) |
| Kein ntfy-Alarm bei Ausfall | kubectl -n alamos-apager logs deploy/alamos-apager — NTFY_URL/NTFY_TOPIC korrekt? ntfy-Topic im Client abonniert? |
| Chromium startet nicht / schwarzer Bildschirm | Autologin aktiv? journalctl -t banana-pi-kiosk auf dem Gerät (30020) |
Permission denied (publickey) bei make banana-pi-kiosks |
make semaphore-targets lief nicht für das neue Gerät (siehe capulus-ansible/b-kubernetes-gitops/b0030-semaphore.md) |
| Ansible-Fehler "banana_pi_kiosk_station ist nicht gesetzt" | Host-Var in capulus-ansible/inventory/hosts.yml fehlt, siehe Pi-Provisionierung |