Gordon Zimm
a643d64172
Die Datei /root/ERSTINBETRIEBNAHME.txt ist das Erste, was ein Techniker nach dem ersten Start liest. Sie nannte noch einen Trigger, den es nicht gibt, und liess die Voraussetzungen offen. Jetzt steht drin, was vor dem ersten Task im RMM gesetzt sein muss (Company Unique Id, Site, Device Group, Friendly Name, espo_fqdn, espo_ring, espo_zustand), in welcher Reihenfolge ESPO-01 bis ESPO-03 laufen, und dass das Admin-Passwort vor DNS und Portfreigabe zu wechseln ist. Dazu der veraltete Kommentar zum Hostnamen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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) |
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 |
2x |
Betrieb und Überwachung | 20 Inventar (geplant), 21 Backup-Prüfung (geplant) |
3x |
Extensions | geplant |
Ein Kreis beginnt bei x0. Die Liste im RMM sortiert alphabetisch, die Reihenfolge stimmt damit.
| 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 |
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.