Gordon Zimm
903d0e7f53
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>
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# 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.
|