Création du script de configuration pour le VHD

AppStream La version 2.0 utilise un script de configuration que vous fournissez pour monter le VHD avant le lancement de l'application. Vous pouvez également utiliser le script de configuration pour effectuer d’autres tâches nécessaires au bon fonctionnement de votre application. Par exemple, vous pouvez configurer des clés de registre, enregistrer des DLL, gérer les prérequis ou modifier le profil utilisateur à partir du script de configuration. AppStream La version 2.0 fournit des exemples de scripts que vous pouvez utiliser pour monter votre VHD. Vous devrez modifier ces scripts en fonction des besoins de votre VHD et de vos applications.

Note

Les scripts de configuration ne sont pas nécessaires pour les blocs d'applications dotés d'un package AppStream 2.0. Vous pouvez toutefois fournir des scripts de post-installation facultatifs pour personnaliser l’installation des applications.

Utilisez les liens suivants pour télécharger les exemples de scripts :

• Script bash Amazon Linux 2

• Script Microsoft Windows PowerShell

  Note

  AppStream 2.0 et le système d'exploitation Microsoft Windows réservent les lettres de lecteur A à E. Ne montez pas de disques durs virtuels ou de partages réseau sur ces lettres de lecteur.

AppStream La version 2.0 télécharge le script de configuration et le VHD dans un répertoire de l'instance de streaming de flotte, puis exécute le script de configuration. Le script de configuration s’exécute sur le système d’exploitation avec tous les droits d’administrateur. Le script de configuration s’exécute dans le contexte SYSTEM sur Microsoft Windows et en tant qu’utilisateur root sur Amazon Linux 2.

Emplacement du système de fichiers pour le VHD et le script de configuration :

• Amazon Linux 2 :

  /opt/appstream/AppBlocks/appblock-name/

  appblock-name

  Nom du bloc d’applications auquel correspondent le VHD et le script de configuration.

• Microsoft Windows :

  C:\AppStream\AppBlocks\appblock-name\

  appblock-name

  Nom du bloc d’applications auquel correspondent le VHD et le script de configuration.

AppStream 2.0 conserve le nom du fichier tel qu'il figure sur l'objet. Par exemple, si votre bloc d’applications est nommé MyApps, avec un VHD nommé apps.vhd et un script de configuration nommé mount-apps.ps1, le chemin complet d’une instance de streaming Windows est le suivant :

• VHD

  C:\AppStream\AppBlocks\MyApps\apps.vhd

• Script de configuration

  C:\AppStream\AppBlocks\MyApps\mount-apps.ps1

AppStream La version 2.0 capture l'erreur standard et la sortie standard de votre script de configuration lorsqu'il s'exécute sur une instance de streaming de flotte et télécharge la sortie dans un compartiment Amazon S3 de votre compte. Vous pouvez utiliser ces journaux pour identifier et résoudre les problèmes que vous pourriez rencontrer avec votre script de configuration. Les compartiments sont nommés dans un format spécifique comme suit :

appstream-logs-region-code-account-id-without-hyphens-random-identifier

region-code

Il s'agit du code de AWS région dans lequel la flotte élastique est créée.

account-id-without-hyphens

L'identifiant AWS de votre compte. L'identifiant aléatoire permet de garantir qu'aucun conflit ne sera déclenché avec les autres compartiments de la région. La première partie du nom du compartiment, appstream-logs, ne change pas, quel que soit le compte ou la région.

Par exemple, si vous créez une flotte élastique dans la région USA Ouest (Oregon) (us-west-2) sous le numéro de compte 123456789012 AppStream , 2.0 crée un compartiment Amazon S3 au sein de votre compte dans cette région avec le nom indiqué. Seul un administrateur disposant d’autorisations suffisantes peut supprimer ce compartiment.

appstream-logs-us-west-2-1234567890123-abcdefg

Le chemin d’accès au dossier dans lequel les fichiers journaux sont stockés dans le compartiment S3 de votre compte est structuré comme suit :

bucket-name/fleet-name/instance-id/appblock-name/

bucket-name

Nom du compartiment Amazon S3 dans lequel les journaux de script de configuration sont stockés. Le format du nom est décrit plus haut dans cette section.

Instance-id

Identifiant unique de l’instance de streaming sur laquelle le script de configuration s’est exécuté

appblock-name

Nom du bloc d’applications auquel correspond le script de configuration.

L’exemple de structure de dossier suivant correspond à une session de streaming démarrée à partir de test-fleet. La session provient d'un Compte AWS identifiant 123456789012 et le nom du bloc d'applications est testappblock dans la région USA Ouest (Oregon) (us-west-2) :

appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/

Cet exemple de structure de dossiers contient un fichier journal pour la sortie standard et un fichier journal pour l’erreur standard.

Exécution du script de configuration du bloc d’applications

Les schémas suivants indiquent à quel stade du processus le script de configuration s’exécute. L’ordre d’exécution dépend de l’activation ou non de la persistance des paramètres d’application sur la pile associée à la flotte Elastic.

Note

AppStream 2.0 utilise les informations de votre VPC pour télécharger le VHD et le script de configuration depuis le compartiment Amazon S3. Votre VPC doit fournir l’accès au compartiment Amazon S3. Pour plus d’informations, consultez Utilisation des points de terminaison VPC Amazon S3 pour les fonctionnalités 2.0 AppStream .

La persistance des paramètres d’application est activée :

La persistance des paramètres d’application est désactivée :