From dcd99c3ba96bb2b30bc3ede002094b4047cf7c7f Mon Sep 17 00:00:00 2001 From: Gordon Zimm Date: Wed, 23 Sep 2026 15:10:15 +0200 Subject: [PATCH] Zustandsriegel: die drei Einrichtungsskripte laufen nur bei espo_zustand = NEU Statt lokaler Merkmale steuert das Custom Field espo_zustand zentral, was laufen darf. Jedes der drei Skripte nimmt den Wert als Argument und bricht ohne Aenderung ab, wenn er nicht NEU ist. In ESPO-03 bleibt die Pruefung auf eine vorhandene Instanz als Rueckfall erhalten: Der Zustand im RMM ist von Hand aenderbar, eine laufende Instanz ist es nicht. Co-Authored-By: Claude Opus 5 --- rmm-tasks/ESPO-01-Grundeinrichtung.sh | 13 +++++++++++-- rmm-tasks/ESPO-02-Docker.sh | 11 ++++++++++- rmm-tasks/ESPO-03-First-Deploy.sh | 24 ++++++++++++++---------- 3 files changed, 35 insertions(+), 13 deletions(-) diff --git a/rmm-tasks/ESPO-01-Grundeinrichtung.sh b/rmm-tasks/ESPO-01-Grundeinrichtung.sh index 22614b1..a185b2a 100755 --- a/rmm-tasks/ESPO-01-Grundeinrichtung.sh +++ b/rmm-tasks/ESPO-01-Grundeinrichtung.sh @@ -1,12 +1,21 @@ #!/bin/bash # ESPO-01-Grundeinrichtung – schliesst die Basis-VM ab. # Laeuft als root, ist idempotent und kann jederzeit wiederholt werden. -# Aufruf: bash ESPO-01-Grundeinrichtung.sh "" -# Der RMM-Task ist nur ein duenner Ausloeser, der dieses Skript holt und mit %companyname% aufruft. +# Aufruf: bash ESPO-01-Grundeinrichtung.sh "" "" +# Der RMM-Task ist nur ein duenner Ausloeser, der dieses Skript holt und mit %companyname% +# und dem Wert des Custom Field espo_zustand aufruft. set -u KUNDE_ROH="${1:-}" +ZUSTAND="${2:-}" FEHLER=0 +# 0. Zustandsriegel: Die Einrichtung laeuft nur an einer Instanz, die im RMM als NEU gefuehrt wird. +# Das Custom Field espo_zustand steuert damit zentral, was laufen darf. +if [ "$ZUSTAND" != "NEU" ]; then + echo "FEHLER: espo_zustand ist '${ZUSTAND:-leer}', erwartet NEU - Abbruch ohne Aenderung" + echo "ESPO01_ERGEBNIS: FEHLER"; exit 1 +fi + # 1. Hostname aus dem Kundennamen ableiten (klein, nur a-z 0-9 und Bindestrich), damit die # Flotte im RMM und in Logs eindeutig benannt ist. KUNDE=$(printf '%s' "$KUNDE_ROH" | tr '[:upper:]' '[:lower:]' | tr -c 'a-z0-9' '-' | sed 's/-\+/-/g; s/^-//; s/-$//') diff --git a/rmm-tasks/ESPO-02-Docker.sh b/rmm-tasks/ESPO-02-Docker.sh index cb6c0e2..f0a124d 100755 --- a/rmm-tasks/ESPO-02-Docker.sh +++ b/rmm-tasks/ESPO-02-Docker.sh @@ -1,10 +1,19 @@ #!/bin/bash # ESPO-02-Docker - installiert Docker in gepinnter Version, setzt die Daemon-Grundlagen und # beschraenkt den Zugang zu veroeffentlichten Container-Ports auf das eigene Subnetz. -# Laeuft als root ueber einen RMM-Bash-Task, idempotent. +# Aufruf: bash ESPO-02-Docker.sh "" (Zustand = Wert des Custom Field espo_zustand) +# Laeuft als root ueber einen RMM-Task, idempotent. set -u +ZUSTAND="${1:-}" FEHLER=0 +# 0. Zustandsriegel: Die Einrichtung laeuft nur an einer Instanz, die im RMM als NEU gefuehrt wird. +# Das Custom Field espo_zustand steuert damit zentral, was laufen darf. +if [ "$ZUSTAND" != "NEU" ]; then + echo "FEHLER: espo_zustand ist '${ZUSTAND:-leer}', erwartet NEU - Abbruch ohne Aenderung" + echo "ESPO02_ERGEBNIS: FEHLER"; exit 1 +fi + # Gepinnte Staende - hier wird der Flottenstand gesetzt, nicht auf der VM entschieden. DOCKER_VERSION="5:29.8.1-1~ubuntu.24.04~noble" CONTAINERD_VERSION="2.3.5-1~ubuntu.24.04~noble" diff --git a/rmm-tasks/ESPO-03-First-Deploy.sh b/rmm-tasks/ESPO-03-First-Deploy.sh index eef384a..d3c3e5b 100755 --- a/rmm-tasks/ESPO-03-First-Deploy.sh +++ b/rmm-tasks/ESPO-03-First-Deploy.sh @@ -1,6 +1,6 @@ #!/bin/bash # ESPO-03-First-Deploy - richtet EspoCRM auf einer vorbereiteten VM zum ersten Mal ein. -# Aufruf: ESPO-03-First-Deploy.sh +# Aufruf: ESPO-03-First-Deploy.sh # Laeuft nur auf einer VM OHNE vorhandene Instanz. Fuer Aktualisierungen ist der Update-Weg zustaendig; # dieses Skript fasst eine bestehende Instanz nicht an, damit keine Migration ohne geprueftes Backup startet. set -u @@ -9,28 +9,32 @@ BASIS_URL=https://gitea.subcura.net/EspoCRM_Public/espo-deploy/raw/branch/main WARTE_MAX=900 FQDN="${1:-}" RING="${2:-}" +ZUSTAND="${3:-}" fehler() { echo "FEHLER: $*"; echo "ESPO03_ERGEBNIS: FEHLER"; exit 1; } -# 1. Vorbedingungen - lieber hier abbrechen als auf halbem Weg. +# 1. Zustandsriegel: Der First Deploy laeuft nur an einer Instanz, die im RMM als NEU gefuehrt wird. +[ "$ZUSTAND" = "NEU" ] || fehler "espo_zustand ist '${ZUSTAND:-leer}', erwartet NEU - Abbruch ohne Aenderung" + +# 2. Vorbedingungen - lieber hier abbrechen als auf halbem Weg. [ "$(id -u)" -eq 0 ] || fehler "nicht als root gestartet" command -v docker >/dev/null || fehler "Docker fehlt - erst ESPO-02 ausfuehren" docker info >/dev/null 2>&1 || fehler "Docker laeuft nicht - erst ESPO-02 pruefen" [ -n "$FQDN" ] || fehler "kein FQDN uebergeben" [ -n "$RING" ] || fehler "kein Ring uebergeben" -# 2. Eine vorhandene Instanz ist der Abbruchgrund dieses Skripts - genau dafuer heisst es First Deploy. +# 3. Rueckfallpruefung: Der Zustand im RMM ist von Hand aenderbar, eine vorhandene Instanz ist es nicht. for C in espocrm espocrm-db espocrm-daemon espocrm-websocket; do docker ps -a --format '{{.Names}}' | grep -qx "$C" && fehler "Container '$C' existiert bereits - hier ist der Update-Weg zustaendig" done [ -e /srv/espo/docker-compose.yml ] && fehler "/srv/espo/docker-compose.yml existiert bereits - hier ist der Update-Weg zustaendig" [ -e /srv/espo/data/config.php ] && fehler "EspoCRM ist bereits installiert (data/config.php) - hier ist der Update-Weg zustaendig" -# 3. Verzeichnisse anlegen. Die Eigentuemer setzen die Images beim ersten Start selbst. +# 4. Verzeichnisse anlegen. Die Eigentuemer setzen die Images beim ersten Start selbst. install -d -m 0755 /srv/espo /srv/espo/bin /srv/espo/mariadb /srv/espo/data /srv/espo/custom /srv/espo/client-custom install -d -m 0700 /srv/espo/secrets -# 4. Geheimnisse auf der VM erzeugen - sie stehen in keinem Skript, keiner Ausgabe und keinem Repository. +# 5. Geheimnisse auf der VM erzeugen - sie stehen in keinem Skript, keiner Ausgabe und keinem Repository. # Ohne abschliessenden Zeilenumbruch, damit die _FILE-Auswertung der Images genau diesen Wert sieht. umask 077 for G in db_root_password db_password; do @@ -40,18 +44,18 @@ for G in db_root_password db_password; do done umask 022 -# 5. Grundeinstellungen bereitlegen, bevor EspoCRM zum ersten Mal startet. +# 6. Grundeinstellungen bereitlegen, bevor EspoCRM zum ersten Mal startet. curl -fsSL "$BASIS_URL/docker/config-override.php" -o /srv/espo/data/config-override.php || fehler "config-override.php nicht abrufbar" -# 6. Compose aus dem Stand des Rings schreiben. +# 7. Compose aus dem Stand des Rings schreiben. curl -fsSL "$BASIS_URL/bin/espo-compose-rendern" -o /srv/espo/bin/espo-compose-rendern || fehler "Render-Skript nicht abrufbar" chmod 0755 /srv/espo/bin/espo-compose-rendern /srv/espo/bin/espo-compose-rendern "$FQDN" "$RING" || fehler "Compose konnte nicht geschrieben werden" -# 7. Starten. Die Images werden dabei zum ersten Mal geholt. +# 8. Starten. Die Images werden dabei zum ersten Mal geholt. docker compose -f /srv/espo/docker-compose.yml up -d || fehler "Start fehlgeschlagen" -# 8. Auf die Anwendung warten. Der erste Lauf installiert und baut das Schema auf, das dauert. +# 9. Auf die Anwendung warten. Der erste Lauf installiert und baut das Schema auf, das dauert. ENDE=$(( SECONDS + WARTE_MAX )) while [ "$SECONDS" -lt "$ENDE" ]; do [ "$(docker inspect -f '{{.State.Health.Status}}' espocrm 2>/dev/null)" = "healthy" ] && break @@ -60,7 +64,7 @@ done [ "$(docker inspect -f '{{.State.Health.Status}}' espocrm 2>/dev/null)" = "healthy" ] \ || fehler "espocrm nach ${WARTE_MAX}s nicht gesund - 'docker logs espocrm' ansehen" -# 9. Ergebnis zeigen. Die Datenbankabfragen laufen im Container und lesen das Passwort dort aus der Secret-Datei, +# 10. Ergebnis zeigen. Die Datenbankabfragen laufen im Container und lesen das Passwort dort aus der Secret-Datei, # damit es weder im Skript noch in der Prozessliste der VM auftaucht. echo "--- Container" docker compose -f /srv/espo/docker-compose.yml ps --format 'table {{.Name}}\t{{.Status}}'