Files
syno-scripts/Stagging/README.md
T
2026-09-08 10:33:38 +02:00

11 KiB

Stagging

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:

  1. Proxmox VE oder VMware auf Bare-Metal-Servern installieren.
  2. Cluster-Konfigurationen für Proxmox VE und VMware erstellen und ausrollen.
  3. Virtuelle Maschinen und Container anhand des ConfigWorkbooks bereitstellen.
  4. 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

  1. GETAC und Zielserver an ein separates Installationsnetz anschließen. Der Staging-DHCP darf nicht in ein bestehendes produktives DHCP-Netz antworten.
  2. Workbook auswählen und die vorgesehenen Zielserver anzeigen lassen.
  3. Zielserver anhand der MAC-Adresse ihrer PXE-Netzwerkkarte zuordnen. Unbekannte Geräte dürfen keine automatische Installation erhalten.
  4. Zielhosts, Betriebssystem und zu löschende Datenträger vor dem Start bestätigen.
  5. Zielserver lokal im Netzwerkboot starten. Die Station liefert den passenden Boot- und Installationsablauf.
  6. 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 zwei Eingabeblätter genügen:

Blatt Eingaben
Staging Installations-Netzwerkkarte des GETAC, Server-IP und Präfix, DHCP-Bereich, lokaler Medienordner
Server Name, PXE-MAC-Adresse, Zielplattform und Version, Installationsdatenträger, spätere Management-IP und Präfix, Gateway, DNS, Benutzername

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.

Entwurf des ConfigWorkbooks

Die erste Excel-Vorlage (Schema 0.1) ist erstellt. Sie enthält 22 Konfigurationsblätter sowie Startseite, Feldkatalog und separate Beispielwerte. Pro Konfigurationsblatt sind 50 Eingabezeilen vorbereitet. Pflichtfelder, Auswahllisten und Statusformeln unterstützen die Erfassung; die Formeln prüfen Pflichtangaben, doppelte IDs, direkte Referenzen und ausgewählte bedingte Pflichtfelder. Eine vollständige technische Validierung und Deployment-Module sind noch nicht implementiert.

Aktueller Einstieg: Das ConfigWorkbook KIS (Schema 0.2) enthält ausschließlich Staging und Server. 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 älteren Excel-Dateien zeigen den vorherigen umfangreichen Entwurf. HostBMC, Redfish-/VirtualMedia-Beispiele und die vorausgesetzten Vault-Verweise sind durch die neue Vorgabe überholt. Für den nächsten Umsetzungsschritt die KIS-Version verwenden.

Mit dem Blatt Start beginnen. Die tatsächlichen Feldnamen und Regeln der Version 0.1 stehen im Feldkatalog; die folgende Tabelle beschreibt den ursprünglichen Grobentwurf. Zusätzliche Blätter trennen Installation, Fernverwaltung, Vorlagen, Storage-Zuordnungen, Container-Volumes/-Netze und Switch-Layer-3-Konfigurationen.

Zum leichteren Einstieg gibt es eine ausgefüllte Proxmox-Beispielversion mit zwei Hosts, einem Cluster ohne HA, einer VM, einem LXC und einem Cisco-Switch. Das Blatt Einstieg erklärt die Ausfüllreihenfolge und welche Werte zu ersetzen sind. Alle Daten sind fiktiv; unbekannte Produktversionen und ISO-Prüfsummen bleiben absichtlich offen. Die leere Vorlage bleibt separat erhalten.

Tabellenblatt Vorgesehene Parameter
Project Projekt-ID, Umgebung, Plattform, DNS, NTP, Standardwerte
Hosts Host-ID, Hersteller/Modell, Management-Adresse, Installationsversion, Installationsdatenträger, Zugangsdaten-Referenz
HostNetwork Host-ID, physische Schnittstellen, Bonds/Uplinks, VLANs, IP-Adressen, MTU
Clusters Cluster-ID, Plattform, Clustername, plattformspezifische Optionen
ClusterMembers Cluster-ID, Host-ID, Rolle
Storage Storage-ID, Typ, Zieladresse, Pfad beziehungsweise Datastore, Zuordnung
Networks Netzwerk-ID, VLAN-ID, Subnetz, Gateway, Verwendungszweck
VMs VM-ID, Plattform, Cluster/Host, Vorlage, CPU, RAM, Storage, Startreihenfolge
VMDisks VM-ID, Datenträger-ID, Größe, Storage-ID
VMNetworks VM-ID, Schnittstelle, Netzwerk-ID, IP-Konfiguration
Containers Container-ID, Laufzeit/Zielplattform, Image/Vorlage, Ressourcen, Storage, Netzwerk
Switches Switch-ID, Hersteller, Modell, Betriebssystemversion, Management-Adresse
SwitchPorts Switch-ID, Port, Modus, VLANs, Beschreibung, Port-Channel
Credentials Referenzname und externer Ablageort; keine Klartext-Passwörter

Die konkreten Spalten, Datentypen, Pflichtfelder und zulässigen Werte werden vor der Implementierung festgelegt. Plattformabhängige Felder werden nur für die jeweilige Plattform geprüft. Die Container-Bereitstellung wird erst nach Festlegung der gewünschten Technologie spezifiziert.

Umsetzung in Etappen

  1. GETAC-Modell, Windows-Server-Version, erste Zielplattform und einen Testserver festlegen.
  2. Einfaches Workbook für Staging und Server erstellen; Zuordnung über PXE-MAC-Adressen vorsehen.
  3. DHCP, PXE und lokale Installationsdateien auf der Staging-Station für ein separates Installationsnetz einrichten.
  4. Einen freigegebenen Testserver ohne Hersteller-Fernverwaltung installieren und das Ergebnis prüfen.
  5. Zweite Hypervisor-Plattform, Cluster-Konfiguration und VM-Bereitstellung ergänzen.
  6. 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.