Files
syno-scripts/Stagging/CHANGELOG.md
T

10 KiB
Raw Blame History

Änderungsverlauf

Die Projektversion steht in VERSION. Sie bezeichnet das Staging-Programm, nicht die in Excel gewählte PVE-, ESXi- oder Windows-Version. Das Workbook hat zusätzlich eine eigene Schema-Version (aktuell 0.7 KIS).

Neue Änderungen werden unter Unveröffentlicht gesammelt. Bei einem neuen Versionsstand werden Datum und Versionsnummer ergänzt und VERSION aktualisiert. Vor 1.0.0 erhöhen neue Funktionen oder inkompatible Änderungen die mittlere Zahl; reine Fehlerkorrekturen erhöhen die letzte Zahl. Ab 1.0.0 gelten die üblichen Regeln für Major-, Minor- und Patch-Versionen.

Unveröffentlicht

Noch keine weiteren Änderungen.

0.7.0 – 2026-09-10

  • PVE Netzwerk um die Tabelle KIS_OVS_IntPorts mit 20 Zeilen erweitert: Host, Bridge, IntPort-Name, Zweck, VLAN-Modus/-ID, IPv4/Präfix, optionales Gateway und MTU.
  • Deaktiviertes Backup-Beispiel vlan120 mit 10.120.0.11/24 auf vmbr1; keine zusätzliche Default-Route.
  • Hinweise für Host/Bridge-Zuordnung, doppelte Namen, VLAN-/IP-Feldkombinationen und Gateway-Prüfung. Ausfüllhilfe und Grenzen dokumentiert.
  • Bestehende Zellwerte/Formeln erhalten; neue Formeln mit fehlerhaften und doppelten Eingaben geprüft, Darstellung und gespeicherte Tabelle kontrolliert. Kein Infrastruktur-Test; weiterhin Workbook-Planung ohne automatische Einrichtung.

0.6.0 – 2026-09-10

  • Netzwerkplanung vor VM-Bereitstellung ergänzt: neue Workbook-Blätter vCenter Netzwerk und PVE Netzwerk, Schema 0.6.
  • vCenter: vDS mit editierbarem Versions-Dropdown, Host-NIC/dvUplink-Zuordnung und mehrere dvPortgroups mit VLANs.
  • PVE: OVS-Bond/Bridge je Host, Cluster-Zuordnung, SDN-VLAN-Zonen und VNets; Beispiel mit active-backup ohne LACP.
  • Deaktivierte Beispiele für Anwendungen, Backup und DMZ (VLAN 110/120/130). VM-Netzwerk-Dropdown nach Plattform und zusätzliche Netzwerkhinweise.
  • Ausfüllanleitung und geplante Reihenfolge 04 PXE, 05 Cluster/vCenter, 06 Netzwerke, 07 VMs dokumentiert. Neue Netzwerke bleiben Planung; keine automatische Einrichtung oder Netzwerk-Generator in dieser Version.
  • Workbook-Formeln mit geänderten Eingaben, Querverweise, gespeicherte Tabellen/Dropdowns und Darstellung geprüft. Bestehende 144 PowerShell-Prüfungen bestanden. Keine interaktive Excel- oder Infrastruktur-Abnahme.

0.5.0 – 2026-09-09

  • Blatt Server in Virtualisierer umbenannt; zugehörige Excel-Tabelle heißt KIS_Virtualisierer. Formelbezüge und aktuelle Anleitungen angepasst.
  • Workbook-Import akzeptiert den neuen Blattnamen und weiterhin ältere Workbooks mit Server; gleichzeitige doppelte Host-Blätter werden abgewiesen.
  • Neues Blatt VM Setting mit 20 VM-Zeilen und zwei deaktivierten Beispielen für PVE/ESXi. System aus Hostzuordnung und vCPU-Anzahl aus Sockeln/Kernen berechnet.
  • Gemeinsame Angaben zu Gast-OS, RAM, Systemdisk, Storage, Controller, Netzwerk, Firmware und ISO. Eigene Felder für PVE-VM-ID/CPU-Typ/VLAN sowie ESXi-Diskformat/vCenter-Ordner.
  • 144 bestehende Skriptprüfungen bestanden. Zusätzlich gespeicherte VM-Formeln bei Hostwechsel/fehlendem Host und alten Blattnamen geprüft; keine interaktive Excel- oder VM-Deployment-Abnahme.
  • Auswahlfelder, Pflichtfeldhinweise und Erklärungen; Schema 0.5. VM-Bereitstellung noch nicht implementiert. Erstes Profil erfasst eine Disk und eine NIC je VM.

