docs(plan): Entscheidungen zur Freigabe festhalten

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 <noreply@anthropic.com>
This commit is contained in:
2026-10-12 09:13:32 +02:00
co-authored by Claude Opus 5.5
parent 6c16d56960
commit c3211d0fe2
4 changed files with 19 additions and 15 deletions
+14 -11
View File
@@ -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/<codename>/latest/debian-<n>-genericcloud-amd64.qcow2`,
`SHA512SUMS` (Zeilenformat `<hash>␣␣<datei>`), 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`.