1. Überblick

Diese Anleitung führt Sie durch die End-to-End-Prozess der Standardisierung von On-Premises-Betriebssystem-Images mit XOAP. Das Ziel ist es, Ihnen beim Aufbau zu helfen wiederholbare, konforme und anbieterunabhängige Basis-Images das konsistent über On-Premises-Bereitstellungen auf VMware vSphere, Nutanix oder XenServer hinweg verwendet werden kann. 

Was sind standardisierte On-Premises-Betriebssystem-Images? 

Standardisierte Cloud-Betriebssystem-Images sind zentral definierte, versionierte und automatisierte Betriebssystemabbilder, die: 

• Eine gemeinsame Basis befolgen (Sicherheit, Härtung, Werkzeuge) 
• werden auf reproduzierbare Weise erstellt 
• Kann in mehreren Umgebungen und von mehreren Anbietern wiederverwendet werden 
• Als Grundlage für höherstufige Automatisierung (Plattformverwaltung) dienen 

XOAP fungiert als Steuerungsebene die festlegt, wie ein Image aussehen und wie es aufgebaut sein soll, während die eigentliche Ausführung des Builds innerhalb der Zielumgebung stattfindet. 

Was ist der Unterschied zwischen Bildern, die in der Cloud und On-Premises erstellt werden

Das Erstellen von Bildern in der Cloud und On-Premises verfolgt dasselbe übergeordnete Ziel – die Erstellung eines wiederverwendbaren, standardisierten Maschinenbilds –, unterscheidet sich jedoch erheblich in den Implementierungsdetails.   

In On-Premises-Umgebungen verlassen sich Image-Erstellungen typischerweise auf vollständige Betriebssystem-Installer und erfordern einen expliziten autounattend.xml für Windows, um Einrichtungsschritte wie Festplattenpartitionierung, Gebietsschema, Benutzer und anfängliche Konfiguration zu automatisieren; zusätzliche Skripte werden benötigt, um zu konfigurieren WinRM, öffnen oder anpassen Windows-Firewall, und installieren Sie das passende Hypervisor-Tools (zum Beispiel VMware Tools oder XenServer Guest Tools) zur Gewährleistung von Verwaltbarkeit und Leistung.  

In Cloud-Umgebungen werden viele dieser Schritte durch Metadatendienste und vorkonfigurierte Basisimages teilweise von der Plattform abstrahiert, aber Anpassungsskripte sind immer noch erforderlich, um den Unternehmensstandards zu entsprechen.

Für Linux, erfordern sowohl Cloud- als auch On-Premises-Image-Builds unbeaufsichtigte Installationsmechanismen (z. B Anschieben, Preseed, oder Cloud-Init) zusammen mit Post-Installations-Skripten zur Konfiguration des SSH-Zugangs, von Firewall-Regeln, Netzwerkeinstellungen, Zeitsynchronisation und zur Installation der relevanten Hypervisor- oder Cloud-Agent-Pakete, um sicherzustellen, dass sich das Image nahtlos in die Zielplattform integriert. 

Architekturübersicht – Funktionsweise 

Auf hoher Ebene sieht der Prozess wie folgt aus: 

1. XOAP definiert Betriebssysteme, Builder und Image-Definitionen 
2. On-Premises Verbinder führt Builds lokal aus 
3. Bilder werden mit nativer Anbieter-Tooling erstellt 
4. Ergebnisse werden verfolgt, versioniert und wiederverwendet 

Schlüsseldesignprinzipien: 

• Kein öffentlicher eingehender Zugriff erforderlich für XOAP 
• Am wenigsten‑privilegierter Zugriff mit autochthonen Identitätskonzepten 
• Trennung von Steuerungs- und Ausführungs-Ebene 

Kurzer Überblick über den End-to-End-Fluss 

• Bereiten Sie die Voraussetzungen vor 
• Einen Connector bereitstellen 
• Lokale Verbindung hinzufügen 
• Betriebssysteme hinzufügen und verwalten 
• Builder konfigurieren 
• Bilddefinitionen erstellen 
• Image-Builds ausführen 
• Die erstellten Bilder validieren 
• Fehlerbehebung, falls erforderlich 
• Nächste Schritte und Erweiterungen 

2. Voraussetzungen

Stellen Sie vor Beginn sicher, dass die folgenden Voraussetzungen erfüllt sind: 

Allgemein

• Ein aktiver XOAP Workspace 
• Zugriff auf mindestens eine unterstützte On-Premises-Virtualisierungsplattform 
• Berechtigungen zum Erstellen von Bildern und Identitäten in der Zielumgebung (lösungsspezifisch) 
• Auf einer Linux- oder Windows-VM, um den XOAP Connector, der als Proxy fungiert, zu installieren 
• Wenn ein Proxy für die Internetverbindung verwendet wird, werden Proxy-Anmeldeinformationen für den Connector benötigt. 
• Der Connector hat Zugriff auf die erstellten Images mit den erforderlichen Ports (WinRM 8595, 8596). 
• Ein ISO auf dem Datenspeicher der gewünschten Plattform 
• Der SHA256-Hash der ISO 

Cloudspezifisch 

vSphere  

Erforderliche Berechtigungen auf vCenter-Ebene (Mindestsatz):

    • Datenspeicher
    • Speicherplatz zuweisen
    • Datenspeicher durchsuchen
    • Dateivorgänge auf niedriger Ebene
    • Netzwerk
    • Netzwerk zuweisen
    • Ressource
    • Virtuelle Maschine einem Ressourcenpool zuweisen
    • Virtuelle Maschine → Inventar
    • Neu erstellen
    • Registrieren
    • Entfernen
    • Virtuelle Maschine → Konfiguration
    • Neue Festplatte hinzufügen
    • Gerät hinzufügen oder entfernen
    • CPU-Anzahl ändern
    • Arbeitsspeicher ändern
    • Einstellungen
    • Virtuelle Maschine → Interaktion
    • Einschalten
    • Ausschalten
    • Zurücksetzen
    • Virtuelle Maschine → Bereitstellung
    • Festplattenzugriff zulassen
    • Festplattenzugriff nur lesen zulassen
    • vApp
    • Importieren