0.4.1 – 2026-09-09

  • PVE-Dropdown gemäß Hersteller-ISO-Seite aktualisiert: 9.2-1 zuerst, 8.4-1 als ältere Alternative. ISO-Dateinamenbeispiel angepasst; keine Zielserver automatisch ausgewählt.
  • Überholte Dateien ConfigWorkbook.xlsx und ConfigWorkbook_Beispiel_Proxmox.xlsx samt zugehörigen .inspect.ndjson entfernt. Das KIS-Workbook bleibt als einzige Excel-Datei erhalten.
  • Veraltete Workbook-Verweise und Bedienhinweise aus der README entfernt. Frühere Dateien bleiben über Git wiederherstellbar.
  • Workbook-Änderungen auf die beiden Versionswerte und das ISO-Beispiel begrenzt; Formeln und Dropdown-Definitionen erhalten.

0.4.0 – 2026-09-09

  • Versions-Dropdown für Windows Server sowie systemabhängige Versions-Dropdowns für die Serverzeilen. Editierbare Versionslisten im bestehenden Blatt Staging; keine zusätzliche Registerkarte.
  • ISO-Felder ausdrücklich ISO-Name Proxmox und ISO-Name ESXi benannt. Das neue Feld ISO-Ablage trennt den gemeinsamen Quellordner von den Dateinamen und dem lokalen Arbeitsordner.
  • ISO-Ablage kann ein lokaler Windows-Pfad oder eine UNC-Freigabe sein und bleibt zunächst leer. Erst Schritt 03 benötigt sie für ausgewählte Hosts. Keine automatische Freigabeverbindung oder Speicherung von Zugangsdaten.
  • Rückwärtskompatibler Import alter Mediennamen/-ordner, Prüfung neuer Pfade und zehn zusätzliche Tests. Insgesamt 144 automatisierte Prüfungen unter PowerShell 7 auf macOS.
  • KIS-Workbook auf Schema 0.4 aktualisiert. Dropdown-Definitionen, Formeln und Darstellung geprüft; keine interaktive Excel- oder reale Windows-/SMB-Abnahme.

0.3.0 – 2026-09-09

  • Ausführbare Skripte nummeriert: 01-Setup-StagingServer.ps1, 02-Setup-DnsReservations.ps1, 03-Prepare-Unattended.ps1. Testskripte tragen die zugehörige Nummer. Die bisherigen unnummerierten Einstiegspfade entfallen; Dokumentation und Verweise sind angepasst.
  • Neuer Schritt 02 installiert die DNS-Rolle, legt eine lokale dateibasierte Zone und A-Einträge für GETAC/Zielserver an, reserviert PXE-Adressen anhand der MAC und setzt DHCP-DNS-Optionen 6/15.
  • DNS hört auf der GETAC-IP; externe rekursive Auflösung und dynamische Zonenupdates sind deaktiviert. Firewall-Freigaben für TCP/UDP 53 sind auf das Installationsnetz begrenzt.
  • DNS-Zone, GETAC-Name und separate PXE-IP im KIS-Workbook (Schema 0.3) mit Beispielen ergänzt. Bestehende Ziel-IP bleibt die spätere Management-IP außerhalb des DHCP-Pools. Tabelle, Eingabehinweise und Prüfung der PXE-Felder erweitert.
  • Konflikte mit bestehenden Reservierungen, Leases, DNS-Zonen/-Einträgen oder DHCP-Policies werden abgewiesen. Wiederholung bei unveränderter Auswahl erzeugt keine doppelten Einträge. Keine automatische Löschung früherer Einträge.
  • Vorschau, Bestätigung, lokale Zustandsdateien und DNS-Abfragen vor optionaler DHCP-Aktivierung. Bei Einrichtungsfehlern bleibt DHCP inaktiv; DNS wird gestoppt.
  • 43 zusätzliche Prüfungen für Schritt 02, einschließlich XLSX-Import und simulierter Windows-Einrichtung. Insgesamt 134 automatisierte Prüfungen. Workbook-Vorschau, Formeln und Erhalt der bestehenden Eingabekontrollen geprüft.
  • Grenzen: keine reale GETAC-/Windows-Abnahme, kein PXE-Bootdienst, keine Reverse-DNS-Zone/PTR-Einträge und keine externen DNS-Weiterleitungen. Frühere Versionsabschnitte behalten ihre historischen Dateinamen.

