monitor/update.sh
fds2610-bot 172b863c4f Update-Sicherheit: Tests vor Dienst-Neustart, API-Banner uebersteht Render-Fehler
update.sh startete api/web/sync bereits neu, bevor die Testsuiten liefen - schlugen sie
danach fehl, brach das Skript per set -e ab, aber die Produktion lief bereits mit dem
fehlerhaften Stand weiter. deploy-webhook.py meldet einen solchen Abbruch nirgends aktiv,
nur still im Log - ein Update konnte so unbemerkt eine kaputte Version live schalten.

Zusaetzlich: setApiBanner(true) steht jetzt in einem eigenen finally im Demo-Fallback von
boot()/refresh() - ein Fehler beim Neuzeichnen der Szene darf nicht mehr verhindern, dass
der "API nicht erreichbar"-Banner erscheint.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-22 22:29:40 +02:00

100 lines
4.5 KiB
Bash

#!/bin/bash
#
# Holt die neueste Version aus dem konfigurierten Git-Repo und fuehrt die noetigen Updates
# fuer die Docker-Compose-Entwicklungs-/Laufzeitumgebung durch (siehe README.md/Visualization.md
# Abschnitt "Entwicklung nur mit Docker"): PHP-Abhaengigkeiten aktualisieren, Images neu bauen,
# Dienste neu starten, Testsuiten laufen lassen. SQLite-Migrationen brauchen keinen eigenen
# Schritt - api/src/Db/Database::migrate() wendet sie bei jedem API-Start automatisch an.
#
# Konfiguration ueber Umgebungsvariablen (Defaults passen fuer den ueblichen Fall):
# UPDATE_REMOTE - Git-Remote, aus dem geholt wird (Default: origin)
# UPDATE_BRANCH - Branch, der aktualisiert wird (Default: aktuell ausgecheckter Branch)
# UPDATE_RUN_TESTS - "0" setzen, um die Testsuiten nach dem Update zu ueberspringen (Default: 1)
# UPDATE_ALLOW_DIRTY - "1" setzen, um auch bei lokalen Aenderungen an versionierten Dateien
# weiterzumachen (Default: 0, d.h. kontrollierter Abbruch)
set -euo pipefail
REPO_DIR="$(cd "$(dirname "$(readlink -f "$0")")" && pwd)"
cd "$REPO_DIR"
log() {
printf '[update.sh] %s\n' "$1"
}
fail() {
printf '[update.sh] Fehler: %s\n' "$1" >&2
exit 1
}
command -v git >/dev/null 2>&1 || fail "git ist nicht installiert."
command -v docker >/dev/null 2>&1 || fail "docker ist nicht installiert."
git -C "$REPO_DIR" rev-parse --is-inside-work-tree >/dev/null 2>&1 \
|| fail "$REPO_DIR ist kein Git-Repository."
UPDATE_REMOTE="${UPDATE_REMOTE:-origin}"
UPDATE_BRANCH="${UPDATE_BRANCH:-$(git rev-parse --abbrev-ref HEAD)}"
UPDATE_RUN_TESTS="${UPDATE_RUN_TESTS:-1}"
UPDATE_ALLOW_DIRTY="${UPDATE_ALLOW_DIRTY:-0}"
# Unversionierte Dateien blockieren das Update bewusst NICHT: neben dem Repo liegen auf einem
# Produktionsserver Laufzeit-/Konfigurationsdateien (hosts.conf, monitor-api.conf, ...), die
# beim ff-only-Pull ohnehin unangetastet bleiben - stuende eine davon einem neuen Commit im
# Weg, bricht git selbst kontrolliert ab. Blockierend sind nur Aenderungen an versionierten
# Dateien, weil der Pull die verlieren koennte.
DIRTY_TRACKED="$(git status --porcelain --untracked-files=no)"
if [ -n "$DIRTY_TRACKED" ]; then
printf '%s\n' "$DIRTY_TRACKED" >&2
if [ "$UPDATE_ALLOW_DIRTY" = "1" ]; then
log "Warnung: lokale Aenderungen an versionierten Dateien (siehe oben), UPDATE_ALLOW_DIRTY=1 - fahre trotzdem fort."
else
fail "Lokale Aenderungen an versionierten Dateien (siehe oben) - bitte erst committen/stashen (oder UPDATE_ALLOW_DIRTY=1 setzen). Breche ab, um nichts zu ueberschreiben."
fi
fi
UNTRACKED="$(git ls-files --others --exclude-standard)"
if [ -n "$UNTRACKED" ]; then
log "Hinweis: unversionierte Dateien im Arbeitsbaum, sie bleiben unveraendert:"
printf '%s\n' "$UNTRACKED" | sed 's/^/ /'
fi
log "Hole Aenderungen von ${UPDATE_REMOTE}/${UPDATE_BRANCH}..."
git fetch "$UPDATE_REMOTE" "$UPDATE_BRANCH"
# --ff-only statt reset --hard: bricht kontrolliert ab, falls der lokale Branch abweicht
# (z. B. eigene, noch nicht gepushte Commits), statt Historie zu ueberschreiben.
git checkout "$UPDATE_BRANCH"
git pull --ff-only "$UPDATE_REMOTE" "$UPDATE_BRANCH"
DOCKER_COMPOSE="docker compose"
if ! docker compose version >/dev/null 2>&1; then
command -v docker-compose >/dev/null 2>&1 || fail "Weder 'docker compose' noch 'docker-compose' verfuegbar."
DOCKER_COMPOSE="docker-compose"
fi
log "Aktualisiere PHP-Abhaengigkeiten (composer install)..."
$DOCKER_COMPOSE run --rm api composer install --no-interaction --no-progress
log "Baue Docker-Images neu (falls Dockerfile/Abhaengigkeiten sich geaendert haben)..."
$DOCKER_COMPOSE build
# Tests laufen bewusst VOR dem Neustart der Dienste, in einem temporaeren Container
# (docker compose run --rm), der die produktiven api/web/sync-Container nicht anfasst. Liefe
# "up -d" zuerst, wuerden fehlschlagende Tests das Skript zwar per "set -e" abbrechen, die
# Produktion liefe aber bereits mit dem fehlerhaften Stand weiter - und deploy-webhook.py
# meldet einen solchen Abbruch nirgends aktiv, nur still im Log. Bei einem Fehlschlag hier
# bleiben die alten Container unveraendert im Einsatz.
if [ "$UPDATE_RUN_TESTS" = "1" ]; then
log "Fuehre PHPUnit-Tests (API) aus..."
$DOCKER_COMPOSE run --rm api composer test
log "Fuehre Frontend-Tests aus..."
$DOCKER_COMPOSE run --rm frontend
else
log "UPDATE_RUN_TESTS=0 gesetzt - ueberspringe Testsuiten."
fi
log "Starte Dienste neu (api, web, sync)..."
$DOCKER_COMPOSE up -d api web sync
log "Update abgeschlossen (${UPDATE_BRANCH} @ $(git rev-parse --short HEAD))."