Best Practices:
    • Erstellen Sie eine dedizierte vCenter-Rolle für Packer/XOAP
    • Weisen Sie die Rolle auf Datacenter- oder Ordner-Ebene zu
    • Verwenden Sie ein Dienstkonto, keinen persönlichen Benutzer 

Nutanix 

Erforderliche Rollen / Berechtigungen:
    • Möglichkeit zum Erstellen, Aktualisieren und Löschen von VMs
    • Berechtigungen für Bild-Upload und -Verwaltung
    • Berechtigungen für die Netzwerkauswahl
    • Berechtigungen zum Anhängen/Trennen von Datenträgern

Empfohlene integrierte Rollen:
    • Infrastruktur-Administrator (umfassend, am einfachsten)
    • Oder eine benutzerdefinierte Rolle mit:
    • VM erstellen / löschen
    • Bild erstellen / aktualisieren
    • Netzwerk anzeigen / zuordnen

Bewährte Verfahren:
    • Verwenden Sie ein Dienstkonto in Prism Central
    • Beschränken Sie die Berechtigungen, wenn möglich, auf ein bestimmtes Projekt

XenServer

Erforderliche Berechtigungen:
    • Pool‑Administrator oder eine gleichwertige benutzerdefinierte Rolle mit:
    • VM erstellen / zerstören
    • Datenträger anhängen / abtrennen
    • Energieoperationen
    • ISO SR‑Zugriff

Schlüsselanforderungen:
    • Zugriff auf ein ISO SR mit den Installationsmedien
    • Berechtigung zum Erstellen von Vorlagen oder Basis‑VMs

Bewährte Verfahren:
    • Verwenden Sie einen dedizierten Automatisierungsbenutzer
    • Vermeiden Sie die Verwendung des integrierten Root-Kontos 

2.1 XOAP Connector installieren 

Für On-Premises-Szenarien verwendet XOAP einen Verbinder das in der Zielumgebung läuft. 

Wichtige Anforderungen für die Funktion des Connectors mit unserem Backend: 

• Nur ausgehende Kommunikation zu XOAP (api.xoap.io) über 443 
• Keine eingehenden Firewall-Regeln erforderlich 
• Für Windows-Systeme führen Sie PowerShell bitte als Administrator aus. 
• Für Linux-Systeme führen Sie bitte die Befehle mit sudo aus, um die richtigen Berechtigungen sicherzustellen. 

Der Connector kann auf Windows- und Linux-Geräten installiert werden. Der Vorgang kann gestartet werden, indem Sie im Inventurbereich Ihres XOAP-Arbeitsbereichs auf die Schaltfläche “+ Gerät hinzufügen” klicken. 

1. Laden Sie das richtige Installationsprogramm auf das Gerät herunter, das Netzwerkzugriff auf Ihr vCenter hat.  
2. Erstellen Sie einen neuen API-Schlüssel, indem Sie auf + API-Schlüssel erstellen (oder bestehenden auswählen) klicken. Wählen Sie unter API-Token-Typ XOAP Connector aus. 
3. Navigieren Sie auf dem Gerät zu dem Speicherort, an dem das Installationsprogramm heruntergeladen wurde, und führen Sie den Befehl mit dem zusätzlichen Flag –imageManagement aus.  

Beispiel: .\XOAP.Connector.Installer.exe –install –apiKey BITTE_API_SCHLÜSSEL_AUSWÄHLEN –workspace IHRE_WORKSPACE_ID –imageManagement

2.2 Registrierung überprüfen 

Bitte beachte, dass du durch das Befolgen dieser Schritte kurzzeitig aus dem Modul "Erste Schritte" navigierst. Du kannst jedoch jederzeit zurückkehren, um dort weiterzumachen, wo du aufgehört hast.

Nach der Installation des XOAP Connectors müssen Sie überprüfen, ob die Kommunikation mit der XOAP-Plattform erfolgreich ist.

Schritte zur Überprüfung: 

1. Erweitern Sie im linken Navigationsmenü Bestandsaufnahme Modul und klicken Sie auf Geräte. 
2. Finden Sie den Rechner, auf dem Sie den Connector installiert haben, indem Sie nach seinem Hostnamen in der Gerätename Spalte. 
3. Überprüfe das Ist online Spalte neben Ihrem Gerät. Der Status sollte angezeigt werden als Verbunden, was die erfolgreiche Installation und Kommunikation des Connectors mit der Plattform bestätigt. (Hinweis: Wenn “Getrennt” angezeigt wird, stellen Sie sicher, dass das Gerät eingeschaltet ist, über Internetzugang verfügt und der XOAP-Dienst ausgeführt wird). 

3. Eine Verbindung hinzufügen 

XOAP Verbindungen Speichern Sie die Anmeldeinformationen und Endpunkte, die XOAP zur Integration mit externen Systemen (z. B. Cloud-Anbietern und lokalen Virtualisierungsplattformen) benötigt. Diese Verbindungen werden dann von anderen XOAP-Funktionen verwendet. 

Cloud-spezifische Verbindung hinzufügen 

Nutanix

Felder, die Sie bereitstellen:

  •   Verbindungsname– Freundlicher Name, der in XOAP verwendet wird, um diese Verbindung zu referenzieren. •   Verbinder - Das Gerät, auf dem der XOAP Connector installiert ist und das als Brücke zwischen der XOAP        Plattform und Ihrer Umgebung fungiert.
  •   Nutanix-Benutzername– Das Konto, das XOAP zur Authentifizierung bei Nutanix verwendet (typischerweise Prism). •   Nutanix Passwort - Das Passwort für das Nutanix-Konto.   Endpunkt– Der Prism-Endpunkt (Hostname/IP + Port, falls zutreffend), mit dem sich XOAP verbindet.   Clustername - Der Nutanix Cluster-Identifikator/Name in Prism, in dem Vorgänge ausgeführt werden.   Unsicher (Umschalten)– Ermöglicht die Verbindung ohne strenge TLS-Validierung (nur in Labor-/PoC-Szenarien verwenden, wenn erforderlich).   Beschreibung (optional) - Freitext-Notiz zur Dokumentation von Zweck/Besitzer der Verbindung.
  •   Schlagwörter (optional)- Labels zum Auffinden, Filtern und Verwalten von Verbindungen (maximal 5 pro Objekt).  