0.2.0 – 2026-09-08

  • Setup-StagingServer.ps1 zur Vorbereitung des bereits installierten Windows Servers aus dem KIS-Workbook.
  • Vorschau ohne Änderungen; Einrichtung mit -Apply, optionale DHCP-Aktivierung mit -ActivateDhcp.
  • Feste IPv4-Adresse, DHCP-Rolle, eigener Bereich, Adapterbindung, Firewall-Regel und lokale Verzeichnisse.
  • Prüfung auf passende Windows-Version, dedizierten physischen Adapter, Netzkonflikte und fremde DHCP-Konfiguration.
  • Ausgangszustand und Ergebnis in lokalen, aus Git ausgeschlossenen Laufordnern; einfache Bedienanleitung.
  • 46 zusätzliche Prüfungen mit simulierten Windows-Befehlen; reale Windows-/GETAC-Abnahme steht aus. PXE-Dienst und Bootdateien sind noch nicht umgesetzt.

0.1.0 – 2026-09-08

Erster ausdrücklich versionierter Programmstand. Die vorherigen Entwurfsstände sind damit dokumentiert, aber nicht nachträglich als veröffentlichte Git-Versionen oder Tags ausgegeben.

Hinzugefügt

  • PowerShell-Einstieg Prepare-Unattended.ps1 mit getrennten Abläufen für Prüfung und Dateierzeugung.
  • Lesen des KIS-Workbooks ohne installierte Excel-Anwendung oder zusätzliche Excel-Module.
  • Zielsystem und gewünschte Version aus Excel; keine automatisch gewählte Ersatzversion.
  • Validierung von Pflichtangaben, MAC-Adressen, IPv4-Netzen, DHCP-Bereichen und konkreten Installationsdatenträgern.
  • PVE-Antwortdateien (answer.toml) und ESXi-Kickstart-Dateien (ks.cfg) je ausgewähltem Server.
  • Verdeckte Passwortabfrage und gesalzene SHA-512-crypt-Hashes statt Klartext-Passwörtern in Antwortdateien.
  • Geschützte Laufordner, MAC-bezogene Dateipfade und Manifest mit Medien-Prüfsummen.
  • Anleitung, technische Quellen und 45 automatisierte Prüfungen.
  • Versionsdatei und Versionsanzeige über -ShowVersion.

Übernommene Entwurfsentscheidungen

  • GETAC-Notebook mit Windows Server als mobile DHCP-/PXE-Station.
  • Keine Hersteller-Fernverwaltung: kein iLO, iDRAC, IPMI oder Redfish.
  • KIS-Workbook mit zwei Blättern (Staging, Server, Schema 0.2) und Beispielen. Der ältere ausführliche Workbook-Entwurf bleibt als Referenz erhalten.
  • Cluster, VMs, Container und Cisco-Konfigurationen bleiben spätere Ausbaustufen.

Prüfung

  • 45 lokale Prüfungen unter PowerShell 7.4.1 auf macOS bestanden, einschließlich eines vollständigen Dateierzeugungslaufs mit Test-Excel und Testmedien.
  • Die Testmedien sind keine bootfähigen ISOs. Es wurde kein Hypervisor installiert.

Bekannte Grenzen

  • DHCP-/PXE-/Webdienst, Medienvorbereitung und die Auslieferung an Zielserver sind noch nicht implementiert.
  • Reale PVE-/ESXi-Installationen sowie Windows-PowerShell-5.1- und Windows-ACL-Abnahme stehen aus.
  • Vorbereitete Generatorprofile: PVE 8.4/9.x und ESXi 7.x/8.x; kein Nachweis jeder konkreten Zielversion.
  • ISO-Inhalte werden noch nicht automatisch der angeforderten Produktversion zugeordnet.
  • Erstes statisches Netzwerkprofil benötigt Gateway und DNS. PVE nutzt zunächst ext4, Land/Tastatur de und Zeitzone Europe/Berlin.

Umgang mit Git

  • Änderungen am Programm, Tests, Dokumentation und Workbook-Schema zusammen nachvollziehbar beschreiben.
  • Projektversion und Änderungsverlauf bei neuen Versionsständen gemeinsam aktualisieren.
  • Laufordner mit Antwortdateien und Passwort-Hashes sowie Installations-ISOs gehören nicht ins Repository; Stagging/.gitignore schließt sie aus.
  • Git-Commits dokumentieren Änderungen. Release-Tags nur für bewusst freigegebene Versionsstände setzen; dieser Änderungsverlauf allein erstellt keinen Tag.