Créez le script de configuration pour le VHD dans Amazon AppStream 2.0 - Amazon AppStream 2.0

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez le script de configuration pour le VHD dans Amazon AppStream 2.0

AppStream La version 2.0 utilise un script de configuration que vous fournissez pour le monter 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, enregistrerDLLs, 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 votreVHD. Vous devrez modifier ces scripts en fonction de vos besoins VHD et de ceux de l'application.

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 :

AppStream La version 2.0 télécharge le script VHD de configuration 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 script d'installation VHD et :

  • Amazon Linux 2 :

    /opt/appstream/AppBlocks/appblock-name/

    appblock-name

    Nom du bloc d'application auquel correspond le script de configuration VHD et.

  • Microsoft Windows :

    C:\AppStream\AppBlocks\appblock-name\

    appblock-name

    Nom du bloc d'application auquel correspond le script de configuration VHD et.

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 nom apps.vhd et un script de configuration nommésmount-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.