Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Benutzerdefinierte Anwendungsblöcke Elastic-Flotten-Streaming-Instances verwenden Anwendungen, die in Virtual Hard Disk (VHD)-Dateien installiert werden, die in einem Amazon-S3-Bucket in Ihrem Konto gespeichert sind. Anwendungsblöcke mit benutzerdefinierter Paketierung bieten Ihnen die Flexibilität, Ihre eigene VHD-Datei zu erstellen und sie in einen Amazon-S3-Bucket innerhalb Ihres Kontos hochzuladen. **Topics** + [Erstellen der VHD](create-vhd.md) + [Erstellen Sie das Setup-Skript für die virtuelle Festplatte in Amazon-Anwendungen WorkSpaces](create-setup-script.md) + [Erstellen eines benutzerdefinierten Anwendungsblocks](create-app-block.md) + [Aktualisieren von Anwendungsblock, VHD und Setup-Skript](update-app-block.md) # Erstellen der VHD Eine VHD ist eine einzelne Datei, die beim Mounten im Betriebssystem wie eine Festplatte behandelt wird. Die VHD kann mit einem Laufwerksbuchstaben, einem Ordnerpfad oder beidem gemountet werden. Wenn die VHD gemountet ist, können Sie sie wie jede andere Festplatte behandeln, einschließlich der Installation Ihrer Anwendung oder des Kopierens von Dateien, die Ihr Benutzer benötigt. Um den Anwendungsblock zu erstellen, müssen Sie die VHD erstellen, Ihre Anwendungen darauf installieren und sie anschließend trennen. Nach dem Trennen können Sie Ihre virtuelle Festplatte auf einem anderen PC, einer EC2-Instance oder einem WorkSpaces Applications Image Builder testen, um zu überprüfen, ob die Anwendungen erwartungsgemäß funktionieren. Wenn Sie diesen Vorgang abgeschlossen haben, führen Sie einen Upload in einen Amazon-S3-Bucket in Ihrem Konto durch und erstellen Sie den Anwendungsblock. **Anmerkung** Auf dieser Seite wird beschrieben, wie Sie Ihre Anwendung mithilfe einer virtuellen Festplatte bereitstellen. Die WorkSpaces Applications-Streaming-Instance lädt jedoch jedes Objekt von Amazon S3 herunter. Das Objekt, das Sie in Amazon S3 speichern, kann auch eine ZIP-Datei, ein Anwendungsinstallationsprogramm oder die ausführbare Anwendungsdatei selbst sein. Sie können das Setup-Skript verwenden, um es auf der Streaming-Instance korrekt zu konfigurieren, bevor ein Benutzer seine Anwendung startet. Die WorkSpaces Applications Streaming-Instance wartet bis zu 120 Sekunden, bis der Download der virtuellen Festplatte abgeschlossen ist, bevor das Setup-Skript ausgeführt wird. Wenn der Download der VHD innerhalb dieser Zeit nicht abgeschlossen ist, wird der Download beendet und das Setup-Skript wird nicht ausgeführt. Wir empfehlen eine maximale Größe von 1,5 Gigabyte für die VHD. Möglicherweise können Sie die Größe der VHD durch Komprimieren reduzieren. Sie müssen das Setup-Skript verwenden, um es vor dem Mounten zu dekomprimieren, da die Datei vollständig von Amazon S3 heruntergeladen werden muss, bevor sie gemountet und die Anwendung gestartet werden kann. VHDsErhöhen Sie die Zeit, die zum Starten der Anwendung und zum Starten der Streaming-Sitzung benötigt wird. **So erstellen Sie eine VHD für Microsoft Windows** 1. Öffnen Sie auf einem Windows-PC oder einer Windows Amazon Elastic Compute Cloud (Amazon EC2)-Instance eine Eingabeaufforderung mit Administratorrechten. 1. Starten Sie das Microsoft-**diskpart**-Dienstprogramm, indem Sie den folgenden Befehl eingeben: **diskpart** 1. Erstellen Sie die unformatierte und nicht initialisierte VHD-Datei, indem Sie den folgenden Befehl eingeben, der die Größe der VHD-Datei in ** MB angibt: **create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable ** 1. Wählen Sie die neu erstellte VHD aus, indem Sie den folgenden Befehl eingeben: **select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx** 1. Hängen Sie die neu erstellte VHD an, indem Sie den folgenden Befehl eingeben: **attach vdisk** 1. Initialisieren Sie die neu erstellte VHD, indem Sie den folgenden Befehl eingeben: **convert mbr** 1. Erstellen Sie die primäre Partition, die die gesamte VHD umfasst, indem Sie den folgenden Befehl eingeben: **create partition primary** 1. Formatieren Sie die neu erstellte VHD, indem Sie den folgenden Befehl eingeben: **format fs=ntfs quick** 1. Sie können Ihre neu erstellte VHD mit einem unbenutzten Laufwerksbuchstaben, einem Ordnerpfad auf dem Stamm-Volume oder beidem mounten. Um mit einem Laufwerksbuchstaben zu mounten, geben Sie Folgendes ein: **assign letter=**** Um mit einem Ordner zu mounten, geben Sie Folgendes ein: **assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1*** **Anmerkung** Um mit einem Ordnerpfad zu mounten, muss der Ordner bereits existieren und leer sein. 1. Sie können Ihre Anwendung jetzt auf der VHD installieren, indem Sie entweder den Laufwerksbuchstaben oder den in Schritt 9 ausgewählten Ordnermountpfad verwenden. Nachdem Sie die Installation Ihrer Anwendung(en) auf der VHD abgeschlossen haben, müssen Sie sie trennen, bevor Sie sie sicher in einen Amazon-S3-Bucket hochladen können. **So trennen Sie eine VHD für Microsoft Windows** 1. Starten Sie das Microsoft-DiskPart-Dienstprogramm, indem Sie den folgenden Befehl eingeben: **diskpart** 1. Wählen Sie die VHD aus, indem Sie den folgenden Befehl eingeben: **select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx*** 1. Trennen Sie die VHD, indem Sie den folgenden Befehl eingeben: **detach vdisk** 1. Die virtuelle Festplatte wurde jetzt getrennt und kann auf einem anderen Windows-PC, einer Amazon EC2 EC2-Instance oder einem WorkSpaces Applications Image Builder getestet werden. **So erstellen Sie eine VHD für Linux** 1. Öffnen Sie ein Terminal: + Für Amazon Linux 2: Verwenden Sie EC2-Instance, WorkSpaces Applications Image Builder oder WorkSpaces Powered by Amazon Linux 2 + Für Ubuntu Pro 24.04 LTS: Verwenden Sie eine EC2-Instance oder eine von Ubuntu Pro betriebene Instanz WorkSpaces 1. Erstellen Sie die unformatierte und nicht initialisierte VHD-Datei: **dd if=/dev/zero of=** bs=** count=1** 1. Fügen Sie der erstellten VHD ein Dateisystem hinzu, indem Sie den folgenden Befehl eingeben: **sudo mkfs -t ext4 **** **Anmerkung** Möglicherweise wird eine Meldung angezeigt, dass es sich bei der Datei nicht um ein besonderes blockorientiertes Gerät handelt. Sie können wählen, trotzdem fortzufahren. 1. Erstellen Sie einen leeren Ordner, der für den Mountingpunkt verwendet werden soll, indem Sie den folgenden Befehl eingeben: **sudo mkdir */path/to/mount/point*** 1. Mounten Sie die neu erstellte VHD mit einem Dateisystempfad, indem Sie den folgenden Befehl ausführen: **sudo mount -t auto -o loop ** */path/to/mount/point*** 1. Sie können Ihre Anwendung jetzt auf der VHD installieren, indem Sie den in Schritt 4 ausgewählten Ordnermountpfad verwenden. **Anmerkung** Durch die Standardberechtigungen für auf der VHD erstellte Dateien und Ordner können Benutzer ohne Administratorrechte daran gehindert werden, Anwendungen zu starten oder Dateien zu lesen. Validieren Sie die Berechtigungen und ändern Sie sie gegebenenfalls. Nachdem Sie die Installation Ihrer Anwendung(en) auf der VHD abgeschlossen haben, müssen Sie sie trennen, bevor Sie sie sicher in einen Amazon-S3-Bucket hochladen können. **So trennen Sie eine VHD für Linux** 1. Öffnen Sie eine Terminalsitzung und führen Sie den folgenden Befehl aus: **sudo umount */path/to/mount/point*** 1. Die virtuelle Festplatte wurde jetzt getrennt und kann auf einer anderen Amazon Linux 2/Ubuntu Pro 24.04 LTS Amazon EC2-Instance, Amazon Linux 2 WorkSpaces Applications Image Builder oder Amazon Linux 2/Ubuntu Personal getestet werden. WorkSpaces # Erstellen Sie das Setup-Skript für die virtuelle Festplatte in Amazon-Anwendungen WorkSpaces WorkSpaces Applications verwendet ein von Ihnen bereitgestelltes Setup-Skript, um die virtuelle Festplatte zu mounten, bevor die Anwendung gestartet wird. Sie können das Setup-Skript auch verwenden, um andere Aufgaben zu erledigen, die erforderlich sind, damit Ihre Anwendung funktioniert. Sie können beispielsweise Registrierungsschlüssel konfigurieren, sich registrieren DLLs, Voraussetzungen verwalten oder das Benutzerprofil über das Setupskript ändern. WorkSpaces Applications stellt Skriptbeispiele bereit, mit denen Sie Ihre virtuelle Festplatte mounten können. Sie müssen diese Skripts an Ihre VHD- und Anwendungsanforderungen anpassen. **Anmerkung** Setup-Skripte sind für App-Blöcke mit WorkSpaces Anwendungspaketen nicht erforderlich. Sie können jedoch optionale Post-Setup-Skripts bereitstellen, um die Anwendungsinstallation anzupassen. Verwenden Sie die folgenden Links, um die Beispiel-Skripts herunterzuladen: + [Ubuntu Pro 24.04 LTS und Amazon Linux 2-Bash-Skript](samples/Linux-mount-vhd-script2.zip) + [Microsoft-Windows-Powershell-Skript](samples/Windows-mount-vhd-script3.zip) **Anmerkung** WorkSpaces Anwendungen und das Microsoft Windows-Betriebssystem reservieren die Laufwerksbuchstaben A bis E. Mounten VHDs oder Netzwerkfreigaben auf diesen Laufwerksbuchstaben. WorkSpaces Applications lädt das Setup-Skript und die virtuelle Festplatte in ein Verzeichnis auf der Fleet-Streaming-Instance herunter und führt dann das Setup-Skript aus. Das Setup-Skript wird auf dem Betriebssystem mit vollen Administratorrechten ausgeführt. Das Setup-Skript wird im `SYSTEM` Kontext unter Microsoft Windows und als `root` Benutzer unter Amazon Linux 2 oder Ubuntu Pro 24.04 LTS ausgeführt. Speicherort im Dateisystem für die VHD und das Setup-Skript: + Ubuntu Pro 24.04 LTS: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** Der Name des Anwendungsblocks, dem die VHD und das Setup-Skript entsprechen. + Amazon Linux 2: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** Der Name des Anwendungsblocks, dem die VHD und das Setup-Skript entsprechen. + Microsoft Windows: `C:\AppStream\AppBlocks\appblock-name\` **`appblock-name` ** Der Name des Anwendungsblocks, dem die VHD und das Setup-Skript entsprechen. WorkSpaces Anwendungen behalten den Dateinamen so bei, wie er sich auf dem Objekt befindet. Wenn Ihr Anwendungsblock beispielsweise `MyApps` heißt, mit einer VHD namens `apps.vhd` und einem Setup-Skript namens `mount-apps.ps1`, dann lautet der vollständige Pfad auf einer Windows-Streaming-Instance: + VHD `C:\AppStream\AppBlocks\MyApps\apps.vhd` + Setup-Skript `C:\AppStream\AppBlocks\MyApps\mount-apps.ps1` WorkSpaces Applications erfasst den Standardfehler und die Standardausgabe Ihres Setup-Skripts, wenn es auf einer Fleet-Streaming-Instance ausgeführt wird, und lädt die Ausgabe in einen Amazon S3 S3-Bucket in Ihrem Konto hoch. Sie können diese Protokolle verwenden, um Probleme mit Ihrem Setup-Skript zu identifizieren und zu lösen. Die Benennung der Buckets erfolgt wie folgt in einem bestimmten Format: ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` **`region-code` ** Dies ist der AWS Regionalcode, in dem die Elastic-Flotte erstellt wird. **`account-id-without-hyphens` ** Ihre AWS Konto-ID. Die zufällige ID stellt sicher, dass keine Konflikte mit anderen Buckets in dieser Region auftreten. Der erste Teil des Bucket-Namens, appstream-logs, ändert sich konto- oder regionsübergreifend nicht. Wenn Sie beispielsweise eine Elastic-Flotte in der Region USA West (Oregon) (us-west-2) mit der Kontonummer 123456789012 erstellen, erstellt WorkSpaces Applications innerhalb Ihres Kontos in dieser Region einen Amazon S3 S3-Bucket mit dem angezeigten Namen. Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen. ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` Der Pfad für den Ordner, in dem die Protokolldateien im S3-Bucket in Ihrem Konto gespeichert werden, hat die folgende Struktur: ``` bucket-name/fleet-name/instance-id/appblock-name/ ``` **`bucket-name` ** Der Name des Amazon-S3-Buckets, in dem die Setup-Skript-Protokolle gespeichert werden. Auf das Format des Namens wird weiter oben in diesem Abschnitt eingegangen. **`Instance-id` ** Die eindeutige Kennung für die Streaming-Instance, auf der das Setup-Skript ausgeführt wurde. **`appblock-name` ** Der Name des Anwendungsblocks, dem das Setup-Skript entspricht. Das folgende Beispiel für eine Ordnerstruktur gilt für eine Streaming-Sitzung, die von `test-fleet` gestartet wurde. Die Sitzung hat die AWS-Konto ID 123456789012 und der Appblock-Name ist testappblock in der Region USA West (Oregon) (us-west-2): `appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/` Dieses Beispiel für eine Ordnerstruktur enthält eine Protokolldatei für die Standardausgabe und eine Protokolldatei für den Standardfehler. **Topics** + [Ausführung von App-Block-Setup-Skripten in Amazon WorkSpaces Applications](script-execution.md) # Ausführung von App-Block-Setup-Skripten in Amazon WorkSpaces Applications Die folgenden Diagramme zeigen, wo im Prozess das Setup-Skript ausgeführt wird. Die Ausführungsreihenfolge hängt davon ab, ob die Persistenz von Anwendungseinstellungen auf dem Stack aktiviert ist, der der Elastic-Flotte zugeordnet ist. **Anmerkung** WorkSpaces Applications verwendet Ihre VPC-Daten, um die virtuelle Festplatte und das Setup-Skript aus dem Amazon S3 S3-Bucket herunterzuladen. Ihre VPC muss den Zugriff auf den Amazon-S3-Bucket ermöglichen. Weitere Informationen finden Sie unter [Verwendung von Amazon S3 S3-VPC-Endpunkten für Anwendungsfunktionen WorkSpaces](managing-network-vpce-iam-policy.md). Die Persistenz von Anwendungseinstellungen ist aktiviert: ![\[Die Persistenz von Anwendungseinstellungen ist aktiviert.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/app-settings-enabled.png) Die Persistenz von Anwendungseinstellungen ist deaktiviert: ![\[Die Persistenz von Anwendungseinstellungen ist deaktiviert.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/app-settings-disabled.png) # Erstellen eines benutzerdefinierten Anwendungsblocks Sie können die WorkSpaces Anwendungskonsole verwenden, um die App-Block-Ressource zu erstellen, sobald Sie Ihre virtuelle Festplatte und das Setup-Skript erstellt und in einen S3-Bucket in Ihrem hochgeladen haben. AWS-Konto Weitere Informationen zum Speichern der VHD und des Setup-Skripts in einem Amazon-S3-Bucket finden Sie unter [Speichern der Anwendungssymbole, Setup-Skripts, Sitzungsskripts und VHDs in einem S3-Bucket](store-s3-bucket.md). **Anmerkung** Sie benötigen IAM-Berechtigungen zum Ausführen der `S3:GetObject`-Aktion für die VHD- und Setup-Skript-Objekte im Amazon-S3-Bucket, um die Ressource des Anwendungsblocks zu erstellen. **So erstellen Sie die Ressource des Anwendungsblocks** 1. Öffnen Sie die WorkSpaces Anwendungskonsole unter [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2) 1. Wählen Sie im linken Navigationsmenü **Anwendungen**, **Anwendungsblock** und **Anwendungsblock erstellen** aus. 1. Wählen Sie für die Paketierung des Anwendungsblocks die Option **Benutzerdefiniert** aus. 1. Geben Sie für **Anwendungsblockdetails** eine eindeutige Namenskennung für den Anwendungsblock ein. Optional können Sie auch Folgendes spezifizieren: + **Anzeigename** – Ein benutzerfreundlicher Name für den Anwendungsblock. + **Beschreibung** – Eine Beschreibung für den Anwendungsblock. 1. Geben Sie für **Virtual-Hard-Disk-Objekt in S3** unter **Skript-Einstellungen** entweder den S3-URI ein, der das VHD-Objekt darstellt, oder wählen Sie **S3 durchsuchen** aus, um zu Ihren S3-Buckets zu navigieren und das VHD-Objekt zu suchen. 1. Geben Sie für **Setup-Skript-Objekt in S3** unter **Skript-Einstellungen** entweder den S3-URI ein, der das Setup-Skript-Objekt darstellt, oder wählen Sie **S3 durchsuchen** aus, um zu Ihren S3-Buckets zu navigieren und das Setup-Skript-Objekt zu suchen. 1. Geben Sie für **Ausführbare Setup-Skript-Datei** unter **Skript-Einstellungen** die für Ihr Setup-Skript erforderliche ausführbare Datei ein. **Anmerkung** Wenn Ihr Setup-Skript direkt ausgeführt werden kann, geben Sie den Dateinamen des Setup-Skripts ein. Wenn Ihr Setup-Skript von einer anderen ausführbaren Datei (z. B. Microsoft PowerShell) ausgeführt werden muss, geben Sie den Pfad zu dieser ausführbaren Datei ein. Pfad zu Microsoft PowerShell unter Microsoft Windows: `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` 1. Geben Sie optional für **Argumente der ausführbaren Setup-Skript-Datei** unter **Skript-Einstellungen** die Argumente ein, die der ausführbaren Setup-Skript-Datei zur Verfügung gestellt werden müssen, um Ihr Setup-Skript auszuführen. **Anmerkung** Wenn Sie ein PowerShell Microsoft-Skript verwenden, müssen Sie den Parameter „-File“ mit dem Namen Ihres Setup-Skripts als ausführbares Argument angeben. Stellen Sie außerdem sicher, dass die Ausführungsrichtlinie die Ausführung Ihres Skripts zulässt. [Weitere Informationen finden Sie unter [about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) und Was ist? PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2) . 1. Geben Sie für **Ausführungsdauer in Sekunden** unter **Skript-Einstellungen** die Timeout-Dauer für Ihr Setup-Skript ein. **Anmerkung** Die Ausführungsdauer in Sekunden gibt an, wie lange WorkSpaces Anwendungen auf die Ausführung des Setup-Skripts warten, bevor sie fortfahren. Wenn Ihr Setup-Skript nicht innerhalb dieser Zeit abgeschlossen wird, wird Ihrem Benutzer ein Fehler angezeigt und die Anwendung versucht zu starten. Das Setup-Skript wird nach Ablauf der Ausführungsdauer beendet. 1. (Optional) Erstellen Sie für **Tags** die Tags für die Ressource des Anwendungsblocks. 1. Prüfen Sie die Informationen, die Sie eingegeben haben, und wählen Sie **Erstellen** aus. 1. Wenn Ihr Anwendungsblock erfolgreich erstellt wurde, sehen Sie oben in der Konsole eine Erfolgsmeldung. Wenn ein Fehler aufgetreten ist, wird eine beschreibende Fehlermeldung angezeigt und Sie müssen erneut versuchen, den Anwendungsblock zu erstellen. # Aktualisieren von Anwendungsblock, VHD und Setup-Skript Ressourcen des Anwendungsblocks sind unveränderlich und ermöglichen es Ihnen nicht, sie nach ihrer Erstellung zu ändern. Wenn Sie abwärts kompatible Aktualisierungen an der VHD oder dem Setup-Skript vornehmen müssen, wird empfohlen, eine neue Version der Datei in den Amazon-S3-Bucket hochzuladen und dabei die aktuelle Version zu überschreiben. Bei neuen Elastic-Flotten-Streaming-Sitzungen wird die neueste Version der Objekte heruntergeladen und verwendet. Wenn Sie abwärts inkompatible Aktualisierungen an der VHD oder dem Setup-Skript vornehmen müssen, wird empfohlen, diese als neue Objekte in den Amazon-S3-Bucket hochzuladen und einen neuen Anwendungsblock und eine neue Anwendungsressource zu erstellen. Anschließend können Sie die Bereitstellung für Ihre Benutzer im Rahmen eines Änderungsfensters oder eines anderen Ausfalls verwalten.