Files
syno-scripts/Stagging/CHANGELOG.md
T

6.8 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.4 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.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.