From c3211d0fe2a695652e3e43ecd1e8a845b50dbd63 Mon Sep 17 00:00:00 2001 From: Florian Wilde Date: Mon, 12 Oct 2026 09:13:32 +0200 Subject: [PATCH] docs(plan): Entscheidungen zur Freigabe festhalten MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Ubuntu 26.04 kommt mit, Templates booten UEFI, Template-VMIDs werden als nächste freie ID im Template-Bereich des Servers vergeben. Refs #001 Co-Authored-By: Claude Opus 5.5 --- docs/architektur.md | 25 ++++++++++++++----------- docs/issues/007-template-bau.md | 3 ++- docs/issues/010-ubuntu.md | 4 ++-- docs/issues/README.md | 2 +- 4 files changed, 19 insertions(+), 15 deletions(-) diff --git a/docs/architektur.md b/docs/architektur.md index 8dfedf0..2b94684 100644 --- a/docs/architektur.md +++ b/docs/architektur.md @@ -1,6 +1,6 @@ # ProxDeploy – Architektur- und Umsetzungsplan -Stand: 2026-10-12 · Version 0.1.0-dev · **Entwurf zur Freigabe** +Stand: 2026-10-12 · Version 0.1.0-dev · freigegeben am 2026-10-12 ## 1. Überblick @@ -136,7 +136,7 @@ ein Austauschformat, kein Code-Bezeichner. Validiert mit zod; ein fehlerhafter E Dateiname und Pfad gemeldet und übersprungen, nicht der Start abgebrochen. Mitgeliefert (URLs am 2026-10-12 per Abruf geprüft): Debian 12, Debian 13, Ubuntu 22.04, Ubuntu 24.04. -Ubuntu 26.04 LTS ist ebenfalls verfügbar (Cloud-Image und LXC-Template) – **Vorschlag: mitliefern**. +Dazu Ubuntu 26.04 LTS (`resolute`, Cloud-Image und LXC-Template verfügbar). - Debian: `cloud.debian.org/images/cloud//latest/debian--genericcloud-amd64.qcow2`, `SHA512SUMS` (Zeilenformat `␣␣`), Benutzer `debian` @@ -145,8 +145,8 @@ Ubuntu 26.04 LTS ist ebenfalls verfügbar (Cloud-Image und LXC-Template) – **V - LXC: alle `*-standard_*_amd64.tar.zst`; bei mehreren Treffern (Debian 13: `13.1-2` und `13.6-1`) gewinnt die höchste Version (Versionssortierung). -Ergänzende Felder gegenüber der Vorgabe: `codename`, `arch` (vorerst `amd64`), `vm.bios_default` -(`ovmf`/`seabios`), `vm.template_vmid_offset` (z. B. Debian 13 → 9013), `vm.min_disk_gb`. +Ergänzende Felder gegenüber der Vorgabe: `codename`, `arch` (vorerst `amd64`), `vm.bios` +(`ovmf` Standard, `seabios` möglich), `vm.min_disk_gb`. ### Provisionierungs-Adapter @@ -592,11 +592,14 @@ kleiner HTTP-Server mit Zustand, der die benutzten Endpunkte inkl. UPID-Tasks na Abnahme jeder Etappe gegen echten Proxmox wird nachgeholt und im DEVLOG vermerkt; ohne sie wird die Version nicht als abgeschlossen markiert. -## 15. Offene Punkte +## 15. Entscheidungen zur Freigabe (2026-10-12) -1. **Ubuntu 26.04** zusätzlich mitliefern? (Vorschlag: ja) -2. **Standard-BIOS** für Templates: OVMF (UEFI, braucht EFI-Disk) oder SeaBIOS? (Vorschlag: OVMF, - pro Distribution überschreibbar) -3. **Template-VMID-Schema**: feste Zuordnung je Distribution (Debian 13 → 9013, Ubuntu 24.04 → 9024) - plus Node-Versatz im Cluster mit lokalem Storage (pve02 → 9113)? (Vorschlag: ja) -4. **Domain** für `APP_URL` und OIDC-Redirect – kann später in `.env` gesetzt werden. +1. **Ubuntu 26.04 LTS** wird mitgeliefert (Debian 12/13, Ubuntu 22.04/24.04/26.04). +2. **Templates booten UEFI** (OVMF, q35, EFI-Disk mit `pre-enrolled-keys=1`); `vm.bios` pro + Distribution überschreibbar. +3. **Template-VMID:** keine feste Zuordnung. ProxDeploy nimmt die **nächste freie ID im + Template-Bereich** des Servers (Standard 9000–9999), ermittelt aus `/cluster/resources` plus + eigenen Reservierungen – dieselbe Sperre wie bei Gast-IDs. Welche VMID welches Template ist, + steht in der Tabelle `Template` und als Tag (`proxdeploy-template`, `distro-debian-13`) in Proxmox. +4. **Namensabbildung** aus Abschnitt 7 und deutsche API-Pfade bestätigt; Katalog-YAML bleibt englisch. +5. **Domain** für `APP_URL` und OIDC-Redirect folgt später über `.env`. diff --git a/docs/issues/007-template-bau.md b/docs/issues/007-template-bau.md index 5790e45..0482ae1 100644 --- a/docs/issues/007-template-bau.md +++ b/docs/issues/007-template-bau.md @@ -10,7 +10,8 @@ Cloud-Image laden, Prüfsumme prüfen, VM anlegen, Disk importieren, Guest-Agent ## Aufgaben - [ ] Weg A (≥ 8.4): `download-url` (content=import, checksum) + `import-from` per Volume-ID - [ ] Weg B (SSH): Download + Prüfung auf dem Node, Import per `qm importdisk`/`import-from` -- [ ] Hardware: q35, OVMF+EFI-Disk oder SeaBIOS, virtio-scsi-single, discard/ssd/iothread, CPU host, serielle Konsole, agent=1, cloud-init-Laufwerk +- [ ] VMID: nächste freie im Template-Bereich (Entscheidung 2026-10-12) +- [ ] Hardware: q35, OVMF+EFI-Disk (Standard) oder SeaBIOS, virtio-scsi-single, discard/ssd/iothread, CPU host, serielle Konsole, agent=1, cloud-init-Laufwerk - [ ] Guest-Agent einbauen: Snippet (SSH) oder Bau-Adresse + SSH in die VM - [ ] Template-Übersicht je Server/Node, VMID-Bereich konfigurierbar - [ ] Singleton je Server+Distribution diff --git a/docs/issues/010-ubuntu.md b/docs/issues/010-ubuntu.md index a59944d..59a59eb 100644 --- a/docs/issues/010-ubuntu.md +++ b/docs/issues/010-ubuntu.md @@ -1,4 +1,4 @@ -# #010 Ubuntu 22.04 und 24.04 +# #010 Ubuntu 22.04, 24.04 und 26.04 **Status:** offen **Meilenstein:** v0.3.0 **Labels:** feature, katalog @@ -9,7 +9,7 @@ Ubuntu als VM und LXC über den debian-Adapter. ## Aufgaben - [ ] Unterschiede im Adapter (Codename-Ermittlung, Locale-Paket, unattended-upgrades) -- [ ] ggf. Ubuntu 26.04 (offener Punkt) +- [ ] Ubuntu 26.04 „Resolute“ (entschieden 2026-10-12) ## Akzeptanzkriterien - [ ] Je eine Ubuntu-VM und ein Ubuntu-LXC ausgerollt diff --git a/docs/issues/README.md b/docs/issues/README.md index 3334864..e4d9abb 100644 --- a/docs/issues/README.md +++ b/docs/issues/README.md @@ -13,7 +13,7 @@ Details und Architektur: [../architektur.md](../architektur.md). Zeiten werden a | [#007](007-template-bau.md) | Template-Bau für VMs | offen | v0.2.0 | 8 h | – | | [#008](008-vm-ausrollen.md) | Deploy-Assistent und VM ausrollen | offen | v0.2.0 | 10 h | – | | [#009](009-lxc.md) | LXC-Container ausrollen | offen | v0.3.0 | 8 h | – | -| [#010](010-ubuntu.md) | Ubuntu 22.04 und 24.04 | offen | v0.3.0 | 3 h | – | +| [#010](010-ubuntu.md) | Ubuntu 22.04, 24.04 und 26.04 | offen | v0.3.0 | 3 h | – | | [#011](011-profile-docker-zabbix.md) | Profile docker und zabbix-agent, Variablen, Editor | offen | v0.3.0 | 6 h | – | | [#012](012-vorlagen.md) | Vorlagen (Presets) | offen | v0.3.0 | 3 h | – | | [#013](013-cli.md) | CLI proxdeploy (Go) | offen | v0.4.0 | 12 h | – |