Files

T

florian.wildeandClaude Opus 5.5 acae1bc2a4 feat(katalog): Distributionen und Profile als YAML-Daten

Fünf Distributionen (Debian 12/13, Ubuntu 22.04/24.04/26.04) und drei
Profile liegen unter catalog/ und werden beim Start abgeglichen. Die
Datei ist maßgeblich für den Inhalt, die Datenbank nur für „aktiv“;
verschwundene Einträge werden markiert, nicht gelöscht.

Unbekannte Schlüssel sind Fehler, damit Tippfehler nicht still
verschwinden; eine kaputte Datei wird mit Pfad gemeldet und
übersprungen, statt den Start zu verhindern. Prüfsummen-Parser kennt
das Debian-, Ubuntu- und BSD-Format; bei mehreren LXC-Templates gewinnt
die höchste Version.

Closes #004

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-12 10:11:14 +02:00

3.9 KiB

Raw Blame History

DEVLOG – ProxDeploy

Zeitübersicht

Gesamt: 1 h 24 min (laufende Sitzung)

Zeiten stammen aus den Git-Commit-Zeitstempeln je Issue; Wartezeit auf Rückmeldungen ist enthalten.

Issue	Zeit
#001 Projekt-Setup	0 h 50 min
#002 Server-Verwaltung	0 h 11 min
#003 Verbindungstest	0 h 25 min
#004 Katalog	0 h 09 min

Meilenstein	Zeit
v0.1.0	1 h 15 min
v0.2.0	–

2026-10-12 · Sitzung 1 · 08:45–laufend

Issue: #001 Version: 0.1.0-dev

Erledigt

Auftrag gelesen, Rückfragen gestellt: Reverse-Proxy (ja), OIDC (implementieren, vorerst nur lokal testen), Testumgebung (folgt), CLI (Go)
Umgebung geprüft: Docker 29 vorhanden, Node und Go fehlen → Builds und Tests laufen im Container
Proxmox-API 8.x/9.x gegen API-Schema 9.2, Quellen der stable-8-Zweige und Release Notes geprüft (Ergebnis: docs/architektur.md Abschnitt 3)
Image-URLs, Prüfsummen-Dateien, LXC-Template-Namen, Docker- und Zabbix-Repos per Abruf geprüft
Git-Repository (main), CHANGELOG, DEVLOG, Architekturplan und 20 Issues angelegt
Plan freigegeben: Ubuntu 26.04 dazu, Templates mit UEFI, Template-VMID = nächste freie im Template-Bereich, Namensabbildung bestätigt
#003 abgeschlossen: Verbindungstest mit Fähigkeitserkennung und SSH-Host-Key-Pinning; 127 Tests
Feldtest auf dem Testhost pve-demo (PVE 9.2.2): Rolle/Token nach Doku per SSH angelegt, Fingerprint und Host-Key gegen den Node verglichen, Test mit und ohne SSH – alles wie erwartet
Meilenstein v0.1.0 abgeschlossen, getaggt und nach Gitea gepusht
README als Zwischenstand angelegt (Florian: „readme im projekt fehlt“)
#004 abgeschlossen: Katalog mit fünf Distributionen und drei Profilen, Abgleich, Katalogseite; 150 Tests, 12 Playwright-Abläufe
#002 abgeschlossen: Server-Verwaltung mit Fingerprint-Pinning, Proxmox-Client, Proxmox-Mock (HTTPS, selbst signiert); 99 Tests, 10 Playwright-Abläufe
Testhost 10.0.10.228 von Florian bereitgestellt (Installation läuft)
#001 abgeschlossen: Grundgerüst mit Anmeldung, Seitenleiste, beiden Themes; 60 Tests, 8 Playwright-Abläufe (Desktop + 390 px)

Entscheidungen

VM-Provisionierung immer über den Guest-Agent: funktioniert ohne SSH und liefert Live-Fortschritt. Snippets braucht es nur beim Template-Bau.
Guest-Agent wird ins Template gebaut: keines der vier Cloud-Images bringt ihn mit, und ohne Agent gibt es bei DHCP keine IP und keine Provisionierung.
LXC braucht für Profile immer SSH (zum Node oder in den Container): Proxmox hat keine Exec-API für Container.
Template-Bau per API erst ab PVE 8.4 (download-url mit content=import); davor über SSH.
Planer und Ausführung getrennt: der Dry-Run zeigt exakt den Plan, den der worker danach abarbeitet.
CLI in Go mit aus OpenAPI generiertem Client.
Konfiguration aus Laufzettel übernommen (gleicher Stack, Versionen dort bereits erprobt); Next auf 16.4.0 wie ProxLedger (Sicherheitsstand).
Sitzungsgeheimnis und Datenschlüssel getrennt (SITZUNG_GEHEIMNIS, PROXDEPLOY_SCHLUESSEL): ein Tausch des Sitzungsgeheimnisses meldet nur alle ab, der Datenschlüssel darf sich nie ändern.
Amber und Rot im hellen Theme abgedunkelt (#8A5A00, #B91C1C): die Originaltöne erreichen auf #F4F6F8 keine 4,5:1.
TLS-Pinning über einen eigenen undici-Connector statt rejectUnauthorized: false + Nachprüfen: die Verbindung wird getrennt, bevor das Token gesendet wird. Sitzungs-Cache aus, sonst fehlt bei Wiederaufnahme das Zertifikat.
Zugang zum Testhost über einen eigenen SSH-Schlüssel (~/.ssh/proxdeploy-testhost), nicht über das root-Passwort: Claude Code verweigert das Anlegen von Zugängen mit Passwort, und ein Schlüssel nur für diesen Host ist ohnehin der sauberere Weg.
Deutsche Bezeichner wie in ProxLedger und Laufzettel; YAML-Schlüssel im Katalog bleiben englisch (Vorgabe).