From db0fd0887eacdafa2cc8fb0f468d2d9744531943 Mon Sep 17 00:00:00 2001 From: Gordon Zimm Date: Tue, 22 Sep 2026 16:49:18 +0200 Subject: [PATCH] Seed fuer EspoCRM-Kunden-VMs unter espocrm/ ergaenzt Quelle ist espoCRM/espo-fleet-ops (autoinstall/user-data); hier abgelegt, weil der Installer ohne Anmeldung abruft und die Organisation espoCRM nicht oeffentlich sichtbar ist. Co-Authored-By: Claude Opus 5 --- README.md | 11 +++- espocrm/README.md | 22 ++++++++ espocrm/meta-data | 0 espocrm/user-data | 126 ++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 158 insertions(+), 1 deletion(-) create mode 100644 espocrm/README.md create mode 100644 espocrm/meta-data create mode 100644 espocrm/user-data diff --git a/README.md b/README.md index 4d270b1..3bf34fe 100644 --- a/README.md +++ b/README.md @@ -14,4 +14,13 @@ Passwort: ubuntu Passwort ändern mit: -passwd \ No newline at end of file +passwd + +--- + +## Varianten + +| Verzeichnis | Zweck | Boot-Parameter | +|---|---|---| +| (Wurzel) | allgemeine Ubuntu-VM | `autoinstall ds=nocloud-net;s=https://gitea.subcura.net/gordon.zimm/ubuntu-autoinstall/raw/branch/main/` | +| `espocrm/` | EspoCRM-Kunden-VM (Projekt espo-fleet-ops) | `autoinstall ds=nocloud-net;s=https://gitea.subcura.net/gordon.zimm/ubuntu-autoinstall/raw/branch/main/espocrm/` | diff --git a/espocrm/README.md b/espocrm/README.md new file mode 100644 index 0000000..1e4b08b --- /dev/null +++ b/espocrm/README.md @@ -0,0 +1,22 @@ +# EspoCRM-Kunden-VM – Autoinstall-Seed + +Dieser Seed gehört zum Projekt **espo-fleet-ops** (Gitea: `espoCRM/espo-fleet-ops`). Dort liegen die Quelle, +die Architekturentscheidungen und die Begründung zu jeder Einstellung: +`docs/decisions/`, `docs/entwuerfe/plattenlayout-erlaeuterung.md`. + +Er liegt **hier**, weil der Installer die Dateien ohne Anmeldung abruft und die Organisation `espoCRM` nicht öffentlich +sichtbar ist. Der Seed enthält bewusst **keine Geheimnisse** (kein benutzbares Passwort, kein RMM-Token). + +**Änderungen immer zuerst in `espoCRM/espo-fleet-ops/autoinstall/user-data` und von dort hierher kopieren.** + +## Verwendung + +Ubuntu-Server-24.04-ISO booten, im GRUB-Menü `e` drücken, vor `---` einfügen: + +``` +autoinstall ds=nocloud-net;s=https://gitea.subcura.net/gordon.zimm/ubuntu-autoinstall/raw/branch/main/espocrm/ +``` + +Strg+X. Die Installation läuft ohne Rückfragen durch und **schaltet die VM am Ende aus**; vor dem nächsten Start das ISO +trennen. Die drei Schritte der Erstinbetriebnahme (Passwort ändern, RMM-Agent installieren, Hinweiszeile entfernen) liegen +danach als `/root/ERSTINBETRIEBNAHME.txt` auf der VM. diff --git a/espocrm/meta-data b/espocrm/meta-data new file mode 100644 index 0000000..e69de29 diff --git a/espocrm/user-data b/espocrm/user-data new file mode 100644 index 0000000..a826338 --- /dev/null +++ b/espocrm/user-data @@ -0,0 +1,126 @@ +#cloud-config +# Autoinstall-Seed für die EspoCRM-Kunden-VM (Ubuntu Server 24.04 LTS auf Hyper-V). +# Stand 2026-09-22, abgeleitet aus gitea gordon.zimm/ubuntu-autoinstall (Commit 0cd9fc6). +# ERSTE FASSUNG – auf einer Test-VM noch nicht durchgelaufen; Abweichungen bitte hier einpflegen. +# +# Grundsätze: +# * Der Seed wird per NoCloud über HTTP geladen und kann sich nicht authentisieren +# -> er enthält KEIN Geheimnis: kein benutzbares Passwort, kein RMM-Token. +# * Die ISO richtet nur das Minimum ein. Docker, Härtung, Logrotation, Firewall, Hostname und +# Instanz kommen reproduzierbar über RMM-Tasks ("alles Weitere erfolgt über ConnectWise RMM"). +autoinstall: + version: 1 + + source: + id: ubuntu-server + + updates: all + + locale: de_DE.UTF-8 + keyboard: + layout: de + timezone: Europe/Berlin + + # Schnittstellennamen nicht festnageln: Hyper-V meldet je nach Kernel eth0 oder enp*. + network: + version: 2 + ethernets: + primary: + match: + name: "e*" + dhcp4: true + dhcp6: false + + identity: + realname: administrator + username: administrator + hostname: unkonfiguriert # setzt der RMM-Baseline-Task auf crm- + # Hash eines einmalig erzeugten 48-Zeichen-Zufallspassworts; der Klartext wurde nirgends abgelegt. + # Das Konto ist damit faktisch gesperrt, bis die late-commands je VM ein Initialpasswort setzen. + password: '$6$KDLfMzLPV6wWtwA4$9VnUET9kFWUVp07z2hkN9Kv9.WjgdIPGLmm7zb4Te47Ms7lyrw/9Ewpqf759xVfXcOfAkWJSFrxUClfeyxeuI0' + + ssh: + install-server: true + allow-pw: true + authorized-keys: [] + + packages: + - linux-cloud-tools-virtual # hv_kvp_daemon, hv_vss_daemon, hv_fcopy_daemon + - curl # Voraussetzung des RMM-Agenten (libcurl4 kommt mit) + - bzip2 # der .run-Installer entpackt sich damit + # kein linux-azure: der Azure-Kernel ist für Azure gebaut. Soll er trotzdem bleiben, + # gehört linux-cloud-tools-azure dazu, sonst fehlen die Hyper-V-Integrationsdienste. + + # Explizite Aufteilung: klein für das Betriebssystem, groß für die Nutzdaten. + # `layout: {name: lvm, sizing-policy: scaled}` wäre kürzer, gibt aber rund die Hälfte der Platte an "/" – + # auf einer reinen Docker-VM ist das an der falschen Stelle. + storage: + config: + - {type: disk, id: disk0, ptable: gpt, match: {size: largest}, wipe: superblock-recursive, preserve: false, grub_device: false} + + - {type: partition, id: part-esp, device: disk0, size: 1G, flag: boot, grub_device: true, preserve: false} + - {type: format, id: fmt-esp, volume: part-esp, fstype: fat32, preserve: false} + - {type: mount, id: mnt-esp, device: fmt-esp, path: /boot/efi} + + - {type: partition, id: part-boot, device: disk0, size: 2G, preserve: false} + - {type: format, id: fmt-boot, volume: part-boot, fstype: ext4, preserve: false} + - {type: mount, id: mnt-boot, device: fmt-boot, path: /boot} + + - {type: partition, id: part-pv, device: disk0, size: -1, flag: lvm, preserve: false} + - {type: lvm_volgroup, id: vg0, name: ubuntu-vg, devices: [part-pv], preserve: false} + + # Betriebssystem, RMM-Agent, Logs – 20 GiB sind reichlich (Bedarf real 8–12 GiB) + - {type: lvm_partition, id: lv-root, name: root-lv, volgroup: vg0, size: 20G, preserve: false} + - {type: format, id: fmt-root, volume: lv-root, fstype: ext4, preserve: false} + - {type: mount, id: mnt-root, device: fmt-root, path: /} + + # Sollte der Installer `path: none` für Swap nicht annehmen: diese drei Zeilen entfernen und + # stattdessen `swap: {size: 4G}` als eigenen Abschnitt setzen (Swapdatei auf /). + - {type: lvm_partition, id: lv-swap, name: swap-lv, volgroup: vg0, size: 4G, preserve: false} + - {type: format, id: fmt-swap, volume: lv-swap, fstype: swap, preserve: false} + - {type: mount, id: mnt-swap, device: fmt-swap, path: none} + + # Images, Container, Container-Logs – reproduzierbar, wird nicht gesichert + - {type: lvm_partition, id: lv-docker, name: docker-lv, volgroup: vg0, size: 20G, preserve: false} + - {type: format, id: fmt-docker, volume: lv-docker, fstype: ext4, preserve: false} + - {type: mount, id: mnt-docker, device: fmt-docker, path: /var/lib/docker} + + # /srv (Nutzdaten) wird in late-commands anteilig angelegt, damit der Seed für jede Plattengröße passt. + + late-commands: + # 1. /srv bekommt 80 % des verbliebenen Platzes; ~20 % bleiben unbelegt als Reserve und für LVM-Snapshots. + # Beispiel 128-GiB-Platte: / 20, swap 4, docker 20, /srv ~65, frei ~16 GiB. + - lvcreate -y -l 80%FREE -n srv-lv ubuntu-vg + - mkfs.ext4 -q -L srv /dev/ubuntu-vg/srv-lv + - mkdir -p /target/srv + - printf '/dev/ubuntu-vg/srv-lv /srv ext4 defaults 0 2\n' >> /target/etc/fstab + # 2. Je VM zufälliges Initialpasswort, am Konsolen-Login sichtbar, Wechsel beim ersten Anmelden erzwungen. + - >- + PW=$(tr -dc 'A-Za-z0-9' > /target/etc/issue + # 3. Hyper-V-Integrationsdienste (Zeit/IP-Meldung, Dateisystem-Quiesce für Veeam). + # Normalerweise startet udev sie selbst; enable schadet nicht und darf fehlschlagen. + - curtin in-target -- systemctl enable hv-kvp-daemon.service hv-vss-daemon.service || true + # 4. Kurze Anleitung für den einen Handgriff nach dem ersten Start (Passwort + RMM-Agent). + - >- + printf '%s\n' + '# Erstinbetriebnahme dieser VM (Entscheidung 2026-09-22: Registrierung im RMM von Hand)' + '# 1. Initialpasswort steht am Konsolen-Login (/etc/issue), Wechsel wird erzwungen.' + '# Neues Passwort im Secure Information Store der Site hinterlegen.' + '# 2. RMM-Agent installieren (Token aus: Endpoints > Devices > Manage > Download Agent):' + '# curl -fsSL -o /tmp/ITSPlatform.run https://setup.euplatform.connectwise.com/linux/BareboneAgent/64/ITSagent/RUN/setup' + '# chmod +x /tmp/ITSPlatform.run && sudo TOKEN= /tmp/ITSPlatform.run && rm -f /tmp/ITSPlatform.run' + '# 3. Zeile mit dem Initialpasswort aus /etc/issue entfernen.' + '# Alles Weitere erledigt der Baseline-Task, den der Trigger "First check-in" anstoesst.' + > /target/root/ERSTINBETRIEBNAHME.txt + # 5. Zum Schluss alles auf den neuesten Stand bringen. `updates: all` deckt den Stand zu Beginn der + # Installation ab; dieser Durchgang holt, was währenddessen dazugekommen ist, und räumt auf. + # NEEDRESTART_SUSPEND verhindert Dienst-Neustarts im chroot. + - curtin in-target -- sh -c 'DEBIAN_FRONTEND=noninteractive NEEDRESTART_SUSPEND=1 apt-get update' + - curtin in-target -- sh -c 'DEBIAN_FRONTEND=noninteractive NEEDRESTART_SUSPEND=1 apt-get -y -o Dpkg::Options::=--force-confold -o Dpkg::Options::=--force-confdef full-upgrade' + - curtin in-target -- sh -c 'DEBIAN_FRONTEND=noninteractive apt-get -y autoremove --purge' + - curtin in-target -- sh -c 'apt-get clean' + + shutdown: poweroff