vCenter

Felder, die Sie bereitstellen:

  •   Verbindungsname– Freundlicher Name, der in XOAP verwendet wird, um diese Verbindung zu referenzieren. •   Verbinder - Das Gerät, auf dem der XOAP Connector installiert ist und das als Brücke zwischen der XOAP-Plattform und Ihrer Umgebung fungiert.
  •   vCenter Server– Der Hostname oder die IP-Adresse des vCenter, mit dem sich XOAP verbinden wird. •   Benutzername - Der vCenter-Benutzer (oder die SSO-Identität), der für die Authentifizierung verwendet wird. •   Passwort– Das Passwort für den angegebenen vCenter-Benutzer.
  •   Rechenzentrum - Der vSphereRechenzentrumInventarobjekt, das die Cluster/Hosts/Datenspeicher enthält, die Sie anvisieren möchten.   Cluster – Der vSphere-Cluster unter dem ausgewählten Rechenzentrum, der Hosts gruppiert und ein gemeinsames Ressourcenmanagement (DRS/HA bei Aktivierung) bietet.
  •   Gastgeber– Ein bestimmter ESXi-Host, der als Ziel ausgewählt werden soll (oft nützlich, wenn ein exakter Host ausgewählt wird, anstatt die Planung über Cluster/Regeln vorzunehmen).   Ressourcenpool- Der Ressourcenpool innerhalb des Clusters/Hosts, der CPU-/RAM-Anteile/Limits/Reservierungen für bereitgestellte VMs definiert.   Datenspeicher - Der Speicherort, an dem VM-Dateien (VMDKs/Konfiguration) abgelegt werden.
  •   Ordner - Der vCenter-VM-Ordner, der zum Organisieren bestimmt, wo das VM-Objekt in der Inventarliste erscheint.   Unsicher (Umschalten)- Ermöglicht die Verbindung ohne strenge TLS-Validierung (nur verwenden, wenn in Labor-/PoC-Szenarien erforderlich).
  •   Beschreibung (optional) - Freitext-Notiz zur Dokumentation von Zweck/Besitzer der Verbindung.
  •   Schlagwörter (optional)- Labels zum Auffinden, Filtern und Verwalten von Verbindungen (maximal 5 pro Objekt).  

Wichtiges Verhalten: 

• Groß-/Kleinschreibung berücksichtigende Felder: Namen von vCenter-Inventurobjekten (Datacenter/Cluster/Host/Resource pool/Datastore/Folder) sind im Hinblick auf die Groß- und Kleinschreibung empfindlich. Geben Sie sie exakt so ein, wie sie in vCenter definiert sind. 

XenServer

Wir bereiten das für Sie vor

4. Betriebssysteme hinzufügen 

In XOAP stellt das Betriebssystem das Basisabbild dar, das als Grundlage für Ihr benutzerdefiniertes virtuelles Maschinenabbild verwendet wird.  
Betriebssysteme für lokale Umgebungen sind für alle Arten von lokalen Hypervisoren generisch. 

Beispiele: 

• Windows 11 Enterprise 
• Windows Server 2025 
• Ubuntu LTS 
• RHEL 

Sie können ein neues Betriebssystem hinzufügen, indem Sie in der oberen rechten Ecke auf “+ Basisimage hinzufügen” klicken. 

Beim Hinzufügen eines On-Premises-Betriebssystems in XOAP definieren Sie: 

• Name– Name Ihres Betriebssystems. Sie können den Namen nach Ihrer eigenen Namenskonvention festlegen 
• ISO-Dateiname– geben Sie den Namen Ihrer ISO-Datei an, die als Basisbetriebssystem für Ihre Image-Definition verwendet wird. Beispiel: SERVER_EVAL_x64FRE_de-de.iso 
• ISO-Pfad– vollständiger Speicherort für Ihre ISO-Datei Beispiel: [datastore01] ISO/ 
• ISO-Prüfsumme– Prüfsumme Ihrer ISO als zusätzliche Sicherheitsfunktion 

Betriebssystemspezifisch

Für Windows 

  -   Autounattend– Datei, die zum Ändern von Windows-Einstellungen während des Setups verwendet wird. Diese Datei muss in den XOAP-Ressourcenbereich hochgeladen werden. Sie können eine der vorab hochgeladenen autoanattend.xml-Dateien auswählen, wenn diese für Sie passen.   Einrichtungsdateien - definiert, welche zusätzlichen Dateien XOAP während der Installation des Betriebssystems in die virtuelle Maschine einbindet.

Für Linux 

Wir bereiten das für Sie vor

Das ist wichtig: 

• Verwenden Sie Get-FileHash in PowerShell, um die Prüfsumme für die ISO-Datei zu generieren: Get-FileHash -Path “\fileserver\isos\Windows11_24H2.iso”-Algorithmus SHA256. Kopieren Sie den zurückgegebenen Hash-Wert in das Feld ISO-Prüfsumme in XOAP. 
• Setup-Dateien werden typischerweise von unattend.xml verwendet, um Treiber, Tools zu installieren oder benutzerdefinierte PowerShell-Skripte während oder unmittelbar nach dem ersten Start auszuführen. Für diesen Anwendungsfall stellen wir einige Vorlagendateien zur Verfügung, wie z. B.:
  • windows-init.ps1 – Aktiviert die Windows-Remoteverwaltung in Windows-Builds. Dies ist erforderlich, um die Erstellung einer Vorlagen-VM in vCenter erfolgreich abzuschließen. 

5. Builder-Konfiguration hinzufügen 

Die Builder-Konfiguration definiert Wo und wie Es wird ein Image erstellt, das auf der ausgewählten Plattform oder dem ausgewählten Cloud-Anbieter basiert (z. B. AWS, Azure, Google Cloud oder VMware). Bei der Konfiguration des Builders wählen Sie außerdem die Verbindung für Ihre Cloud- oder On-Premises-Umgebung. 

Eine Builder-Konfiguration beinhaltet typischerweise: 

