florian.wilde/proxdeploy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs(plan): Entscheidungen zur Freigabe festhalten

Browse Source 
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:
florian.wilde
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/architektur.md
+14 -11
View File
@@ -1,6 +1,6 @@
# ProxDeploy – Architektur- und Umsetzungsplan # 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 ## 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. 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. 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`, - Debian: `cloud.debian.org/images/cloud/<codename>/latest/debian-<n>-genericcloud-amd64.qcow2`,
`SHA512SUMS` (Zeilenformat `<hash>␣␣<datei>`), Benutzer `debian` `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`) - LXC: alle `*-standard_*_amd64.tar.zst`; bei mehreren Treffern (Debian 13: `13.1-2` und `13.6-1`)
gewinnt die höchste Version (Versionssortierung). gewinnt die höchste Version (Versionssortierung).
Ergänzende Felder gegenüber der Vorgabe: `codename`, `arch` (vorerst `amd64`), `vm.bios_default` Ergänzende Felder gegenüber der Vorgabe: `codename`, `arch` (vorerst `amd64`), `vm.bios`
(`ovmf`/`seabios`), `vm.template_vmid_offset` (z. B. Debian 13 → 9013), `vm.min_disk_gb`. (`ovmf` Standard, `seabios` möglich), `vm.min_disk_gb`.
### Provisionierungs-Adapter ### 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 Abnahme jeder Etappe gegen echten Proxmox wird nachgeholt und im DEVLOG vermerkt; ohne sie wird die
Version nicht als abgeschlossen markiert. Version nicht als abgeschlossen markiert.
## 15. Offene Punkte ## 15. Entscheidungen zur Freigabe (2026-10-12)
1. **Ubuntu 26.04** zusätzlich mitliefern? (Vorschlag: ja) 1. **Ubuntu 26.04 LTS** wird mitgeliefert (Debian 12/13, Ubuntu 22.04/24.04/26.04).
2. **Standard-BIOS** für Templates: OVMF (UEFI, braucht EFI-Disk) oder SeaBIOS? (Vorschlag: OVMF, 2. **Templates booten UEFI** (OVMF, q35, EFI-Disk mit `pre-enrolled-keys=1`); `vm.bios` pro
pro Distribution überschreibbar) Distribution überschreibbar.
3. **Template-VMID-Schema**: feste Zuordnung je Distribution (Debian 13 → 9013, Ubuntu 24.04 → 9024) 3. **Template-VMID:** keine feste Zuordnung. ProxDeploy nimmt die **nächste freie ID im
plus Node-Versatz im Cluster mit lokalem Storage (pve02 → 9113)? (Vorschlag: ja) Template-Bereich** des Servers (Standard 9000–9999), ermittelt aus `/cluster/resources` plus
4. **Domain** für `APP_URL` und OIDC-Redirect – kann später in `.env` gesetzt werden. 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`.
docs/issues/007-template-bau.md
+2 -1
View File
@@ -10,7 +10,8 @@ Cloud-Image laden, Prüfsumme prüfen, VM anlegen, Disk importieren, Guest-Agent
## Aufgaben ## Aufgaben
- [ ] Weg A (≥ 8.4): `download-url` (content=import, checksum) + `import-from` per Volume-ID - [ ] 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` - [ ] 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 - [ ] Guest-Agent einbauen: Snippet (SSH) oder Bau-Adresse + SSH in die VM
- [ ] Template-Übersicht je Server/Node, VMID-Bereich konfigurierbar - [ ] Template-Übersicht je Server/Node, VMID-Bereich konfigurierbar
- [ ] Singleton je Server+Distribution - [ ] Singleton je Server+Distribution
docs/issues/010-ubuntu.md
+2 -2
View File
@@ -1,4 +1,4 @@
# #010 Ubuntu 22.04 und 24.04 # #010 Ubuntu 22.04, 24.04 und 26.04
**Status:** offen **Status:** offen
**Meilenstein:** v0.3.0 **Meilenstein:** v0.3.0
**Labels:** feature, katalog **Labels:** feature, katalog
@@ -9,7 +9,7 @@ Ubuntu als VM und LXC über den debian-Adapter.
## Aufgaben ## Aufgaben
- [ ] Unterschiede im Adapter (Codename-Ermittlung, Locale-Paket, unattended-upgrades) - [ ] Unterschiede im Adapter (Codename-Ermittlung, Locale-Paket, unattended-upgrades)
- [ ] ggf. Ubuntu 26.04 (offener Punkt) - [ ] Ubuntu 26.04 „Resolute“ (entschieden 2026-10-12)
## Akzeptanzkriterien ## Akzeptanzkriterien
- [ ] Je eine Ubuntu-VM und ein Ubuntu-LXC ausgerollt - [ ] Je eine Ubuntu-VM und ein Ubuntu-LXC ausgerollt
docs/issues/README.md
+1 -1
View File
@@ -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 | – | | [#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 | – | | [#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 | – | | [#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 | – | | [#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 | – | | [#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 | – | | [#013](013-cli.md) | CLI proxdeploy (Go) | offen | v0.4.0 | 12 h | – |