PKR-Lab

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/ · URL https://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

  1. Übersicht & Architektur
  2. Cluster-Komponente: Helm Chart alamos-apager
  3. Neuen Standort hinzufügen
  4. Pi-Provisionierung (Ansible)
  5. Monitoring & Alerting
  6. 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

  1. Echte ALAMOS-AMweb-URL für den Standort aus dem Alamos-Account
    heraussuchen (Display-/Monitor-Link, ggf. mit Zugangs-Token in der URL).

  2. 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 push
    

    Wichtig: Der Befehl muss alle Standorte auf einmal enthalten —
    jeder kubeseal-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 unter templates/ an, alles
    andere im Chart-Verzeichnis wird stillschweigend ignoriert.

  3. ArgoCD synct das Secret innerhalb von ~3 Minuten.

  4. 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

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