• Zielplattform (Nutanix, vSphere oder XenServer.) 
• CPU- und RAM-Konfiguration 
• Netzwerk- und Speicher­konfiguration 
• Temporäre Bauressourcen 

Entwickler abstrahieren Anbieterunterschiede und halten Builds transparent und überprüfbar. 

Um einen neuen Builder zu erstellen, klicken Sie auf “+ Builder Configuration” und wählen Sie den gewünschten Hypervisor aus.

Builder-Konfiguration Cloud-spezifisch hinzufügen

Nutanix

Allgemeine Einzelheiten:
  •   Name– Freundlicher Name, der in XOAP zur Referenzierung dieser Builder-Konfiguration verwendet wird.   Typ auswählen - Die Zielplattform für den Builder (in diesem Kontext auf Nutanix gesetzt).   Betriebssystemtyp– Der Betriebssystemtyp der zu erstellenden virtuellen Maschine.   Verbindung - Die vorkonfigurierte Nutanix-Verbindung, die XOAP verwendet, um sich mit Ihrem Nutanix-Cluster zu authentifizieren und mit ihm zu interagieren.   SubnetznameDer Name des Nutanix-Netzwerks/Subnetzes, mit dem die virtuelle Maschine während des Erstellungsprozesses verbunden wird.   Beschreibung (optional) - Freitextnotiz zur Dokumentation des Zwecks, des Eigentümers oder spezifischer Details dieser Builder-Konfiguration.   Schlagwörter (optional) - Labels zur besseren Auffindung, Filterung und Verwaltung von Builder-Konfigurationen.   

Umgebungskonfiguration:   CPU – Die Anzahl der virtuellen CPUs, die der virtuellen Maschine während des Builds zugewiesen wurden.
•   Speicher GB - Der für die virtuelle Maschine zugewiesene Arbeitsspeicher, angegeben in Gigabyte. •   CD-Dateien– Eine Liste von Dateien, die hochgeladen und als CD-ROM an die virtuelle Maschine angehängt werden sollen. Sie können mehrere Dateien durch Drücken der Eingabetaste oder durch Kommas trennen.   Boot-Typ - Die Firmware-Boot-Konfiguration, die für die virtuelle Maschine verwendet wird (z. B. Legacy oder UEFI).
  •   Boot-Priorität– Die Startreihenfolge/Priorität des Bootgeräts (z. B. das Festlegen, dass zuerst von der CD-ROM und dann von der Festplatte gestartet wird).   Festplattengröße (GB) - Die Gesamtkapazität der zu erstellenden primären virtuellen Festplatte, angegeben in Gigabyte.
  •   GPU- Optionale GPU-Konfiguration zum Anhängen einer virtuellen Grafikprozessor-Einheit (vGPU) an die VM während der Erstellung. 

Ausgabe-Konfiguration / Alle Betriebssysteme

  •   Bild exportieren (umschalten) – Wenn aktiviert, exportiert die resultierende erstellte virtuelle Maschine in ein endgültiges Nutanix-Image.   Sysprep am Ende deaktivieren (Umschalten) Wenn aktiviert, wird der Standardprozess der Systemvorbereitung (Sysprep) am Ende eines Windows-Builds übersprungen. Verwenden Sie dies nur, wenn Sie die Verallgemeinerung über benutzerdefinierte Skripte handhaben. •   Herunterfahrenbefehl – Der spezifische Befehl, der verwendet wird, um das Gastbetriebssystem nach Abschluss der Bereitstellung ordnungsgemäß herunterzufahren.   Herunterfahr-Zeitüberschreitung  - Die maximale Wartezeit, bis die virtuelle Maschine heruntergefahren ist, bevor ein erzwungenes Ausschalten oder ein Fehlschlag des Builds erfolgt.   

vSphere

Felder, die Sie bereitstellen:

Allgemeine Details

  •   Name – Ein für XOAP verwendeter Anzeigename, der diese Builder-Konfiguration referenziert.   Typ auswählen Die Zielplattform für den Builder (in diesem Kontext auf vSphere gesetzt).   Verbindung – Die vorkonfigurierte vSphere-Verbindung, die XOAP zur Authentifizierung und Interaktion mit Ihrer vCenter/ESXi-Umgebung verwendet.   Festplattengröße (GB) - Die Gesamtkapazität der zu erstellenden primären virtuellen Festplatte in Gigabyte.   HW-Version – Die VMware-Hardwareversion für die virtuelle Maschine (z. B. 19, 20). •   Gastbetriebssystemtyp - Die interne VMware-ID für das Gastbetriebssystem (z. B. windows9Server64Guest, ubuntu64Guest). Dies stellt sicher, dass vSphere die richtigen Standardoptimierungen für das Betriebssystem anwendet.   Netzwerk – Das vSphere-Netzwerk oder die Portgruppe, mit der die virtuelle Maschine während des Erstellungsprozesses verbunden wird.
    •   Netzwerkkarte - Der Typ des virtuellen Netzwerkadapters, der an die VM angehängt werden soll (z. B. vmxnet3, e1000).
  •   Exportieren zur Zielbibliothek für Inhalte (Umschalter) – Wenn aktiviert, exportiert das resultierende erstellte Artefakt direkt in eine angegebene vSphere Content Library. •   In Vorlage umwandeln (Umschalter) Wenn aktiviert, wird die erstellte virtuelle Maschine nach Abschluss der Bereitstellung automatisch in eine VMware-Vorlage konvertiert.   Schlagwörter (optional) – Labels, die Ihnen helfen, Builder-Konfigurationen zu finden, zu filtern und zu verwalten. •   Beschreibung (optional) - Freitextnotiz zur Dokumentation des Zwecks, des Eigentümers oder spezifischer Details dieser Builder-Konfiguration.   Firmware - Der Firmwaretyp, der zum Starten der virtuellen Maschine verwendet wird (z. B. BIOS oder EFI).
  •   CPUs – Die Anzahl der virtuellen CPU-Kerne, die der virtuellen Maschine während des Build zugewiesen wurden. •   RAM (GB) - Die Menge an Arbeitsspeicher, die der virtuellen Maschine zugewiesen wird, angegeben in Gigabyte.
  •   CD-ROM-Typ – Der virtuelle Controller-Typ, der für das CD-ROM-Laufwerk verwendet wird (z. B. SATA, IDE).   Festplattencontroller-Typ Der Typ des Speichercontrollers, der für die virtuelle Festplatte verwendet werden soll (z. B. pvscsi, lsilogic, sata). •   Platte dünn bereitgestellt (umschalten) - Wenn aktiviert, wird die virtuelle Festplatte dünn bereitgestellt, d. h., sie belegt nur dann physischen Speicherplatz, wenn tatsächlich Daten darauf geschrieben werden.
  •   Speicher – Das Ziel-vSphere-Datenspeicher oder der Ziel-Datenspeichercluster, auf dem/dem die virtuellen Maschinen und die Festplattendateien gespeichert werden. 

