Erstellen des Setup-Skripts für die VHD

AppStream 2.0 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, DLLs registrieren, Voraussetzungen verwalten oder das Benutzerprofil über das Setupskript ändern. AppStream 2.0 bietet Skriptbeispiele, 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 AppStream 2.0-Paketen 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:

• Amazon-Linux-2-Bash-Skript

• Microsoft-Windows-Powershell-Skript

  Anmerkung

  AppStream 2.0 und das Microsoft Windows-Betriebssystem reservieren die Laufwerksbuchstaben A bis E. Mounten Sie keine virtuellen Festplatten oder Netzwerkfreigaben auf diesen Laufwerksbuchstaben.

AppStream 2.0 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 ausgeführt.

Speicherort im Dateisystem für die VHD und das Setup-Skript:

• 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.

AppStream 2.0 behält 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

AppStream 2.0 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 innerhalb Ihres Kontos 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 Fleet 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 elastische Flotte in der Region USA West (Oregon) (us-west-2) mit der Kontonummer 123456789012 erstellen, erstellt AppStream 2.0 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.

Ausführung des Anwendungsblock-Setup-Skripts

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

AppStream 2.0 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 Verwenden von Amazon S3 S3-VPC-Endpunkten für 2.0-Funktionen AppStream .

Die Persistenz von Anwendungseinstellungen ist aktiviert:

Die Persistenz von Anwendungseinstellungen ist deaktiviert: