fix(station): Anzeige-Installation absichern, apt darf nur warnen

Fixrunde 1 zu Task 6b.

- setup_pi.sh raeumt die Ablage vor dem scp ab und bricht ab, wenn
  display.py dort fehlt. Ein Reststand aus einem abgebrochenen Lauf liess
  "scp -r" ins vorhandene Ziel hineinkopieren; die Installationsschleife
  ueberspringt Verzeichnisse und fand nichts - der Lauf meldete Erfolg,
  aktivierte den Anzeigedienst und hinterliess ein leeres display/:
  203/EXEC im 5-Sekunden-Takt bei schwarzem Panel.
- Der Paketschritt steht jetzt hinter der Installation und warnt nur.
  Eine Migrationsstation steht typischerweise nicht am Netz; unter set -e
  davor hiess ein gescheitertes apt: gar keine Station statt einer Station
  ohne Panel. "apt-get update" kommt vor dem install, der Anzeigedienst
  startet nach dem Paketschritt.
- setup_pi.sh raeumt display/ auf dem Pi wie deploy.sh auf (im Repo
  geloeschte Dateien verschwinden), der Trap haengt auch an INT/TERM/HUP,
  und mktemp bekommt eine Vorlage: ohne sie beachtet BSD-mktemp TMPDIR
  nicht, und die Temp-Datei landete je nach Plattform woanders.
- test_host.sh ruft test_deploy.sh auf - 95 Zusagen liefen nur bei
  Handaufruf, darunter die Deploy-Haelfte der Anzeige-Auslieferung. Der
  Coverage-Test deckt jetzt auch die Shell-Suiten ab und zaehlt dabei nur
  nicht auskommentierte Zeilen.
- Neue Szenarien fuer alle vier Punkte, darunter die Zusage, dass beim
  gescheiterten Schreiben eines Profils keine Datei mit dem WLAN-Passwort
  liegenbleibt.