Flag-Konfiguration:

  •   VBS aktiviert (Umschalten) – Ermöglicht Virtualization-Based Security (VBS) auf der virtuellen Maschine. Hinweis: Dies erfordert typischerweise EFI-Firmware, Secure Boot und spezifische Hardwareversionen.
•   VVTD aktiviert (Umschalten) - Aktiviert die VMware Virtual I/O Technology (Intel VT-d) auf der virtuellen Maschine, was den direkten Zugriff auf Hardwaregeräte ermöglicht.   

Inhaltsbibliothek-Konfiguration – (Diese Felder werden angezeigt, wenn "Export in Content Library-Ziel" aktiviert ist)   Bibliothek – Der Name der Ziel-vSphere Content Library, in der das fertige Image oder die Vorlage gespeichert wird.   Cluster - Der ESXi-Cluster, der mit dem Export der Inhaltsbibliothek verknüpft ist oder wo die temporäre Staging-Phase stattfindet.
  •   Ordner – Der vCenter-Ordner für virtuelle Maschinen, in dem die temporäre VM während des Erstellungs- und Exportvorgangs platziert wird.   Datenspeicher - Der spezifische vSphere-Datenspeicher, der für die vorläufige Speicherung der Exportdateien oder zur Sicherung des Content Library-Elements verwendet wird.
  •   Zerstören (umschalten) Wenn aktiviert, wird die ursprüngliche erstellte virtuelle Maschine nach dem erfolgreichen Export in die Content Library automatisch aus Ihrem vCenter-Inventar gelöscht.
    •   OVF (Umschalten) – Wenn aktiviert, wird das Artefakt als OVF-Paket (Open Virtualization Format) exportiert. Wenn deaktiviert, wird es typischerweise als OVA-Format (Einzeldatei) exportiert.
–   Import überspringen (Umschalter) Wenn aktiviert, wird der Build-Prozess ausgeführt, überspringt jedoch den letzten Schritt des eigentlichen Imports des Artefakts in die Inhaltsbibliothek. Dies wird hauptsächlich zum Testen oder Debuggen des Build-Prozesses verwendet, ohne das endgültige Image hochzuladen. 

XenServer

Wir bereiten das für Sie vor

6. Bilddefinition hinzufügen 

An Bilddefinition fügt alles zusammen. 

Es bezieht sich auf: 

• Plattform 
• Builder-Konfiguration 
• Betriebssystem 
• Bereitstellungsschritte (Skripte, Aktionen, Härtung), das nennen wir es Rolle des Versorgers. 

Sie müssen mindestens 2 Provisioner-Rollen in Ihrem Arbeitsbereich haben. Eine für Windows-Geräte und eine zweite für Linux.

Um eine neue Image-Definition zu erstellen und auszuführen, klicken Sie auf die Schaltfläche in der oberen rechten Ecke “+ Neue Image-Definition” und füllen Sie das nächste Formular aus:

• Legen Sie einen Namen und eine Beschreibung für die Bilddefinition fest 
• [optional] Tags zur Kategorisierung oder Filterung auswählen 
• Wählen Sie den Builder-Anbieter und die spezifische Builder-Konfiguration 
• [optional] Wählen Sie ein Basisbetriebssystemabbild 
• Verknüpfen Sie die entsprechende Provisioner-Rolle (die alle Skripte, Aufgaben und Konfigurationen enthält) 
• Definieren Sie ein XOAP-Connector-Gerät für lokale Image-Definitionen 
• [optional] Planen Sie die Ausführung von Image-Definitionen 

Sie können die Bilddefinition speichern und später ausführen von Bilddefinition Fläche unter Image Management Modul, oder klicken Speichern & Ausführen  während der Erstellung auszuführen. 

Jeder Durchlauf erzeugt ein neues, versioniertes Image-Artefakt. 

1. Einen Lauf manuell oder über einen Zeitplan auslösen 
2. XOAP übergibt die Ausführung an den Connector 
3. Fortschritt und Protokolle werden zentral verfolgt 

Jeder Durchlauf erzeugt ein neues, versioniertes Image-Artefakt. 

6.1 Überprüfen Sie das erstellte Image  

Nach erfolgreichem Build: 

• Bild validieren 
• Namen und Versionsmetadaten bestätigen 

XOAP führt Aufzeichnungen über: 

• Protokolle 
• Ergebnis-Bild-IDs 

Bilddefinition validieren

Nutanix

Um zu bestätigen, dass Ihr Image erfolgreich erstellt und in Ihrer Nutanix-Umgebung finalisiert wurde (insbesondere wenn Sie die Option "Image export" aktiviert haben), müssen Sie die Prism-Webkonsole überprüfen:

Überprüfung des Nutanix Image Service:

  • Melden Sie sich bei Ihrem an Nutanix Prism Konsole (Prism Element oder Prism Central, je nach Zielverbindung).
• Navigieren Sie zu Bilder Dashboard:
     In Prism Central: Navigieren Sie zum Hamburger-Menü > Compute & Speicher > Bilder. 
     In Prism Element: Klicken Sie auf das Zahnradsymbol (Einstellungen) und wählen Sie Bildkonfiguration, oder benutze das Hauptmenü, um zu Virtuelle Infrastruktur > Images. 
  • Suchen Sie in der Liste nach dem Namen, den Sie in Ihrer XOAP-Image-Definition angegeben haben.
