feat(stagging): rename hypervisor sheet and add VM specifications

This commit is contained in:
Madzone
2026-09-09 11:18:49 +02:00
parent c0aaea51d0
commit 0206070493
9 changed files with 412 additions and 128 deletions
+3 -3
View File
@@ -7,15 +7,15 @@
- Proxmox VE: `answer.toml`
- VMware ESXi: `ks.cfg`
System und Version kommen aus dem Blatt **Server**. Die Windows-Server-Version, ISO-Namen und ISO-Ablage kommen aus **Staging**. Der Generator installiert selbst noch keine Server. Für Netzwerk und DHCP zuerst [Schritt 01](WINDOWS-SETUP.md), danach [Schritt 02: DNS und Reservierungen](DNS-RESERVIERUNGEN.md). PXE- und Webdienst sind noch nicht implementiert.
System und Version kommen aus dem Blatt **Virtualisierer**. Die Windows-Server-Version, ISO-Namen und ISO-Ablage kommen aus **Staging**. Der Generator installiert selbst noch keine Server. Für Netzwerk und DHCP zuerst [Schritt 01](WINDOWS-SETUP.md), danach [Schritt 02: DNS und Reservierungen](DNS-RESERVIERUNGEN.md). PXE- und Webdienst sind noch nicht implementiert.
## 1. Excel ausfüllen
Verwende `outputs/01a07d3f/ConfigWorkbook_KIS.xlsx`.
Im Blatt **Staging** Windows-Version per Dropdown wählen und die Netzwerkwerte ergänzen. `Medienordner` bleibt der lokale Arbeitsordner. Für Schritt 03 die Felder `ISO-Name Proxmox` bzw. `ISO-Name ESXi` sowie `ISO-Ablage` ausfüllen. Im Blatt **Server** die vorgesehenen Geräte auf `Installieren = JA` setzen und ihre Angaben vervollständigen. Excel speichern, bevor du das Programm startest.
Im Blatt **Staging** Windows-Version per Dropdown wählen und die Netzwerkwerte ergänzen. `Medienordner` bleibt der lokale Arbeitsordner. Für Schritt 03 die Felder `ISO-Name Proxmox` bzw. `ISO-Name ESXi` sowie `ISO-Ablage` ausfüllen. Im Blatt **Virtualisierer** die vorgesehenen Geräte auf `Installieren = JA` setzen und ihre Angaben vervollständigen. Excel speichern, bevor du das Programm startest.
**Version auswählen:** Im Blatt Server zuerst `System`, dann `Version` wählen. Das Versions-Dropdown zeigt die passende Plattformliste. Bei einem Systemwechsel die Version neu wählen. Die editierbaren Startlisten stehen im Blatt Staging in A37:C44. Eine genaue zusätzliche Medienversion dort ergänzen und danach im Dropdown auswählen; eine Erweiterung der Liste erweitert nicht automatisch die Generatorprofile.
**Version auswählen:** Im Blatt Virtualisierer zuerst `System`, dann `Version` wählen. Das Versions-Dropdown zeigt die passende Plattformliste. Bei einem Systemwechsel die Version neu wählen. Die editierbaren Startlisten stehen im Blatt Staging in A37:C44. Eine genaue zusätzliche Medienversion dort ergänzen und danach im Dropdown auswählen; eine Erweiterung der Liste erweitert nicht automatisch die Generatorprofile.
**ISO-Name und Ablage getrennt eintragen:**
+10 -1
View File
@@ -1,6 +1,6 @@
# Ä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`).
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.5 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.
@@ -8,6 +8,15 @@ Neue Änderungen werden unter `Unveröffentlicht` gesammelt. Bei einem neuen Ver
Noch keine weiteren Änderungen.
## 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.
+1 -1
View File
@@ -13,7 +13,7 @@ Im KIS-Workbook im Blatt **Staging** stehen unten zwei neue gelbe Eingabefelder:
Damit wird `getac.lab.example` für die GETAC-IP angelegt. Der GETAC-Name ist ein DNS-Eintrag; Windows wird nicht umbenannt. Windows-Version und Netzwerkwerte bleiben in ihren bisherigen Excel-Feldern.
Im Blatt **Server** für jeden gewünschten Server `Installieren = JA` setzen und diese Netzwerkwerte eintragen:
Im Blatt **Virtualisierer** für jeden gewünschten Server `Installieren = JA` setzen und diese Netzwerkwerte eintragen:
| Feld | Beispiel für PVE |
| --- | --- |
+9 -6
View File
@@ -27,7 +27,7 @@ function Read-KisWorkbook([string]$Path) {
}) }
$sheets = @{}
foreach ($sheet in $book.SelectNodes('//*[local-name()="sheet"]')) {
if ($sheet.GetAttribute('name') -notin @('Staging','Server')) { continue }
if ($sheet.GetAttribute('name') -notin @('Staging','Server','Virtualisierer')) { continue }
$rid = $sheet.GetAttribute('id','http://schemas.openxmlformats.org/officeDocument/2006/relationships')
$rel = @($rels.SelectNodes('//*[local-name()="Relationship"]') | Where-Object { $_.GetAttribute('Id') -eq $rid })
if ($rel.Count -ne 1) { throw 'Ungueltige XLSX-Beziehung' }
@@ -47,9 +47,12 @@ function Read-KisWorkbook([string]$Path) {
$cells[$address] = [string]$value
if ($cell.SelectSingleNode('./*[local-name()="f"]')) { $formulas[$address] = $true }
}
$sheets[$sheet.GetAttribute('name')] = @{ Cells=$cells; Formulas=$formulas }
$sheetKey=$sheet.GetAttribute('name')
if ($sheetKey -eq 'Virtualisierer') { $sheetKey='Server' }
if ($sheets.ContainsKey($sheetKey)) { throw 'Workbook darf nicht gleichzeitig Server und Virtualisierer enthalten.' }
$sheets[$sheetKey] = @{ Cells=$cells; Formulas=$formulas }
}
if (-not $sheets.ContainsKey('Staging') -or -not $sheets.ContainsKey('Server')) { throw 'KIS-Workbook mit Staging und Server erforderlich.' }
if (-not $sheets.ContainsKey('Staging') -or -not $sheets.ContainsKey('Server')) { throw 'KIS-Workbook mit Staging und Virtualisierer erforderlich (altes Blatt Server wird ebenfalls gelesen).' }
$settings = @{}
foreach ($key in $sheets.Staging.Cells.Keys) {
if ($key -notmatch '^A(\d+)$') { continue }
@@ -65,7 +68,7 @@ function Read-KisWorkbook([string]$Path) {
$expected = @('Installieren','Servername','PXE-MAC-Adresse','System','Version','Installationsdatenträger','Ziel-IP','Präfix','Gateway','DNS-Server','Benutzername','Hinweis')
for ($i=0; $i -lt $expected.Count; $i++) {
$col = [string][char](65+$i)
if ($sheets.Server.Cells["${col}6"] -cne $expected[$i]) { throw "Server!${col}6: Erwartet '$($expected[$i])'. KIS Schema 0.2 erforderlich." }
if ($sheets.Server.Cells["${col}6"] -cne $expected[$i]) { throw "Virtualisierer!${col}6: Erwartet '$($expected[$i])'. KIS-Spaltenstruktur erforderlich." }
}
foreach ($key in $sheets.Server.Cells.Keys) {
if ($key -match '^A(\d+)$' -and [int]$Matches[1] -gt 26 -and $sheets.Server.Cells[$key] -eq 'JA') { throw 'Server ausserhalb der 20 vorbereiteten Zeilen. Bereich zuerst erweitern.' }
@@ -75,11 +78,11 @@ function Read-KisWorkbook([string]$Path) {
$values = @{}
for ($i=0; $i -lt $expected.Count; $i++) {
$cell = "$([char](65+$i))$r"
if ($sheets.Server.Formulas.ContainsKey($cell)) { throw "Server!${cell}: Eingabeformeln sind nicht erlaubt." }
if ($sheets.Server.Formulas.ContainsKey($cell)) { throw "Virtualisierer!${cell}: Eingabeformeln sind nicht erlaubt." }
$values[$expected[$i]] = ([string]$sheets.Server.Cells[$cell]).Trim()
}
if ($sheets.Server.Cells['N6'] -eq 'PXE-IP') {
if ($sheets.Server.Formulas.ContainsKey("N$r")) { throw "Server!N${r}: Eingabeformeln sind nicht erlaubt." }
if ($sheets.Server.Formulas.ContainsKey("N$r")) { throw "Virtualisierer!N${r}: Eingabeformeln sind nicht erlaubt." }
$values['PXE-IP']=([string]$sheets.Server.Cells["N$r"]).Trim()
}
if ($values.Installieren -notin @('','JA','NEIN')) { throw "Server Zeile ${r}: Installieren muss JA oder NEIN sein." }
+5 -4
View File
@@ -1,6 +1,6 @@
# Stagging
Projektversion: **0.4.1**. Änderungen und bekannte Grenzen stehen im [Änderungsverlauf](CHANGELOG.md). Die verbindliche Versionsnummer liegt in [VERSION](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.
Projektversion: **0.5.0**. Änderungen und bekannte Grenzen stehen im [Änderungsverlauf](CHANGELOG.md). Die verbindliche Versionsnummer liegt in [VERSION](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
@@ -67,12 +67,13 @@ Ob und in welcher Form ein Installer temporäre Antwortdateien mit Zugangsdaten
### Vereinfachung des Workbooks für die erste Etappe
Für die erste funktionierende Installation sollen zwei Eingabeblätter genügen:
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 |
| Server | Name, PXE-MAC-Adresse, Zielplattform und Version, Installationsdatenträger, spätere Management-IP und Präfix, Gateway, DNS, Benutzername |
| VM Setting | VM-Zuordnung, CPU/RAM, Systemdisk, Netzwerk und plattformspezifische Hardwareangaben |
| Virtualisierer | 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.
@@ -91,7 +92,7 @@ Vorhandene Infrastruktur muss vor Änderungen abgeglichen werden. Eine Neuinstal
## ConfigWorkbook
**Aktueller Einstieg:** Das [ConfigWorkbook KIS (Schema 0.4)](outputs/01a07d3f/ConfigWorkbook_KIS.xlsx) enthält ausschließlich `Staging` und `Server`. 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.
**Aktueller Einstieg:** Das [ConfigWorkbook KIS (Schema 0.5)](outputs/01a07d3f/ConfigWorkbook_KIS.xlsx) enthält `Staging`, `Virtualisierer` und `VM Setting`. Das neue Blatt `VM Setting` enthält 20 VM-Zeilen mit Beispielen für PVE und ESXi. Die [VM-Anleitung](VM-SETTING.md) 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](https://www.proxmox.com/en/downloads/proxmox-virtual-environment/iso), geprüft am 09.09.2026. Weitere passende Medienversionen können in der Liste ergänzt werden.
+1 -1
View File
@@ -1 +1 @@
0.4.1
0.5.0
+32
View File
@@ -0,0 +1,32 @@
# VM Setting ausfüllen
Das KIS-Workbook enthält jetzt drei Blätter: `Staging`, `Virtualisierer` (bisher `Server`) und `VM Setting`. In `Virtualisierer` stehen die physischen Hypervisor-Hosts. In `VM Setting` steht eine Zeile je geplanter virtueller Maschine; 20 Zeilen und zwei deaktivierte Beispiele sind vorbereitet.
1. **VM-Name** eintragen und **Virtualisierer** aus dem Dropdown wählen. Das Feld **System** übernimmt PVE oder ESXi aus dem Host-Blatt. Der Host darf bereits installiert sein und dort `Installieren = NEIN` haben.
2. **Gast-OS / Version** beschreiben und die plattformspezifische **Gast-OS-ID** eintragen. Die Beispiele verwenden `l26` für PVE und `ubuntu64Guest` für ESXi. Die ID und Treiber müssen zum tatsächlichen Gast und Hypervisor passen.
3. **CPU-Sockel**, **Kerne / Sockel**, **RAM (GiB)** und **Disk (GiB)** festlegen. `vCPUs` wird als Sockel × Kerne berechnet, beispielsweise 1 × 4 = 4 vCPUs.
4. **Storage / Datastore**, **Disk-Controller**, **Netzwerk**, **NIC-Modell**, **Firmware** und **ISO / Startmedium** eintragen.
5. Die zur Plattform passenden Zusatzfelder ausfüllen. `Anlegen` und `Starten` zunächst auf `NEIN` belassen, bis die Spezifikation geprüft ist.
| Einstellung | PVE | ESXi |
| --- | --- | --- |
| Ablage der VM-Disk | Storage-ID, z.B. `local-lvm` | Datastore, z.B. `datastore1` |
| Disk-Controller | z.B. VirtIO SCSI | z.B. VMware Paravirtual oder LSI Logic SAS |
| Netzwerk | Bridge, z.B. `vmbr0` | Standard-/Distributed-Portgruppe |
| VLAN | optionaler Tag auf VLAN-fähiger Bridge | in der Portgruppe konfigurieren; VM-Feld leer lassen |
| Netzwerkkarte | z.B. VirtIO | z.B. VMXNET3 |
| VM-ID | im PVE-Cluster eindeutige Nummer | leer lassen |
| CPU-Typ | zur Hardware/Migration passend | PVE-Feld leer lassen |
| Diskformat | vom gewählten Storage abhängig | Thin, Thick oder EagerZeroedThick |
| VM-Ordner | leer lassen | optionaler Inventarordner bei vCenter |
| ISO-Referenz | `local:iso/datei.iso` | `[datastore1] ISO/datei.iso` |
Die ISO-Referenz bezeichnet ein Startmedium auf dem Virtualisierer. Eine Datei auf der GETAC-Freigabe ist dort nicht automatisch verfügbar; Übertragung und Einbindung sind später gesondert umzusetzen. Hardwaremodelle und Gast-OS-IDs sind keine beliebig austauschbaren Bezeichnungen.
Gelbe Zellen sind Eingaben, blaue Zellen werden berechnet. Die Spalte `Eingaben` weist auf fehlende Pflichtangaben, doppelte VM-Namen und unpassende Zusatzfelder hin. „Erfasst – technisch prüfen“ bestätigt nur die Erfassung. Die numerischen Eingabegrenzen sind keine zugesicherten Plattform- oder Hardwarelimits.
Dieser Stand plant eine Systemdisk und eine Netzwerkkarte je VM. Zusätzliche Disks/NICs, Gast-IP-Konfiguration, Templates, OS-Installation, Secure Boot und vTPM sind noch nicht enthalten. Insbesondere eine Windows-11-VM benötigt weitere Prüfung dieser Funktionen. Keine Zugangsdaten in die Tabelle schreiben.
**Die Skripte 01–03 bleiben für die Vorbereitung der Virtualisierer zuständig. Sie erstellen noch keine VMs und führen die Planungsschalter im neuen Blatt nicht aus.**
Feldgrundlagen: [Proxmox-Administrationshandbuch](https://pve.proxmox.com/pve-docs/pve-admin-guide.pdf) und [Broadcom New-VM](https://developer.broadcom.com/powercli/latest/vmware.vimautomation.core/commands/new-vm/). Reale Deployment- und Kompatibilitätstests sind noch erforderlich.
Binary file not shown.
File diff suppressed because one or more lines are too long