Kataloge mit vorbereiteten Images in AWS EC2 erstellen
Erstellen Sie vorbereitete Images und verwenden Sie diese, um einen MCS-Maschinenkatalog zu erstellen, indem Sie Folgendes verwenden:
- Studio
- PowerShell-Befehle
Die wichtigsten Schritte zum Erstellen eines MCS-Maschinenkatalogs mit dem vorbereiteten Image sind:
- Erstellen Sie die Imagedefinition und die anfänglichen Imageversionen.
- Verwenden Sie die Imageversion als vorbereitetes Image, um einen Katalog zu erstellen.
Imagedefinition und anfängliche Imageversion erstellen
Studio verwenden
Gehen Sie wie folgt vor, um eine Imagedefinition und die anfängliche Imageversion zu erstellen:
- Navigieren Sie in Studio zum Knoten Images, und klicken Sie auf Imagedefinition erstellen. Klicken Sie auf der Seite Einführung auf Weiter.
- Geben Sie auf der Seite Imagedefinition den OS-Typ und den Sitzungstyp für die Imagedefinition an.
-
Wählen Sie auf der Seite Image die Ressourcen (nur die für die festgelegte Verbindung zutreffenden Ressourcen werden aufgelistet), ein Masterimage, das als Vorlage zum Erstellen der Imageversion verwendet werden soll, und ein Maschinenprofil zum Erfassen von Hardwareeigenschaften aus. Wählen Sie ein Maschinenprofil aus, um Hardwareeigenschaften von einer VM-Instanz oder einer Startvorlagenversion zu erfassen.
Hinweis:
- Vergewissern Sie sich vor der Auswahl eines Images, dass auf dem Masterimage VDA 2311 oder höher installiert ist und der MCSIO-Treiber auf dem VDA installiert ist.
- Der Instance Metadata Service (IMDS) V1 und V2 werden beide unterstützt.
- Wählen Sie auf der Seite Maschinenspezifikation eine Maschinengröße aus. Die Maschinengröße des Maschinenprofils (ausgewählt auf der Seite Image) ist standardmäßig ausgewählt.
- Wählen oder fügen Sie auf der Seite NICs NICs für das Vorbereitungs-Image hinzu. Wählen Sie für jede NIC ein zugehöriges VPC-Subnetz aus.
- Geben Sie auf der Seite Versionsbeschreibung eine Beschreibung für die erstellte anfängliche Image-Version ein.
- Überprüfen Sie auf der Seite Zusammenfassung die Details der Image-Definition und der erstellten anfänglichen Image-Version. Geben Sie einen Namen und eine Beschreibung für die Image-Definition ein. Klicken Sie auf Fertig stellen.
Image-Versionen erstellen
Image-Versionen ermöglichen die Verwaltung verschiedener Iterationen oder Updates eines bestimmten Images. Diese Funktionalität ermöglicht es Ihnen, mehrere Versionen eines Images für verschiedene Zwecke zu verwalten.
Gehen Sie wie folgt vor, um Image-Versionen aus der anfänglichen Image-Version zu erstellen:
Hinweis:
Die Hostingeinheit aller Image-Versionen muss dieselbe sein.
- Gehen Sie zum Knoten Images, wählen Sie eine Image-Version oder eine Image-Definition aus und klicken Sie auf Image-Version erstellen.
- Auf der Seite Image-Definition können Sie die Hostingeinheit ändern und das Master-Image sowie das Maschinenprofil für diese Image-Version neu auswählen.
- Wenn die Konfiguration der Image-Version von der anfänglich konfigurierten Image-Version abweichen soll, konfigurieren Sie die Einstellungen auf den Seiten Maschinenspezifikation und NICs des Dialogfelds Image-Version erstellen.
- Fügen Sie eine Beschreibung für die Image-Version hinzu. Klicken Sie auf Fertig stellen.
Hinweis:
Wenn die Erstellung der Image-Version aus irgendeinem Grund fehlschlägt, bietet die Registerkarte Fehlerbehebung unten eine Option zum Wiederholen.
PowerShell verwenden
Die detaillierten PowerShell-Befehle zum Erstellen einer Spezifikation für eine vorbereitete Image-Version lauten wie folgt:
-
Überprüfen Sie die verfügbaren Namen der Image-Definitionen mithilfe von
Test-ProvImageDefinitionNameAvailable command. Zum Beispiel:Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]> <!--NeedCopy--> -
Erstellen Sie eine Image-Definition mithilfe des Befehls
New-ProvImageDefinition. Zum Beispiel:New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession <!--NeedCopy--> -
Erstellen Sie eine neue Konfiguration für die Image-Definition in der angegebenen Hosting-Verbindung mithilfe des Befehls
Add-ProvImageDefinitionConnection.Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn <!--NeedCopy--> -
Erstellen Sie eine Image-Version mithilfe des Befehls
New-ProvImageVersion. Zum Beispiel:New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1" <!--NeedCopy--> -
Fügen Sie der Image-Version eine Spezifikation für die Master-Image-Version mithilfe des Befehls
Add-ProvImageVersionSpechinzu. Zum Beispiel:Add-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”" <!--NeedCopy-->Hinweis:
Sie können nur eine Spezifikation für die Master-Image-Version zu einer Image-Version für eine Hosting-Einheit hinzufügen.
-
Erstellen Sie eine Spezifikation für eine vorbereitete Image-Version aus der Spezifikation für die Master-Image-Version mithilfe des Befehls
New-ProvImageVersionSpec. Der ParameterSourceImageVersionSpecUidwird vom BefehlAdd-ProvImageVersionSpecabgeleitet. Zum Beispiel:New-ProvImageVersionSpec -SourceImageVersionSpecUid 00000000-0000-0000-0000-00000000000 -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously <!--NeedCopy-->
Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Erstellen einer Image-Definition, einer Image-Version und einer Spezifikation für eine vorbereitete Image-Version:
New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName aws-CustomProperties $CustomProperties
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
-HostingUnitUid $hostingunit.HostingUnitUid `
-MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName aws
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->
Hinweis:
- Alle Spezifikationen für Image-Versionen in einer Image-Definition müssen zur selben Hosting-Einheit gehören.
- Eine Image-Version kann nur eine Spezifikation für die Master-Image-Version und eine Spezifikation für die vorbereitete Image-Version haben.
- Alle Spezifikationen der Image-Version müssen ein Maschinenprofil haben.
Vorbereitete Images über Verfügbarkeitszonen und Regionen hinweg freigeben
Sie können jetzt ein einzelnes vorbereitetes Image über verschiedene Verfügbarkeitszonen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, innerhalb derselben AWS-Region oder in verschiedenen Regionen für Ihre AWS EC2-Umgebungen freigeben. Dadurch können Sie ein vorbereitetes Image verwenden, um MCS-Maschinenkataloge in verschiedenen Verfügbarkeitszonen und Regionen zu erstellen und zu aktualisieren. Beim Teilen über verschiedene AZs in verschiedenen Regionen wird die vorbereitete Image-Version von der ursprünglichen Region in die Zielregionen kopiert.
Sie können ein einziges vorbereitetes Image verwalten und es verwenden, um Maschinenkataloge über mehrere Verfügbarkeitszonen und Regionen hinweg, die an verschiedene Hosting-Einheiten gebunden sind, zu erstellen und zu aktualisieren. Dies reduziert Ihren Verwaltungsaufwand für Images erheblich, gewährleistet Konsistenz über Bereitstellungen hinweg und optimiert den Bereitstellungsprozess. Sie können auch vorhandene Maschinenkataloge nahtlos mit vorbereiteten Images aus einer anderen Verfügbarkeitszone oder Region aktualisieren.
Anwendungsfälle
-
Zentrale Image-Verwaltung: Sie erstellen ein vorbereitetes Image in einer Verfügbarkeitszone (z. B.
us-east-1a). Sie können dieses Image dann für andere Verfügbarkeitszonen wieus-east-1binnerhalb derselbenus-east-1AWS-Region oderus-west-1ain einer anderenus-west-1Region freigeben. Dies ermöglicht es, dass ein einziges Image mehrere Hosting-Einheiten bedient und vereinfacht die Wartung für Sie. -
Effiziente Katalogerstellung und -aktualisierung: Sie können ein in
AZ 1erstelltes vorbereitetes Image (z. B.us-east-1a) verwenden, um neue Kataloge inAZ 1zu erstellen. Nachdem Sie dieses Image fürAZ 2(z. B.us-east-1b) freigegeben haben, können Sie das freigegebene Image inAZ 2verwenden, um Kataloge inAZ 2zu erstellen und zu aktualisieren. - Bereitstellungen über Hosting-Einheiten und Hosting-Verbindungen hinweg: Wenn Ihre Umgebung mehrere Hosting-Einheiten unter denselben oder verschiedenen AWS-Regionen aufweist, können Sie vorbereitete Images effizient zwischen diesen Hosting-Einheiten freigeben.
Einschränkungen
Freigabe innerhalb desselben AWS-Kontos: In der aktuellen Implementierung können Sie nur innerhalb desselben AWS-Kontos freigeben.
Wichtige Überlegungen
- Löschreihenfolge: Um eine ursprüngliche Spezifikation einer vorbereiteten Image-Version zu löschen, müssen Sie zuerst alle ihre freigegebenen Spezifikationen der Image-Version löschen. Alternativ müssen Sie die ursprünglichen und freigegebenen Spezifikationen gleichzeitig löschen.
- Abhängigkeit der Image-Version: Wenn Sie eine Image-Version entfernen, müssen Sie zuerst alle Freigabekonfigurationen entfernen, die von dieser spezifischen Image-Version abhängen. Kataloge, die Sie aus dem ursprünglichen (nicht freigegebenen) Image erstellt haben, können intakt bleiben.
- Katalog-Rückwärtskompatibilität: Sie können vorhandene Maschinenkataloge aktualisieren, die Sie vor der Einführung dieser Funktion bereitgestellt haben. Verwenden Sie vorbereitete Images, die Sie in einer anderen Verfügbarkeitszone oder Region erstellt haben als der, in der Sie den Katalog ursprünglich bereitgestellt haben.
- Vollständige Löschung: Wenn Sie ein vorbereitetes Image löschen, können Sie es in keiner Verfügbarkeitszone mehr verwenden, in der Sie es freigegeben oder ursprünglich erstellt haben. Darüber hinaus kann eine vorbereitete Image-Version erst gelöscht werden, wenn alle Kataloge, die an diese vorbereitete Image-Version gebunden sind, zuerst gelöscht wurden.
Voraussetzungen
Bevor Sie diese Funktion konfigurieren oder verwenden, stellen Sie sicher, dass Sie die folgenden Bedingungen erfüllen:
- Ihre Umgebung muss eine AWS EC2-Umgebung sein.
- Sie müssen mehrere Hosting-Einheiten (jede kann an verschiedene Verfügbarkeitszonen gebunden sein) und Host-Verbindungen (jede kann an eine andere Region gebunden sein) unter demselben AWS-Konto konfigurieren.
Konfigurieren mit PowerShell
Sie können vorbereitete Images derzeit nur mithilfe von PowerShell-Befehlen über Verfügbarkeitszonen hinweg, die an verschiedene Hosting-Einheiten gebunden sind, freigeben.
So geben Sie ein vorbereitetes Image frei
- Stellen Sie sicher, dass Sie die
ImageVersionSpecUiddes vorbereiteten Images haben, das Sie freigeben möchten. Sie können dies mitGet-ProvImageVersionSpecoder ähnlichenGet-Befehlen in PowerShell abrufen. - Bestimmen Sie die
HostingUnitNameder Verfügbarkeitszone (kann dieselbe oder eine andere Region sein), in der Sie das vorbereitete Image verfügbar machen möchten. Dies ist der Name der Hosting-Einheit, die Sie für diese spezifische Verfügbarkeitszone konfiguriert haben. -
Führen Sie den Befehl
Add-ProvImageVersionSpecHostingUnitaus: Verwenden Sie den folgenden PowerShell-Befehl. Ersetzen Sie<ImageVersionSpecUid>durch die Uid Ihres Images und<targetHostingUnitName>durch den Namen der Hosting-Einheit in der Ziel-Verfügbarkeitszone, für die Sie die Image-Versionsspezifikation freigeben möchten:Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName> <!--NeedCopy--> - Nach erfolgreicher Ausführung können Sie den Status des Images in der Studio-Benutzeroberfläche sehen, der anzeigt, dass Sie es für die angegebene Hosting-Einheit freigegeben haben.
So entfernen Sie die Freigabe eines vorbereiteten Images
- Stellen Sie sicher, dass Sie die
ImageVersionSpecUiddes vorbereiteten Images haben, dessen Freigabe Sie aufheben möchten. - Bestimmen Sie die
HostingUnitNameder Verfügbarkeitszone, aus der Sie das freigegebene Image entfernen möchten. -
Führen Sie den Befehl
Remove-ProvImageVersionSpecHostingUnitaus: Verwenden Sie den folgenden PowerShell-Befehl. Ersetzen Sie<ImageVersionSpecUid>durch die Uid Ihres Images und<targetHostingUnitName>durch den Namen der Hosting-Einheit in der Ziel-Verfügbarkeitszone, aus der Sie die Freigabe der Image-Versionsspezifikation entfernen möchten:Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName> <!--NeedCopy-->
Maschinenkatalog erstellen
Studio verwenden
Maschinenkatalog über den Knoten „Images“ erstellen
Verwenden Sie die Option Katalog erstellen im Knoten Images, um einen Katalog mit der Imageversion zu erstellen.
Alternativ können Sie die Version beim Erstellen eines Katalogs im Knoten Machine Catalogs auswählen, wobei Sie auf die Option für vorbereitete Images im Workflow zur Katalogerstellung verweisen. Siehe Maschinenkatalog über den Knoten „Machine Catalogs“ erstellen.
Gehen Sie wie folgt vor, um einen MCS-Maschinenkatalog über den Knoten Images zu erstellen:
- Wählen Sie eine Imageversion aus und klicken Sie auf Katalog erstellen. Klicken Sie auf der Seite Einführung auf Weiter.
- Auf den Seiten Maschinenverwaltung und Image sind die Einstellungen basierend auf der ausgewählten Imageversion vorausgewählt. Geben Sie auf der Seite „Image“ eine Notiz für das ausgewählte vorbereitete Image ein.
- Schließen Sie die Einstellungen auf den folgenden Seiten ab.
- Überprüfen Sie auf der Seite Zusammenfassung die Details des Maschinenkatalogs. Geben Sie einen Namen und eine Beschreibung für den Maschinenkatalog ein. Klicken Sie auf Fertig stellen.
- Gehen Sie zum Knoten Machine Catalogs, um den erstellten Maschinenkatalog anzuzeigen.
Maschinenkatalog über den Knoten „Machine Catalogs“ erstellen
Gehen Sie wie folgt vor, um einen MCS-Maschinenkatalog über den Knoten „Machine Catalogs“ zu erstellen:
- Klicken Sie im linken Navigationsbereich auf Machine Catalogs.
- Klicken Sie auf Maschinenkatalog erstellen. Die Seite Maschinenkatalog-Setup wird angezeigt.
- Wählen Sie auf der Seite Maschinentyp einen Maschinentyp für den Katalog aus, zum Beispiel Multi-session OS.
-
Wählen Sie auf der Seite Maschinenverwaltung die folgenden Einstellungen aus:
- Wählen Sie Energieverwaltete Maschinen (z. B. virtuelle Maschinen oder Blade-PCs) aus.
- Wählen Sie Citrix Provisioning-Technologie aus. Wählen Sie dann Citrix Machine Creation Services™ aus.
- Wählen Sie im Feld Ressourcen die Ressourcen (Verfügbarkeitszone) aus, die Sie beim Erstellen der Hostverbindung konfiguriert haben, und klicken Sie auf Weiter.
- Wählen Sie auf der Seite Desktop-Erfahrung entweder einen zufälligen oder einen statischen Desktop aus, den Benutzer beim Anmelden erhalten sollen. Wenn ein statischer Desktop ausgewählt ist, geben Sie außerdem an, ob Änderungen, die der Benutzer auf der lokalen Festplatte vornimmt, gespeichert werden sollen (persistent oder nicht-persistent).
-
Klicken Sie auf der Seite Image auf Image auswählen, um ein vorbereitetes Image für den Maschinenkatalog auszuwählen. Wählen Sie die vorbereitete Version aus, die Sie erstellt haben. Klicken Sie auf den Namen der Imageversion. Um weitere Details zur ausgewählten Imageversion anzuzeigen, klicken Sie auf die unterstrichene Versionsnummer. Klicken Sie auf Fertig.
Das mit dem vorbereiteten Image verknüpfte Maschinenprofil wird angezeigt und seine Hardwareeigenschaften (z. B. Instanztyp, Mandantentyp, Netzwerkzuordnungen, Sicherheitsgruppen, Volume-Eigenschaften) werden zum Erstellen von Maschinen in den Katalogen verwendet. Um die Maschinenprofilquelle in eine andere VM- oder Startvorlagenversion zu ändern, klicken Sie auf die Schaltfläche „Bearbeiten“.
-
Auf der Seite Virtuelle Maschinen:
- Geben Sie die Anzahl der VMs für den Katalog ein.
- Die Standardmaschinenspezifikation wird angezeigt, die auf dem Maschinenprofil basiert. Um sie zu ändern, wählen Sie das Bearbeitungssymbol und eine Maschinenspezifikation aus.
- Wählen Sie auf der Seite NICs die NICs (oder ENIs) für die VMs aus.
- Konfigurieren Sie auf der Seite Maschinenidentitäten lokales Active Directory oder Microsoft Entra Hybrid Joined für die Maschinen im Katalog, indem Sie die Domäne auswählen und neue AD-Konten für die in diesem Maschinenkatalog zu erstellenden VMs erstellen. Die bereitgestellten VMs werden der ausgewählten Domäne hinzugefügt. Geben Sie das Kontenbenennungsschema für die neuen AD-Konten an, die für die VMs erstellt werden sollen. Klicken Sie auf Weiter.
- Klicken Sie auf der Seite Domänenanmeldeinformationen auf Anmeldeinformationen eingeben, um die Anmeldeinformationen für die ausgewählte Domäne anzugeben. Geben Sie bei Aufforderung einen Benutzernamen und ein Kennwort mit Administratorrechten ein. Sie können auch ein Dienstkonto verwenden, wenn Sie Domänenanmeldeinformationen bereits zuvor gespeichert haben, indem Sie unsere Produktdokumentation befolgen.
- Klicken Sie sich durch die verbleibenden Seiten bis zur Seite Zusammenfassung. Geben Sie einen Namen für den Maschinenkatalog ein und wählen Sie Fertig stellen, um den Maschinenkatalog zu erstellen.
PowerShell verwenden
Katalog mit einer vorbereiteten Image-Versionsspezifikation und einem Maschinenprofil erstellen
-
Erstellen Sie einen nicht persistenten MCS-Maschinenkatalog aus der vorbereiteten Image-Versionsspezifikation mit dem Befehl
New-ProvScheme. Beispiel:New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] <!--NeedCopy--> -
Erstellen Sie einen persistenten MCS-Maschinenkatalog aus der vorbereiteten Image-Versionsspezifikation mit dem Befehl
New-ProvScheme. Beispiel:New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] <!--NeedCopy-->
Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Erstellen eines Katalogs:
$Catalog = New-BrokerCatalog -AllocationType "Random" -IsRemotePC $False -MinimumFunctionalLevel "L7_20" -Name "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool -AllowUnicode -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory" -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName awscatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->