• Vergewissern Sie sich, dass der Image-Status aktiv/aktiv ist und dass sein Typ dem entspricht, was Sie erwarten (z. B. Disk-Image), sodass es für die Bereitstellung neuer virtueller Maschinen bereit ist. 

vSphere

Nach einem erfolgreichen Build können Sie die Erstellung Ihres Images oder Templates direkt in Ihrer VMware vCenter-Umgebung überprüfen. Der Speicherort hängt von den spezifischen Einstellungen ab, die Sie in den vSphere Builder Konfiguration 

Wenn in eine Content Library exportiert: 

  • Melden Sie sich in Ihrem vSphere Client. 
  • Zum Hauptmenü navigieren und auswählen Inhaltsbibliotheken. 
  • Klicken Sie auf die spezifische Bibliothek, die Sie in Ihrer XOAP-Konfiguration ausgewählt haben.
• Blättern Sie OVF & OVA Vorlagen Tab, um Ihr neu exportiertes Bild zu finden. 

Wenn in eine Standard-vSphere-Vorlage konvertiert: 

  • Melden Sie sich in Ihrem vSphere Client. 
  •  Navigieren Sie zur VMs und Vorlagen Inventaransicht.
  • Erweitern Sie Ihren vCenter-Baum, um das spezifische Rechenzentrum und Ordner wo der Build stattgefunden hat.
  • Suchen Sie nach dem von Ihnen zugewiesenen Namen für das Image. Es sollte das Standard-vSphere-Vorlagen-Symbol haben (ein virtuelles Maschinen-Symbol mit einem kleinen Papiersymbol). 

XenServer

Wir bereiten das für Sie vor

Zusammenfassung 

Indem Sie diesem Fluss folgen, etablieren Sie eine saubere, auditisierbare und skalierbare Bild-Pipeline: 

• Eine Steuerebene (XOAP) 
• Mehrere Ausführungsumgebungen 
• Konsistente Betriebssystem-Baselining 
• Cloud- und On-Premise-Parität 

Dies bildet die Grundlage für unternehmensweite Automatisierung und Compliance-gesteuerte Infrastruktur. 

Fehlerbehebung 

Wenn ein Build fehlschlägt: 

• Überprüfen Sie die Build-Protokolle in XOAP 
• Konnektor-Integrität und Berechtigungen prüfen 
• Cloud-Kontingente und -Limits validieren 
• Netzwerkereichbarkeit innerhalb der Zielumgebung bestätigen 

Die meisten Probleme hängen zusammen mit: 

• Fehlende Berechtigungen 
• Netzwerk-Fehlkonfiguration oder Portbeschränkungen 
• Anbieterseitige Kontingentgrenzen 

Nächste Schritte

Sobald Ihr erstes standardisiertes Image funktioniert, gehören zu den typischen nächsten Schritten: 

Eigene Skripte, Anwendungen und Konfigurationen hinzufügen 

• Provisionierer mit benutzerdefinierten Skripten erweitern 
• Sicherheitsgrundlagen integrieren 
• Unternehmens-Tools installieren 

Prüfen Sie unsere GitHub-Repo hier.

Vorhandene Rollen in der Cloud wiederverwenden 

• Wenden Sie dieselben Bereitstellungsprofile auf Cloud-Images an 
• Konsistenz über hybride Umgebungen hinweg erzielen 

Höhere Automatisierung aufbauen 

• Anwendungspaket 
• Stacks und Rollen 
• Laufende Bildaktualisierungen 

The post Standardizing on premises OS images appeared first on XOAP.

Image Management

To get started with Image Management, there is only one prerequisite: a working connection to your environment. Configure your connection by navigating to Verbindungen, then clicking the Add new connection button in the upper-right corner.

In the slide-out panel, select the connection Type und Provider. Fill in the remaining required information and click Bestätigen Sie to save your connection.

If you need assistance with configuring your access credentials, please refer to the Connect your infrastructure documentation.

In the following sections, you will find more information about the required permissions for your infrastructure. Please note that these are the minimum permissions needed to create Bilddefinitionen.

If you plan to use the same connection for Geskriptete Aktionen, the required permissions may vary depending on the specific use case.

AWS

To create a customized image, a default VPC must be available in the AWS account you’re using.

Additionally, you need to assign appropriate IAM permissions to the user specified in the connection. At a minimum, the following permissions are required:

#Codeblock

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:AttachVolume",
        "ec2:AuthorizeSecurityGroupIngress",
        "ec2:CopyImage",
        "ec2:CreateImage",
        "ec2:CreateKeyPair",
        "ec2:CreateSecurityGroup",
        "ec2:CreateSnapshot",
        "ec2:CreateTags",
        "ec2:CreateVolume",
        "ec2:DeleteKeyPair",
        "ec2:DeleteSecurityGroup",
        "ec2:DeleteSnapshot",
        "ec2:DeleteVolume",
        "ec2:DeregisterImage",
        "ec2:DescribeImageAttribute",
        "ec2:DescribeImages",
        "ec2:DescribeInstances",
        "ec2:DescribeInstanceStatus",
        "ec2:DescribeRegions",
        "ec2:DescribeSecurityGroups",
        "ec2:DescribeSnapshots",
        "ec2:DescribeSubnets",
        "ec2:DescribeTags",
        "ec2:DescribeVolumes",
        "ec2:DetachVolume",
        "ec2:GetPasswordData",
        "ec2:ModifyImageAttribute",
        "ec2:ModifyInstanceAttribute",
        "ec2:ModifySnapshotAttribute",
        "ec2:RegisterImage",
        "ec2:RunInstances",
        "ec2:StopInstances",
        "ec2:TerminateInstances"
      ],
      "Resource": "*"
    }
  ]
}

#EndOfCodeblock

Read more about the required permissions hier.

Azurblau

To create images on Azure, ensure the following prerequisite is met: you must create a Dienstprinzipal with Contributor role access to your Azure subscription. Use the Azure CLI to generate the Service Principal.

Command format

#Codeblock
az ad sp create-for-rbac \
  --name [ServicePrincipalName] \
  --role Contributor \
  --scopes /subscriptions/[SubscriptionId] \
  --years 1
