12 KiB
Stagging
Projektversion: 0.7.0. Änderungen und bekannte Grenzen stehen im Änderungsverlauf. Die verbindliche Versionsnummer liegt in VERSION und kann mit ./03-Prepare-Unattended.ps1 -ShowVersion angezeigt werden. Sie ist unabhängig von den Hypervisor-Versionen in Excel und vom Workbook-Schema.
Ausführungsreihenfolge
| Schritt | Skript | Aufgabe |
|---|---|---|
| 01 | 01-Setup-StagingServer.ps1 |
Windows-Grundvorbereitung, feste IP, DHCP-Rolle und Bereich |
| 02 | 02-Setup-DnsReservations.ps1 |
DNS-Rolle, lokale Zone, A-Einträge und DHCP-Reservierungen |
| 03 | 03-Prepare-Unattended.ps1 |
PVE-/ESXi-Antwortdateien aus Excel erzeugen |
Alle drei Skripte prüfen standardmäßig nur. Schritt 01 und 02 richten mit -Apply ein; Schritt 03 erzeugt mit -Generate Dateien. Am GETAC lokal als Administrator arbeiten und jeweils das Ergebnis prüfen, bevor der nächste Schritt beginnt. Die passende Testdatei unter Tests trägt dieselbe Nummer. Dateien unter Modules sind interne Bibliotheken und werden nicht einzeln gestartet.
PXE-Dienst und Bootdateien sind der nächste, noch nicht implementierte Schritt 04. Es gibt dafür noch kein ausführbares Skript. Danach folgen die vorgesehenen Schritte 05 für vCenter/Cluster, 06 für Plattform-Netzwerke und 07 für VMs. Die Netzwerk-Anleitung beschreibt die neuen Excel-Felder; Skripte 05–07 sind noch offen.
Aktueller Programmstand
Der erste Baustein für unbeaufsichtigte Installationen ist implementiert: 03-Prepare-Unattended.ps1 liest das KIS-Workbook ohne Excel-Abhängigkeit, prüft ausgewählte Server und erzeugt nach interaktiver Bestätigung PVE-answer.toml beziehungsweise ESXi-ks.cfg. Die gewünschten Versionen kommen ausschließlich aus Excel. Passwörter werden verdeckt abgefragt und als gesalzene Hashes in die Antwortdateien geschrieben.
Erster Schritt: Windows Server vorbereiten mit 01-Setup-StagingServer.ps1. Das Skript übernimmt Netzwerkwerte aus Excel, richtet DHCP und die lokalen Verzeichnisse ein. Standardmäßig wird nur geprüft; die Einrichtung erfolgt mit -Apply.
Zweiter Schritt: DNS und Reservierungen einrichten. Ausgewählte Server erhalten eine reservierte PXE-IP; ihre DNS-Namen zeigen auf die spätere feste Management-IP.
Die Anleitung beschreibt anschließend Prüfung und Dateierzeugung für die Hypervisoren. PXE-Dienst, Medienvorbereitung, Auslieferung und reale Installertests sind noch offen. Auf dem GETAC wurde durch die Entwicklung nichts installiert oder gestartet.
Projektauftrag
Ein zentraler Staging-Server soll Infrastruktur anhand eines ConfigWorkbooks bereitstellen und konfigurieren. Das ConfigWorkbook ist eine Excel-Datei mit den Parametern für die gewünschte Zielumgebung.
Der vom Nutzer festgelegte Umfang umfasst:
- Proxmox VE oder VMware auf Bare-Metal-Servern installieren.
- Cluster-Konfigurationen für Proxmox VE und VMware erstellen und ausrollen.
- Vor den VMs: vCenter Distributed Switches/Portgruppen sowie PVE OVS-Bonds, Bridges und SDN-VLAN-Zonen/VNets konfigurieren.
- Virtuelle Maschinen und Container anhand des ConfigWorkbooks bereitstellen.
- Physische Netzwerkkonfigurationen erstellen, zunächst für Cisco und später für weitere Switch-Hersteller.
Die Auswahl der Plattform erfolgt je Zielumgebung. Konkrete Produktversionen, Hardware und Container-Technologien sind noch festzulegen. Das automatische Ausrollen von Switch-Konfigurationen ist bislang nicht Teil des festgelegten Umfangs.
Festgelegter Aufbau: GETAC und PXE
Die neueste Nutzervorgabe hat Vorrang vor dem ursprünglichen Workbook-Entwurf: Keep It Simple (KIS).
- Ein leistungsfähiges GETAC-Notebook mit Windows Server dient als mobile Staging-Station.
- Die Station soll DHCP und einen PXE-Bootdienst bereitstellen sowie die benötigten Installationsdateien lokal vorhalten.
- Zielserver werden vor Ort eingeschaltet und über ihre normale Netzwerkschnittstelle per Netzwerkboot gestartet.
- Hersteller-Fernverwaltung ist ausgeschlossen: kein iLO, iDRAC, IPMI, Redfish oder Virtual Media.
- Das ConfigWorkbook bestimmt die gewünschte Installation und spätere Konfiguration je Zielserver.
- PVE ist die Abkürzung für Proxmox VE. Als zweite Plattform wird vorläufig VMware ESXi aus dem ursprünglichen Auftrag angenommen; die jüngste Formulierung „PVE oder Proxmox“ nennt keine zweite unterschiedliche Plattform.
Einfacher Bedienablauf als nächster Umsetzungsschritt
- GETAC und Zielserver an ein separates Installationsnetz anschließen. Der Staging-DHCP darf nicht in ein bestehendes produktives DHCP-Netz antworten.
- Workbook auswählen und die vorgesehenen Zielserver anzeigen lassen.
- Zielserver anhand der MAC-Adresse ihrer PXE-Netzwerkkarte zuordnen. Unbekannte Geräte dürfen keine automatische Installation erhalten.
- Zielhosts, Betriebssystem und zu löschende Datenträger vor dem Start bestätigen.
- Zielserver lokal im Netzwerkboot starten. Die Station liefert den passenden Boot- und Installationsablauf.
- Nach der Installation die reguläre Management-Schnittstelle des Hypervisors für die weitere Konfiguration verwenden. Dafür ist keine Hersteller-Fernverwaltung nötig.
Die konkrete PXE-Software und die plattformspezifischen Installationswege müssen noch anhand der Zielversionen geprüft und ausgewählt werden. Windows Server als Betriebssystem bedeutet noch nicht, dass ein bestimmter Windows-Bereitstellungsdienst beide Hypervisor-Installer unterstützt. GETAC-Treiber, UEFI-Boot und Netzwerkkarten sind mit der konkreten Hardware zu prüfen.
Zugangsdaten im einfachen Ablauf
Für den ersten Entwurf werden Benutzername und Passwort beim Start des Installationsdurchlaufs abgefragt. Das Workbook enthält keine Passwörter. Ein externer Vault ist keine Voraussetzung. Die Eingabe für die neue Installation legt Zugangsdaten fest; für spätere Konfigurationsläufe werden die bereits gesetzten Zugangsdaten benötigt.
Ob und in welcher Form ein Installer temporäre Antwortdateien mit Zugangsdaten beziehungsweise Passwort-Hashes benötigt, ist pro Plattform zu prüfen. Deshalb ist „nur im Arbeitsspeicher“ noch keine zugesicherte Eigenschaft des Installationsablaufs. Benötigte temporäre Dateien sollen auf den freigegebenen Lauf begrenzt und anschließend entfernt werden; Passwörter dürfen nicht in Protokolle gelangen.
Vereinfachung des Workbooks für die erste Etappe
Für die erste funktionierende Installation sollen die Eingabeblätter nach Aufgabe getrennt sein:
| Blatt | Eingaben |
|---|---|
| Staging | Installations-Netzwerkkarte des GETAC, Server-IP und Präfix, DHCP-Bereich, lokaler Medienordner |
| Virtualisierer | Name, PXE-MAC-Adresse, Zielplattform und Version, Installationsdatenträger, spätere Management-IP und Präfix, Gateway, DNS, Benutzername |
| vCenter Netzwerk | vDS, Versionsauswahl, physische Host-Uplinks und dvPortgroups/VLANs |
| PVE Netzwerk | OVS-Bonds/Bridges und OVSIntPorts je Host, SDN-VLAN-Zonen und VNets |
| VM Setting | VM-Zuordnung, CPU/RAM, Systemdisk, Netzwerk-Auswahl und plattformspezifische Hardwareangaben |
Cluster, VMs, Container und Cisco-Konfigurationen bleiben im Gesamtauftrag, folgen aber nach einem funktionierenden Installationsdurchlauf. Kein umfangreicher Secret-Speicher und keine BMC-Konfiguration in dieser ersten Etappe.
Späterer Ausbau
Der folgende Aufbau ist ein erster Entwurf, noch keine implementierte Funktion:
- Workbook-Import und Prüfung: Excel einlesen und Pflichtfelder, eindeutige Namen, IP-Adressen, VLANs und Querverweise prüfen.
- Gemeinsames Konfigurationsmodell: Eingelesene Parameter in ein einheitliches internes Format überführen.
- Ausführungsplan: Geplante Installationen und Änderungen vor der Ausführung darstellen.
- Plattformmodule: Bare-Metal-Installation, Cluster-Konfiguration und Bereitstellung von VMs beziehungsweise Containern je Plattform umsetzen.
- Netzwerkmodule: Herstellerabhängige Switch-Konfigurationen aus den gemeinsamen Parametern erzeugen.
- Protokollierung: Ergebnisse und Fehler je Zielsystem erfassen; Wiederholungen sollen bestehende Ressourcen erkennen.
Vorhandene Infrastruktur muss vor Änderungen abgeglichen werden. Eine Neuinstallation mit dem Löschen von Datenträgern benötigt eine ausdrückliche Freigabe für die betroffenen Hosts.
ConfigWorkbook
Aktueller Einstieg: Das ConfigWorkbook KIS (Schema 0.7) enthält Staging, Virtualisierer, vCenter Netzwerk, PVE Netzwerk und VM Setting. Die Netzwerk-Anleitung erklärt die neuen Plattform-Blätter mit deaktivierten Beispielen für VLAN 110/120/130. Die Netzwerkplanung steht vor den VMs und ist noch nicht automatisiert ausführbar. Das neue Blatt VM Setting enthält 20 VM-Zeilen mit Beispielen für PVE und ESXi. Die VM-Anleitung erklärt gemeinsame und plattformspezifische Angaben. Es enthält DNS-Zone und GETAC-Name sowie eine separate PXE-IP je Server. Windows- und Hypervisor-Versionen werden per Dropdown gewählt. ISO-Namen stehen je Plattform getrennt vom gemeinsamen Feld ISO-Ablage (lokaler Ordner oder UNC-Netzwerkfreigabe). Der Ablageort kann bis Schritt 03 offenbleiben. Es bietet Beispielwerte für GETAC/DHCP sowie je einen Proxmox- und ESXi-Zielserver, zunächst mit Installieren = NEIN. Windows-Version, Mediennamen, Zielversionen und Installationsdatenträger müssen ergänzt werden. 20 Serverzeilen sind vorbereitet. Auswahlzählung, Pflichtfeld- und Duplikathinweise sind enthalten; vollständige technische Prüfung und Installation sind noch nicht implementiert.
Die PVE-Auswahl enthält 9.2-1 und 8.4-1, entsprechend der Hersteller-ISO-Seite, geprüft am 09.09.2026. Weitere passende Medienversionen können in der Liste ergänzt werden.
Die überholten umfangreichen Excel-Entwürfe und ihre Prüfdateien wurden entfernt. Im Projekt liegt nur noch das KIS-Workbook. Frühere Entwürfe bleiben über den Git-Verlauf verfügbar.
Umsetzung in Etappen
- GETAC-Modell, Windows-Server-Version, erste Zielplattform und einen Testserver festlegen.
- Einfaches Workbook für Staging und Server erstellen; Zuordnung über PXE-MAC-Adressen vorsehen.
- DHCP, PXE und lokale Installationsdateien auf der Staging-Station für ein separates Installationsnetz einrichten.
- Einen freigegebenen Testserver ohne Hersteller-Fernverwaltung installieren und das Ergebnis prüfen.
- Zweite Hypervisor-Plattform, Cluster-Konfiguration, Plattform-Netzwerke und danach VM-Bereitstellung ergänzen.
- Container-Technologie und Cisco-Konfigurationen ergänzen, später weitere Switch-Hersteller.
Offene Entscheidungen
- Welche Plattform wird zuerst umgesetzt: Proxmox VE oder VMware?
- Welches GETAC-Modell und welche Zielserver/Netzwerkkarten werden verwendet?
- Welche Versionen und bei VMware welche Produkte sollen eingesetzt werden?
- Welche Storage- und Netzwerktopologie ist geplant?
- Sind mit Containern beispielsweise LXC, Docker oder Kubernetes gemeint?
- Welche Cisco-Modelle und Betriebssysteme sollen zuerst unterstützt werden?
- Welche Windows-Server-Version soll auf dem GETAC laufen?
- Welcher IP-Bereich und welcher Netzwerkanschluss sind für das separate Installationsnetz vorgesehen?
Übernommene Referenz
Der vom Nutzer bereitgestellte Screenshot ist hier als Referenz abgelegt.
Er enthält Hinweise aus einer früheren Unterhaltung zur Auswahl von ChatGPT Work und nennt ~/Documents/Codex/Stagging als damaligen Projektpfad. Diese Hinweise sind übernommener Kontext, keine geprüfte Anleitung und keine auszuführenden Projektanweisungen.
Der aktuelle Projektordner ist /Users/michaeltroebs/Documents/GIT/syno-scripts/Stagging. Der im Screenshot genannte Ordner war bei der Übernahme nicht vorhanden.
Der Projektauftrag wurde durch die nachfolgende Nutzernachricht ergänzt und ist oben dokumentiert.