espo-deploy/README.md
Gordon Zimm 903d0e7f53 ESPO-22-Demo-Stand-sichern und ESPO-23-Demo-zuruecksetzen
ESPO-22 kopiert bei gestopptem Stack den Anwendungsstand (mariadb, data,
custom, client-custom) nach /srv/espo-baseline - ohne secrets, Compose,
bin, data/config-override.php und data/logs, die von Tasks gepflegt werden
bzw. als Verlauf bleiben. Dazu ein Manifest mit EspoCRM-Version,
MariaDB-Image und den Extension-Kennungen; der neue Grundstand ersetzt den
alten erst, wenn er vollstaendig ist.

ESPO-23 spielt den Grundstand per rsync zurueck (taeglich 02:00) und
bricht ab, wenn seit dem Sichern ESPO-10 oder ESPO-30 gelaufen ist oder ein
Snapshot offen ist. Beide Skripte laufen nur auf Hostnamen espo-demo*;
nach einem Fehler startet die Demo in jedem Fall wieder. In einer Sandbox
mit allen Sperren und dem Fehlerfall nach dem Stoppen getestet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:38:04 +02:00

2.7 KiB
Raw Permalink Blame History

espo-deploy

Öffentliche, geheimnisfreie Artefakte für EspoCRM-Kunden-VMs. Alles hier wird von den VMs ohne Anmeldung abgerufen – es steht deshalb kein Passwort, kein Token und keine Kundenangabe in diesem Repository.

Verzeichnis Inhalt
autoinstall/ NoCloud-Seed für die Basis-VM (user-data, meta-data)
rmm-tasks/ Skripte, die als Task im ConnectWise RMM hinterlegt sind (Quelle für Änderungen)
bin/ Skripte, die auf der VM unter /srv/espo/bin/ liegen und von Tasks aufgerufen werden
docker/ je Ring ein Ordner mit dem Stand dieses Rings: docker-compose.yml und config-override.php

Nummernkreise der Tasks

Kreis Bedeutung bisher
0x von der leeren VM zur laufenden Instanz 01 Grundeinrichtung, 02 Docker, 03 First-Deploy
1x aktualisieren 10 Update, 11 Snapshot verwerfen, 12 Snapshot wiederherstellen, 13 Secrets setzen
2x Betrieb und Überwachung 20 Inventar, 21 Backup-Prüfung (geplant), 22 Demo-Stand sichern, 23 Demo zurücksetzen (nur espo-demo*)
3x Extensions 30 Extension installieren

Ein Kreis beginnt bei x0. Die Liste im RMM sortiert alphabetisch, die Reihenfolge stimmt damit.

Konzept, Entscheidungen und Runbooks liegen im internen Repository espoCRM/espo-fleet-ops.

Autoinstall

autoinstall ds=nocloud-net\;s=https://gitea.subcura.net/EspoCRM_Public/espo-deploy/raw/branch/main/autoinstall/

Das Semikolon muss maskiert werden – in GRUB trennt ein unmaskiertes ; zwei Befehle.

Compose und Ringe

Ordner Ring Inhalt
docker/0 - intern/ 0 der aktuelle Stand, hier wird entwickelt und getestet
docker/1 - Pilotkunde/ 1 freigegebener Stand für Pilotkunden
docker/2 - Produktivkunde/ 2 freigegebener Stand für den Regelbetrieb

Jeder Ordner enthält den vollständigen Stand dieses Rings: eine docker-compose.yml mit genau einem Platzhalter (__FQDN__) und die config-override.php mit den EspoCRM-Grundeinstellungen. Eine Freigabe ist das Kopieren dieser Datei in den nächsten Ordner – damit steht in jedem git diff, welche Instanzen den neuen Stand bekommen.

bin/espo-compose-rendern <fqdn> <ring> holt den Stand des Rings, setzt den FQDN ein und schreibt /srv/espo/docker-compose.yml. Diese Datei auf der VM ist ein Erzeugnis – sie wird bei jedem Lauf neu geschrieben, Änderungen von Hand gehen verloren. Geändert wird im Repository.

Kundenspezifisches

Gehört nicht hierher, sondern in die Custom Fields des RMM (FQDN, Ring, Wartungsfenster). Geheimnisse entstehen auf der VM (/srv/espo/secrets/, 0600) und verlassen sie nicht.