#EndOfCodeblock

Command example

#Codeblock

az ad sp create-for-rbac \
  --name xoap-image-principal \
  --role Contributor \
  --scopes /subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --years 1

#EndOfCodeblock

Command output

#Codeblock

{
  "appId": "[ClientId (Guid)]",
  "displayName": "xoap-image-principal",
  "name": "http://xoap-image-principal",
  "password": "[ClientSecret]",
  "tenant": "[TenantId (Guid)]"
}

#EndOfCodeblock

Using this output, you can now configure your connection in XOAP:

• Subscription ID: xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
• Tenant ID: [TenantId (GUID)]
• Client ID: [appId]
• Client Secret: [password]

Read more about the required permissions hier.

Google

The file you’re required to upload is a Google Cloud Service Account key file in JSON format. You can generate and herunterladen it like this:

1. Öffnen Google Cloud Console: https://console.cloud.google.com/iam-admin/serviceaccounts.
2. Select your project from the top-left dropdown.
3. Create or select a service account: If you don’t have one yet, click “Create Service Account” under “IAM&Admin” menu. Give it a name and optional description.
4. Assign the required roles (see below for full list).
5. After creating or selecting a service account:
   • Click the ⋮ (three dots) next to the service account name → Manage Keys
   • Under the “Keys” section, click Add Key → Create new key
   • Choose JSON, then click Erstellen
6. The file will download automatically – this is the file you need to upload into XOAP to authenticate with Google Cloud.

Required IAM Roles for Packer to build Images

To allow the service account to build custom images with Packer, you need to assign at least these roles:

Read more about the required permissions hier.

vSphere

To integrate XOAP with VMware vSphere for image builds, create a custom vSphere role that includes only the privileges required for XOAP to perform its operations. Assign this role to a dedicated service account to ensure XOAP has least-privilege access to the vSphere infrastructure.

Required privileges

Clone the default Read-Only vSphere role and add the following privileges:

Configuration Management

PowerShell

All nodes that will be used to author or receive configurations are running WMF version 5.1 or later. Authoring nodes that are used to write configurations locally need to have internet connectivity to download new DSC-related resources.

Remote management

WS-Management (WS-MAN) traffic is permitted on the network. It will be enabled by default on nodes that have PowerShell version 5 installed, but you must ensure it’s not being blocked by firewalls or other network elements. Read further for more information.

Communication with our backend

In order to communicate with our backend, the following ports need to be open: https://api.xoap.io on port 443.

Proxy configuration for nodes

To force PowerShell DSC nodes to use a proxy server to communicate with the cloud-hosted backend, some adjustments to the node configuration must be made before registering the node. DSC does not communicate in a user context and therefore uses the SYSTEM context.

For DSC to connect successfully and register the node, adjust the following lines inside the machine.config in your .NET installation directory.

You should find the file in these locations:

32-bit
**%windir%\Microsoft.NET\Framework\[version]\config\machine.config**
64-bit
**%windir%\Microsoft.NET\Framework64\[version]\config\machine.config**
[version] should be equal to v1.0.3705, v1.1.4322, v2.0.50727 or v4.0.30319. v3.0 and v3.5 just contain additional assemblies to v2.0.50727 so there should be no config\machine.config. v4.5.x and v4.6.x are stored inside v4.0.30319.
Then add the following lines:
<defaultProxy>  <proxy autoDetect="false" bypassonlocal="false" proxyaddress="http://127.0.0.1:8888" /> </defaultProxy></system.net>

Firewalls

SSL decryption can get you into trouble when clients inside your corporate network try to communicate with the cloud backend.

DEP

We’ve seen some Virus Scanners with DEP enabled to prevent users from logging into the cloud backend successfully.

TLS

Enable TLS 1.2 wherever possible. Not doing so will keep Configurations Management from working successfully.

Set it via PowerShell:

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWordSet-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWordSet-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v2.0.50727' -Name 'SchUseStrongCrypto' -Value '1' -Type DWord[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12

Application Management

To use Application Management you need to have network access to api.xoap.io over port 443 and custom packages must be provided as a ZIP archive prior to upload.

Within your XOAP workspace, you can already find a wide selection of:

• Anwendungen
• Anwendungsgruppen
• Anwendungsrollen

This means you’re ready to begin installing applications immediately.

Creating packages

XOAP’s Application Management supports PSADT packages in both v3 and v4 formats. Our current Package Wizard supports package creation in v3 format. If you plan to create your own application packages, we recommend installing it on your packaging machine. The easiest way to do this is directly from your XOAP Workspace.

1. Navigate to Application Management → Anwendungsrollen
2. Locate the Role: PSADT Packaging Baseline
3. Open the three-dot menu next to the role and choose Copy installation command
4. On the machine where you want to install the wizard, open PowerShell as Administrator. Paste and execute the copied command.

Alternatively, you can download the installation script or copy the installation command, copy it manually to the target system, and then run it through PowerShell as Administrator.

Once completed, the Package Wizard will be fully installed and configured. You can find the shortcut on your desktop.

Platform Management

There are no deployed agents required to use Platform Management — the logic runs directly on XOAP’s cloud runners or through your established infrastructure connections.

Within the Scripted Actions library, you can already find a selection of:

• Template scripts: pre-built scripts for common tasks (like AVD management or Azure automation)
• Resources: a library where your custom scripts are stored

This means you can start automating immediately using existing templates.

Supported formats

Platform Management supports standard PowerShell (.ps1), Azure CLI, Google CLI und AWS-CLI scripts. The only prerequisite for using your own automation is that the script file must be uploaded to the Ressourcen area or imported directly during action creation.

Establishing connections

To execute any script, the platform requires a valid Connection to your infrastructure. It is recommended setting up your Connections to cloud providers (Azure, AWS, Google) or on-premises systems (VMware, Nutanix) before creating complex workflows.

You can easily set this up from your XOAP workspace:

• Navigieren Sie zu Verbindungen (in the main menu)
• Klicken Sie auf + New connection
• Select your provider (Azure, AWS, Google, or other) and follow the authentication prompts