This commit is contained in:
Michael Sauer
2026-09-14 00:03:49 +02:00
parent cc398ef57a
commit 7fdccbce72
5 changed files with 325 additions and 31 deletions
+9
View File
@@ -136,6 +136,15 @@ case "\$1" in
# RuntimeDirectoryPreserve=restart in der Unit leert systemd das
# RuntimeDirectory bei JEDEM Stop/Restart, nicht nur beim allerersten Start,
# und legt es leer wieder an.
#
# ACHTUNG, Stub-Erfindung (Task 6b F1): die Regel wird hier auf JEDE
# Unit angewandt, also auch auf ninlight-display - die traegt aber gar kein
# RuntimeDirectory=, ein "stop ninlight-display" raeumt in Wirklichkeit nichts
# weg. \$UNIT_FILE ist immer ninlight-station.service, unabhaengig davon, welche
# Unit im Aufruf steht. Heute folgenlos (kein Testfall stoppt die Anzeige und
# erwartet danach noch Dateien in RUN_DIR), aber niemand darf sich darauf
# verlassen: wer kuenftig prueft, was ein "display off" mit RUN_DIR macht, muss
# den Stub vorher nach Unit unterscheiden lassen.
if ! grep -q '^RuntimeDirectoryPreserve=restart' "\$UNIT_FILE" 2>/dev/null; then
rm -rf "\$RUN_DIR"
mkdir -p "\$RUN_DIR"
+184 -1
View File
@@ -52,6 +52,14 @@ EOF
cat >"$bindir/scp" <<EOF
#!/usr/bin/env bash
echo "STUB scp \$*" >>"$log"
# Testschalter (Task 6b F1, I1): laesst die Uebertragung des Anzeigeverzeichnisses
# scheitern, ohne dass scp selbst einen Fehler meldet - genau das Bild eines
# abgebrochenen oder falsch verschachtelten "scp -r".
for a in "\$@"; do
case "\$a" in
*ninlight-display) [ -n "\${FAKE_SCP_SKIP_DIR:-}" ] && exit 0 ;;
esac
done
args=()
for a in "\$@"; do
case "\$a" in
@@ -73,7 +81,14 @@ EOF
cat >"$bindir/apt-get" <<EOF
#!/usr/bin/env bash
echo "STUB apt-get \$*" >>"$log"
exit "\${FAKE_APT_EXIT:-0}"
# Getrennt schaltbar: der Fall, den I4 beschreibt, ist "Paketlisten lassen sich
# auffrischen, das Paket ist trotzdem nicht zu holen" (404). Ein Stub, der schon
# "update" scheitern laesst, kaeme bei "install" nie an.
case "\$1" in
update) exit "\${FAKE_APT_UPDATE_EXIT:-0}" ;;
install) exit "\${FAKE_APT_EXIT:-0}" ;;
esac
exit 0
EOF
# Steht fuer das python3 DES PI, nicht fuer das des Testrechners: nur die
@@ -99,6 +114,14 @@ EOF
cat >"$bindir/sudo" <<EOF
#!/usr/bin/env bash
echo "STUB sudo \$*" >>"$log"
# Testschalter (Task 6b F1, I2): laesst ein bestimmtes "sudo install" scheitern -
# gebraucht, um den Abbruchpfad in write_profile() zu erreichen, auf dem die
# Temp-Datei mit dem WLAN-Passwort sonst liegenbliebe.
if [ -n "\${FAKE_SUDO_INSTALL_FAIL:-}" ]; then
case "\$*" in
install*"\$FAKE_SUDO_INSTALL_FAIL"*) echo "install: simulierter Fehler" >&2; exit 1 ;;
esac
fi
if [ "\$1" = "install" ]; then
args=()
skip=0
@@ -117,7 +140,11 @@ EOF
cat >"$bindir/systemctl" <<EOF
#!/usr/bin/env bash
echo "STUB systemctl \$*" >>"$log"
# Testschalter: laesst "enable"/"restart" scheitern (beides darf setup_pi.sh nur
# warnen lassen, nie abbrechen).
case "\$1" in
enable) exit "\${FAKE_SYSTEMCTL_ENABLE_EXIT:-0}" ;;
restart) exit "\${FAKE_SYSTEMCTL_RESTART_EXIT:-0}" ;;
is-active) exit "\${FAKE_SYSTEMCTL_ACTIVE_EXIT:-0}" ;;
*) exit 0 ;;
esac
@@ -155,7 +182,13 @@ setup_state() {
# "ninlight-station.conf.example" oder "server.py".
run_setup() {
local state=$1 stubbin=$2
# TMPDIR in die Sandbox: write_profile() legt seine Temp-Dateien (mit dem WLAN-
# Passwort darin) per "mktemp -d" unter TMPDIR an. Nur so kann Szenario 12 danach
# nachsehen, ob wirklich nichts liegengeblieben ist - und nebenbei fasst der Test
# damit auch dafuer nicht das echte /tmp des Entwicklungsrechners an.
mkdir -p "$state/tmpdir"
PATH="$stubbin:$PATH" \
TMPDIR="$state/tmpdir" \
NINLIGHT_SSH_BIN="$stubbin/ssh" \
NINLIGHT_SCP_BIN="$stubbin/scp" \
NINLIGHT_STAGE_DIR="$state/tmp" \
@@ -430,6 +463,156 @@ else
pass "kein Migrationsprofil mit leerem PSK angelegt"
fi
echo
echo "=== Szenario 11 (Task 6b F1, I1): Reststand in der Ablage fuehrt nicht zu einer stillen Nullinstallation ==="
# Ein frueherer Lauf ist nach dem scp abgebrochen (sudo-Timeout, Platte voll, Strg-C),
# die Aufraeumzeile lief nicht. "scp -r quelle ziel" kopiert dann IN das vorhandene Ziel
# hinein (…/ninlight-display/display/), die Installationsschleife ueberspringt
# Verzeichnisse und findet nichts - der Lauf meldete frueher Erfolg und aktivierte einen
# Dienst, dessen ExecStart-Datei gar nicht existiert (203/EXEC im 5-Sekunden-Takt).
STATE="$TMPROOT/s11-state"; STUBBIN="$TMPROOT/bin11"; LOG="$TMPROOT/s11.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
mkdir -p "$STATE/tmp/ninlight-display"
echo "rest" >"$STATE/tmp/ninlight-display/uebrig.py"
: >"$LOG"
set +e
OUT=$(run_setup "$STATE" "$STUBBIN" 2>&1)
RC=$?
set -e
[ "$RC" -eq 0 ] && pass "Exit-Code 0" || fail "Exit-Code $RC, Ausgabe: $OUT"
DISP11="$STATE/opt/ninlight-station/display"
[ -f "$DISP11/display.py" ] && pass "display.py trotz Reststand installiert" || fail "Nullinstallation: $DISP11 enthaelt $(ls -A "$DISP11" 2>/dev/null | tr '\n' ' ')"
[ -f "$DISP11/epd2in13_V3.py" ] && pass "Panel-Treiber trotz Reststand installiert" || fail "Panel-Treiber fehlt"
[ ! -d "$DISP11/display" ] && pass "kein verschachteltes display/display/ entstanden" || fail "verschachteltes Verzeichnis angelegt"
[ ! -f "$DISP11/uebrig.py" ] && pass "der Reststand des Vorlaufs wurde nicht mitinstalliert" || fail "uebrig.py aus dem Reststand landete auf dem Pi"
echo
echo "=== Szenario 12 (Task 6b F1, I1): scheitert die Uebertragung, wird laut abgebrochen statt still 'installiert' gemeldet ==="
STATE="$TMPROOT/s12-state"; STUBBIN="$TMPROOT/bin12"; LOG="$TMPROOT/s12.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
: >"$LOG"
set +e
OUT=$(FAKE_SCP_SKIP_DIR=1 run_setup "$STATE" "$STUBBIN" 2>&1)
RC=$?
set -e
[ "$RC" -ne 0 ] && pass "Exit-Code != 0" || fail "Exit-Code 0 trotz fehlgeschlagener Uebertragung: $OUT"
echo "$OUT" | grep -q "display.py fehlt" && pass "Fehlermeldung nennt die fehlende Datei" || fail "Fehlermeldung fehlt: $OUT"
# Das Schlimmste waere ein aktivierter Dienst ohne ExecStart-Datei.
grep -Fq "systemctl enable ninlight-display" "$LOG" && fail "der Anzeigedienst wurde trotz fehlender Dateien aktiviert - 203/EXEC im Neustart-Takt" || pass "kein aktivierter Dienst ohne Dateien"
echo
echo "=== Szenario 13 (Task 6b F1, I1): eine im Repo geloeschte Datei verschwindet auch auf dem Pi ==="
# Dasselbe Argument wie in deploy.sh: display/ ist reiner Code aus dem Repo, ein
# zurueckgebliebenes altes Modul wuerde weiter mit importiert.
STATE="$TMPROOT/s13-state"; STUBBIN="$TMPROOT/bin13"; LOG="$TMPROOT/s13.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
mkdir -p "$STATE/opt/ninlight-station/display"
echo "alt" >"$STATE/opt/ninlight-station/display/veraltet.py"
: >"$LOG"
set +e
OUT=$(run_setup "$STATE" "$STUBBIN" 2>&1)
RC=$?
set -e
[ "$RC" -eq 0 ] && pass "Exit-Code 0" || fail "Exit-Code $RC, Ausgabe: $OUT"
[ ! -f "$STATE/opt/ninlight-station/display/veraltet.py" ] && pass "veraltete Datei entfernt" || fail "veraltet.py blieb liegen"
[ -f "$STATE/opt/ninlight-station/display/render.py" ] && pass "der aktuelle Code ist trotzdem da" || fail "render.py fehlt"
echo
echo "=== Szenario 14 (Task 6b F1, I2): scheitert das Schreiben eines Profils, bleibt keine Temp-Datei mit dem Passwort liegen ==="
# Zwischen "mktemp" und "install" steht das WLAN-Passwort in einer Datei unter TMPDIR.
# Ein Abbruch genau dort (set -e) darf sie nicht zuruecklassen - dafuer gibt es den Trap
# um das gemeinsame mktemp-Verzeichnis. Ohne ihn faellt das sonst nirgends auf.
STATE="$TMPROOT/s14-state"; STUBBIN="$TMPROOT/bin14"; LOG="$TMPROOT/s14.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
cat >"$STATE/etc/ninlight-station.conf" <<'CONF'
SSID='eigene-ssid'
PSK='streng-geheimes-passwort'
IMAGE_DIR='/opt/ninlight-station/images'
HOME_CONNECTION='preconfigured'
AP_CONNECTION='ninlight-recovery'
MIGRATE_SSID='qconnex-firmware'
MIGRATE_PSK='qconnex-firmware'
MIGRATE_AP_CONNECTION='qconnex-firmware'
EPD_REVISION='V3'
CONF
chmod 0600 "$STATE/etc/ninlight-station.conf"
: >"$LOG"
set +e
OUT=$(FAKE_SUDO_INSTALL_FAIL=.nmconnection run_setup "$STATE" "$STUBBIN" 2>&1)
RC=$?
set -e
[ "$RC" -ne 0 ] && pass "Exit-Code != 0 (das Profil liess sich nicht schreiben)" || fail "Exit-Code 0 trotz fehlgeschlagenem install: $OUT"
LEFTOVER=$(find "$STATE/tmpdir" -type f 2>/dev/null | head -n5)
[ -z "$LEFTOVER" ] && pass "keine Temp-Datei unter TMPDIR zurueckgeblieben" || fail "liegengeblieben: $LEFTOVER"
# Der eigentliche Schaden waere das Passwort in einer Datei, die niemand mehr aufraeumt.
if grep -rlq "streng-geheimes-passwort" "$STATE/tmpdir" 2>/dev/null; then
fail "das WLAN-Passwort steht in einer liegengebliebenen Datei unter $STATE/tmpdir"
else
pass "das WLAN-Passwort steht in keiner liegengebliebenen Datei"
fi
echo
echo "=== Szenario 15 (Task 6b F1, I4): scheitert apt, ist die Station trotzdem vollstaendig eingerichtet ==="
# Eine Migrationsstation steht typischerweise nicht am Netz. Ein harter Abbruch hier
# hiesse: gar keine Station statt einer Station ohne Panel.
STATE="$TMPROOT/s15-state"; STUBBIN="$TMPROOT/bin15"; LOG="$TMPROOT/s15.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
: >"$LOG"
set +e
OUT=$(FAKE_PIL_MISSING=1 FAKE_APT_EXIT=100 run_setup "$STATE" "$STUBBIN" 2>"$TMPROOT/s15.err")
RC=$?
set -e
ERR=$(cat "$TMPROOT/s15.err")
[ "$RC" -eq 0 ] && pass "Exit-Code 0 trotz gescheitertem apt" || fail "Exit-Code $RC - kein Netz haette die ganze Einrichtung verhindert: $ERR"
echo "$ERR" | grep -q "Warnung" && pass "Warnung (keine Fehlermeldung) auf stderr" || fail "keine Warnung auf stderr: $ERR"
[ -x "$STATE/opt/ninlight-station/server.py" ] && pass "server.py installiert" || fail "server.py fehlt"
[ -x "$STATE/usr/local/bin/ninlight-station" ] && pass "CLI installiert" || fail "CLI fehlt"
[ -f "$STATE/etc/systemd/system/ninlight-station.service" ] && pass "Stations-Unit installiert" || fail "Stations-Unit fehlt"
[ -f "$STATE/etc/systemd/system/ninlight-display.service" ] && pass "Anzeige-Unit installiert" || fail "Anzeige-Unit fehlt"
[ -f "$STATE/opt/ninlight-station/display/display.py" ] && pass "Anzeigecode installiert" || fail "Anzeigecode fehlt"
NMDIR15="$STATE/etc/NetworkManager/system-connections"
[ -f "$NMDIR15/ninlight-recovery.nmconnection" ] && pass "Rettungsprofil angelegt" || fail "Rettungsprofil fehlt"
[ -f "$NMDIR15/qconnex-firmware.nmconnection" ] && pass "Migrationsprofil angelegt" || fail "Migrationsprofil fehlt"
# Reihenfolge: apt kommt NACH der Installation, sonst haette ein Fehlschlag alles davor
# mitgerissen.
INST_LINE=$({ grep -n "install .*ninlight-station.service" "$LOG" | head -n1 | cut -d: -f1; } || true)
APT_LINE=$({ grep -n "apt-get install" "$LOG" | head -n1 | cut -d: -f1; } || true)
if [ -n "$INST_LINE" ] && [ -n "$APT_LINE" ] && [ "$INST_LINE" -lt "$APT_LINE" ]; then
pass "der Paketschritt laeuft nach der Installation (inst=$INST_LINE, apt=$APT_LINE)"
else
fail "der Paketschritt laeuft weiterhin vor der Installation (inst=$INST_LINE, apt=$APT_LINE)"
fi
# Und der Anzeigedienst startet erst nach dem Paketschritt - sonst liefe er beim
# allerersten Zeichnen ohne Pillow und beendete sich still mit 0.
RESTART_LINE=$({ grep -n "systemctl restart ninlight-display" "$LOG" | head -n1 | cut -d: -f1; } || true)
if [ -n "$RESTART_LINE" ] && [ "$APT_LINE" -lt "$RESTART_LINE" ]; then
pass "der Anzeigedienst startet nach dem Paketschritt (apt=$APT_LINE, restart=$RESTART_LINE)"
else
fail "der Anzeigedienst startet vor dem Paketschritt (apt=$APT_LINE, restart=$RESTART_LINE)"
fi
grep -Fq "apt-get update" "$LOG" && pass "die Paketlisten werden vorher aufgefrischt" || fail "kein 'apt-get update' vor dem install"
echo
echo "=== Szenario 16: ein fehlgeschlagenes enable/restart des Anzeigedienstes warnt nur ==="
STATE="$TMPROOT/s16-state"; STUBBIN="$TMPROOT/bin16"; LOG="$TMPROOT/s16.log"
setup_state "$STATE"
setup_stubbin "$STUBBIN" "$LOG"
: >"$LOG"
set +e
OUT=$(FAKE_SYSTEMCTL_ENABLE_EXIT=1 FAKE_SYSTEMCTL_RESTART_EXIT=1 run_setup "$STATE" "$STUBBIN" 2>"$TMPROOT/s16.err")
RC=$?
set -e
ERR=$(cat "$TMPROOT/s16.err")
[ "$RC" -eq 0 ] && pass "Exit-Code 0 trotz fehlgeschlagenem enable/restart" || fail "Exit-Code $RC: $ERR"
echo "$ERR" | grep -q "systemctl enable ninlight-display" && pass "Warnung zu 'enable' auf stderr" || fail "keine enable-Warnung: $ERR"
echo "$ERR" | grep -q "systemctl restart ninlight-display" && pass "Warnung zu 'restart' auf stderr" || fail "keine restart-Warnung: $ERR"
[ -f "$STATE/etc/NetworkManager/system-connections/qconnex-firmware.nmconnection" ] && pass "der Lauf ging danach normal weiter (Profile angelegt)" || fail "der Lauf brach nach der Warnung ab"
echo
if [ "$FAILED" -eq 0 ]; then
echo "Alle Tests bestanden."