Anmerkung: The Scripted Action wizard also allows you to add a new connection during the Target selection step.

The post Prerequisites appeared first on XOAP.

Welcome to XOAP! This guide will help you set up your account, create your first Workspace and manage your subscription if you need more features.

Create a free account

• Geh zum registration page and fill in your details (no credit card required to start).
• Klicken Sie auf Konto erstellen.
• Check your email inbox and verify your email address to activate your free Workspace.

Please open the link in the same browser you used to create your account.

• You’ll briefly see a loading screen.
• Then, click Go to Workspace to access your new Workspace. Alternatively, click Back to Dashboard to manage other settings.

Subscribe for unlimited features (optional)

Want more features or extended capacity? Upgrade your plan anytime.

• If you’re currently in your Workspace, click Back to my.XOAP.io in the lower left corner. If not, proceed to the next step.
• From the Workspace Overview, click your Workspace name.
• Klicken Sie auf Upgrade Plan.
• Select the modules you need and adjust the number of units based on your usage.
• Klicken Sie auf Weiter to continue.
• Enter (or update) your payment method and billing details.
• Klicken Sie auf Weiter to continue.
• Review your plan and confirm by clicking Upgrade free plan Workspace.
• Your Workspace status will now show as Aktiv with upgraded access.

We offer tailored deals for MSPs, as well as public sector and education organizations. Contact us here for a custom quote.

The post Create an account appeared first on XOAP.

Need to work with others? You can easily invite teammates to your Workspace. If you’re running multiple projects or teams, you can also create extra Workspaces.

Invite users to your Workspace

• If you’re currently in your Workspace, click Back to my.XOAP.io in the lower left corner. If not, proceed to the next step.
• Click on the name of your Workspace.
• Geh zum Benutzer tab.
• Klicken Sie auf Add user.
• Assign the user to specific modules or to all modules. Optionally, you can grant admin rights.
• Klicken Sie auf Send invite.

New users will receive an email to register and join the Workspace.

Existing users will get a link to access the Workspace directly.

Add an additional Workspace

Need a separate space for another project or team? You can create extra Workspaces – just note this is a paid feature.

• If you’re currently in your Workspace, click Back to my.XOAP.io in the lower left corner. If not, proceed to the next step.
• On the Workspaces page, click Add Workspace.
• Give your new Workspace a name.
• Select the modules you want to include, then click Weiter.
• Enter your payment and billing information, then click Weiter.
• Review your setup and click Bestätigen Sie.
• Once created, you can access your new Workspace using its Workspace URL.

The post Invite team members appeared first on XOAP.

Connecting your cloud infrastructure is the first step to building automations in XOAP. This guide covers how to add a new connection to AWS, Azure or Google Cloud.

If you want to use XOAP only to deliver configurations or install applications on your systems, this step is not mandatory. You can manage your on-prem or cloud systems even without connecting XOAP to your cloud infrastructure.

How to add a Connection

• Geh zum Verbindungen.
• Klick auf den + Neue Verbindung button in the top-right corner.
• You can select from the following available connection types: AWS, Azure, Google Cloud (more details below).
• Select your chosen provider and configure other necessary settings accordingly.
• When you’re done, click Bestätigen Sie.

Supported cloud providers

AWS

You can choose from three connection types:

• AWS – Access Key
• AWS – Assume Role
• AWS – Assume Role (Cross-Account)

All AWS connection details are securely stored in a vault tied to your Workspace.

Learn more about setting up AWS – Access Key permissions:

• Managing access keys for IAM users
• Introduction to AWS IAM
• IAM tutorial: Delegate access across AWS accounts using IAM roles
• IAM identifiers and ARN format

Learn more about AWS – Assume Role permissions:

• STS API Reference: AssumeRole

Learn more about AWS – Assume Role (Cross-Account) with External ID:

• How to use External ID when granting access to your AWS resources (AWS Security Blog)
• IAM Trust Policies: Using conditions with sts: ExternalId

Microsoft Azure

XOAP supports connecting to Azure using Service Principals, providing secure access to your Azure subscriptions. To set this up, the following information is required: 

• Name: a custom name for the connection as it will appear in your application (e.g., XOAP-Azure-Prod).
• Kunden-ID: the Application (client) ID of your Azure AD application (also known as a Service Principal).
• Client-Geheimnis: the client secret you create under the “Certificates & secrets” section in the App Registration. Note that the value is shown only once at the time of creation.
• Abonnement-ID: a unique GUID representing the Azure subscription where your resources are located.
• Mieter-ID: the Directory (tenant) ID of your Azure Active Directory instance.

As with AWS, all Azure credentials are stored securely in your Workspace vault.

Für detailed guidance on configuring your XOAP connection and retrieving the necessary information, please refer to the following resources:

• Register an application in Microsoft Entra ID
• Register a Microsoft Entra app & create a client secret
• Subscription & Tenant ID

Google Cloud

To connect XOAP to Google Cloud, you need a Service Account with sufficient permissions and a downloaded JSON key file.

• Name: a custom name for identifying the connection (e.g., XOAP-GCP-Prod).
• Project ID: the unique identifier of your Google Cloud project.
• File: the Service Account JSON key file that contains authentication credentials.

Make sure the service account has the required roles (e.g., Viewer, Editor, or a custom role depending on your needs).

As with AWS and Azure, all Google credentials are stored securely in your Workspace vault.

Für more information on configuring your XOAP connection and retrieving the required details, please refer to the following links:

• Find your Project ID
• How to generate the Service Account JSON key file

The post Connect your infrastructure appeared first on XOAP.

Quickly learn how to connect your managed system to XOAP. It only takes a few clicks.

Locate the XOAP unassigned configuration group and from the action menu select Copy registration command oder Download registration script.

Anmerkung: Both do the same and can be integrated into any existing delivery process (GPO, deployment solution, image build and more).

To connect the system manually and test the connection, go to your target system, open PowerShell as Administrator, paste the command and run it.

Once completed, your machine will appear under the Knotenpunkte section. Click on Details to view system information.

Anmerkung: This action (XOAP_unassigned) does not change anything in your system, it only connects it to XOAP.

The post Connect your managed system appeared first on XOAP.