

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éation d’images basées sur Linux
<a name="create-linux-based-images"></a>

Vous pouvez créer des images WorkSpaces Amazon Applications basées sur Linux en vous connectant à un générateur d'images Linux, en installant les applications dont vous avez besoin, en créant des paramètres d'application par défaut et des variables d'environnement, et en utilisant un outil d'interface de ligne de commande (CLI) ou un outil d'assistant d'image (GUI) pour ajouter ces applications au catalogue d'applications. Pour ouvrir l’outil graphique, recherchez **Image Assistant** dans la liste des applications.

**Topics**
+ [Création de paramètres d’application par défaut pour vos utilisateurs](create-default-app-settings.md)
+ [Création de variables d’environnement par défaut pour vos utilisateurs Linux](create-default-variables-linux.md)
+ [Optimisation des performances de lancement de vos applications Linux](optimize-launch-performance.md)
+ [Création de scripts de session](create-session-scripts.md)
+ [Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux](image-assistant-cli.md)
+ [Activation et désactivation de la prise en charge de la webcam](webcam-support.md)
+ [Activation et désactivation du mode de synchronisation des fichiers lourds pour les dossiers personnels](heavy-file-sync.md)
+ [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md)
+ [Didacticiel : Activation de la prise en charge du japonais pour vos images Linux](enable-japanese-support-linux.md)

# Création de paramètres d’application par défaut pour vos utilisateurs
<a name="create-default-app-settings"></a>

Suivez ces étapes pour créer les paramètres d'application par défaut pour vos utilisateurs.

**Topics**
+ [Étape 1 : installer les applications Linux sur l’instance Image Builder](#app-settings-image-install)
+ [Étape 2 : créer un TemplateUser compte](#app-settings-template-user)
+ [Étape 3 : créer les paramètres d’application par défaut](#app-settings-image-create-default-app-settings)
+ [Étape 4 : enregistrer les paramètres d’application par défaut](#app-settings-image-save-default-app-settings)
+ [Étape 5 : tester les paramètres d’application par défaut (facultatif)](#app-settings-image-test-applications)
+ [Étape 6 : nettoyer](#app-settings-image-finish)

## Étape 1 : installer les applications Linux sur l’instance Image Builder
<a name="app-settings-image-install"></a>

Au cours de cette étape, vous allez vous connecter à une instance Image Builder Linux et y installer les applications.

**Pour installer des applications sur l’instance Image Builder**

1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes : 
   + [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
   + [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**  
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.

1. Installez les applications nécessaires. Par exemple, pour installer un navigateur Chromium à partir d’un référentiel yum public, ouvrez d’abord l’application Terminal, puis exécutez la commande suivante :

   **[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164** 

## Étape 2 : créer un TemplateUser compte
<a name="app-settings-template-user"></a>

Au cours de cette étape, vous créez un TemplateUser compte qui crée les paramètres d'application par défaut pour vos utilisateurs de streaming.

**Pour créer un TemplateUser compte**

1. Créez un TemplateUser compte qui ne possède aucune autorisation root. Par exemple, dans une fenêtre de terminal, exécutez les commandes suivantes pour créer dans TemplateUser le générateur d'images :

   **[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser** 

   **[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**

1. Passez au TemplateUser compte :

   **[ImageBuilderAdmin]\$1 su - TemplateUser** 

## Étape 3 : créer les paramètres d’application par défaut
<a name="app-settings-image-create-default-app-settings"></a>

Au cours de cette étape, vous créez les paramètres d'application par défaut pour les utilisateurs de vos WorkSpaces applications. Cela permet à vos utilisateurs de démarrer rapidement avec les applications pendant leurs sessions de streaming d' WorkSpaces applications, sans avoir à créer ou à configurer eux-mêmes ces paramètres.

**Pour créer les paramètres d’application par défaut pour vos utilisateurs**

1. Lancez l’application pour laquelle vous souhaitez créer les paramètres par défaut. Par exemple, dans une fenêtre Terminal, exécutez la commande suivante pour lancer le navigateur Chromium :

    **[TemplateUser]\$1 chromium-browser**

1. Configurez les paramètres de l’application. Par exemple, définissez **https://aws.amazon.com** comme page d’accueil du navigateur Chromium.

1. Fermez les applications.

1. Déconnectez-vous :

   **[TemplateUser]\$1 logout** 

## Étape 4 : enregistrer les paramètres d’application par défaut
<a name="app-settings-image-save-default-app-settings"></a>

Au cours de cette étape, vous copiez les paramètres d’application par défaut que vous avez ajoutés dans le répertoire **/etc/skel/** et vous les mettez à la disposition de vos utilisateurs de streaming.

**Pour enregistrer les paramètres d’application par défaut**
+ Exécutez la commande suivante dans une fenêtre Terminal pour copier les paramètres d’application par défaut pour vos utilisateurs de streaming :

   **[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**

## Étape 5 : tester les paramètres d’application par défaut (facultatif)
<a name="app-settings-image-test-applications"></a>

Au cours de cette étape, vérifiez que les applications que vous avez ajoutées s’exécutent correctement et que les paramètres d’application par défaut fonctionnent comme prévu. 

**Pour tester vos applications et vos paramètres par défaut sur une instance Image Builder**

1. Créez un utilisateur test qui ne dispose d’aucune autorisation root. Par exemple, dans une fenêtre **Terminal**, exécutez les commandes suivantes pour créer **test-user** sur l’instance Image Builder :

   **[ImageBuilderAdmin]\$1 sudo useradd -m test-user**

   **[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user** 

1. Basculez vers l’utilisateur test :

   **[ImageBuilderAdmin]\$1 su - test-user**

1. Lancez l’application (par exemple, Chromium) en tant qu’utilisateur test :

   **[test-user]\$1 /usr/bin/chromium-browser** 

1. Vérifiez que les paramètres par défaut sont disponibles pour l'utilisateur de test (par exemple, la page d'accueil de Chromium est https://aws.amazon.com/).

1. Déconnectez-vous :

   **[test-user]\$1 logout**

## Étape 6 : nettoyer
<a name="app-settings-image-finish"></a>

Enfin, la dernière étape consiste à effectuer le nettoyage.

**Pour nettoyer**

1. Supprimer TemplateUser :

   **[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**

   **[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**

1. Supprimer l'utilisateur de test (non obligatoire si vous avez ignoré l'étape 5) :

   **[ImageBuilderAdmin]\$1 sudo killall -u test-user**

   **ImageBuilderAdmin]\$1 sudo userdel -r test-user**

# Création de variables d’environnement par défaut pour vos utilisateurs Linux
<a name="create-default-variables-linux"></a>

Vous pouvez créer des variables d’environnement sur une instance Image Builder Linux. La création de variables d’environnement les rend disponibles sur les instances de streaming créées à partir de cette image. 

**Note**  
Sur les instances de flotte Linux, les variables d'environnement définies à l'aide de l'outil Image Assistant (GUI) et les variables d'environnement système par défaut sont exportées via le script/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh dans vos applications.

**Pour créer des variables d’environnement pour vos utilisateurs**

1. Si le dossier `/etc/profile` n’existe pas, exécutez la commande suivante pour le créer :

   **[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d** 

1. Pour créer un nouveau fichier de script shell (par exemple, my-environment.sh) dans ce dossier, exécutez la commande suivante :

   **[ImageBuilderAdmin]\$1 vim my-environment.sh**

1. Sur la première ligne du fichier de script, ajoutez le contenu suivant : 

   **\$1\$1/bin/sh **

1. Pour chaque ligne suivante, ajoutez une commande **export** pour définir les variables d’environnement de votre image. L’exemple suivant ajoute `$HOME/bin` à la variable `PATH` : 

   **export PATH=”\$1HOME/bin:\$1PATH”**

1. Appuyez sur la touche **Echap** pour revenir en mode commande dans vim, puis exécutez la commande suivante pour enregistrer votre script et quitter vim : 

   **:x**

1. Exécutez la commande suivante pour permettre au script de s’exécuter en tant que programme : 

   **[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**

# Optimisation des performances de lancement de vos applications Linux
<a name="optimize-launch-performance"></a>

Si vous utilisez l’outil graphique Image Assistant, celui-ci optimise automatiquement les performances de lancement de vos applications.

Si vous utilisez l’interface de ligne de commande Image Assistant, suivez les étapes ci-dessous pour optimiser les performances de lancement manuellement. Lorsque vous créez et ajoutez des fichiers au manifeste d’optimisation d’une application, celle-ci se lance plus rapidement lorsqu’elle est démarrée pour la première fois sur une nouvelle instance de flotte. Toutefois, cela augmente également le temps nécessaire pour que les instances de flotte soient mises à la disposition des utilisateurs. Le manifeste d’optimisation est un fichier texte délimité par des lignes pour chaque application.

Vous pouvez créer un fichier manifeste (tel que < *your-app* >-manifest.txt) manuellement ou en suivant les étapes ci-dessous.

**Pour créer un fichier manifeste**

1. Assurez-vous que l’application que vous essayez d’optimiser est lancée et en cours d’exécution.

1. À partir d’un terminal dans l’instance Image Builder Linux, exécutez la commande suivante : 

   **ps -ef \$1 grep <*application-process-name*>**

1. Recherchez le plus petit numéro PID dans la sortie de la dernière étape. Il s’agit du PID du processus parent racine de l’application.

1. Maintenez l’application en cours d’exécution et veillez à utiliser les composants initiaux requis par vos utilisateurs. Vous garantissez ainsi que ces composants sont capturés par le processus d’optimisation. 

1. Créez un fichier script (par exemple, `~/getfilestool.sh`) avec le contenu suivant :

   ```
   #!/bin/bash
   ## usage getfilestool.sh $pid
   lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
   ```

1. Assurez-vous que ce fichier peut être exécuté avec la commande suivante :

   **[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**

1. Exécutez la commande suivante pour capturer tous les fichiers en cours d’exécution à partir du processus parent racine trouvé à l’étape 3, et enregistrez-les dans un fichier manifeste temporaire.

   **[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/<y*our-app*>-manifest.txt **

1. Vérifiez le contenu du manifeste d’optimisation, qui est un fichier texte délimité par des lignes pour chaque application.

Vous pouvez spécifier le manifeste d’optimisation indépendamment pour chaque application en utilisant l’outil d’interface de ligne de commande (CLI) Image Assistant. Pour plus d’informations, consultez [Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux](image-assistant-cli.md).

# Création de scripts de session
<a name="create-session-scripts"></a>

WorkSpaces Les applications fournissent des scripts de session sur instance sur les instances de streaming basées sur Windows et Linux. Pour plus d’informations sur les scripts de session, consultez [Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs d'Amazon WorkSpaces Applications](use-session-scripts.md).

Les scripts de session sont spécifiés dans une image d' WorkSpaces applications. Pour localiser le fichier de configuration des scripts de session sur une instance Linux, accédez à `/opt/appstream/SessionScripts/config.json`. Le code suivant est un exemple de fichier `config.json` qui spécifie un script de démarrage de session nommé « `test-session-start` » et un script de fin de session nommé « `test-session-stop` », ainsi que leurs paramètres d’exécution. Assurez-vous que les scripts référencés dans `config.json` disposent des autorisations d’exécution et qu’un interpréteur de commandes est défini (par exemple, \$1\$1/bin/bash). 

```
{
     "SessionStart": {
          "Executables": [
               {
                    "Context": "system",
                    "Filename": "/opt/appstream/SessionScripts/test-session-start",
                    "Arguments": "arg1",
                    "S3LogEnabled": true
               }
          ],
          "WaitingTime": 30
     },
     "SessionTermination": {
          "Executables": [
               { 
                    "Context": "system",
                    "Filename": "/opt/appstream/SessionScripts/test-session-stop", 
                    "Arguments": "arg2", 
                    "S3LogEnabled": true
               }
          ],
          "WaitingTime": 30
     }
}
```

# Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux
<a name="image-assistant-cli"></a>

Sur un générateur d'images basé sur Linux, vous pouvez utiliser l'outil Image Assistant CLI **AppStreamImageAssistant**pour créer et gérer l'image de vos WorkSpaces applications. L’outil se trouve sous `/usr/local/appstream/image-assistant/AppStreamImageAssistant` avec un lien symbolique à l’adresse `/bin/AppStreamImageAssistant`. Cet outil de CLI pour Linux prend en charge bon nombre des mêmes opérations que l’outil d’interface de ligne de commande Image Assistant pour Windows. Pour plus d’informations sur ces opérations, consultez [Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon](cli-operations-managing-creating-image-image-assistant.md).

# Activation et désactivation de la prise en charge de la webcam
<a name="webcam-support"></a>

WorkSpaces Les applications prennent en charge l'audio-vidéo (AV) en temps réel en redirigeant l'entrée vidéo de la webcam locale vers les sessions de streaming WorkSpaces des applications. Cette fonctionnalité permet à vos utilisateurs d'utiliser leur webcam locale pour des conférences vidéo et audio dans le cadre d'une session de streaming d' WorkSpaces applications. Grâce à l'audiovisuel en temps réel et à la prise en charge du son en temps réel, vos utilisateurs peuvent collaborer en utilisant des applications de visioconférence et d'audioconférence familières sans avoir à quitter leur session de streaming d' WorkSpaces applications.

Pour utiliser cette fonctionnalité, vous devez utiliser une image d' WorkSpaces applications Linux qui utilise un agent d' WorkSpaces applications Linux publié le 21 septembre 2022 ou après cette date.

**Note**  
L'audiovisuel en temps réel n'est pas pris en charge pour les instances stream.standard.small alimentées par Rocky Linux ou Red Hat Enterprise Linux. Les utilisateurs ne voient pas les icônes de caméra et de micro dans la barre d'outils du client. 

La fonctionnalité AV en temps réel est activée par défaut pour les sessions de streaming Linux. Pour configurer les autorisations de webcam pour vos utilisateurs sur une instance Image Builder Linux, créez `/etc/appstream/appstream.conf` et ajoutez le contenu suivant :

**Note**  
Spécifiez **1** pour activer la webcam ou **0** pour la désactiver.

```
[webcam]
permission = 1
```

# Activation et désactivation du mode de synchronisation des fichiers lourds pour les dossiers personnels
<a name="heavy-file-sync"></a>

Vous pouvez activer les options des dossiers d' Amazon Simple Storage Service accueil pour votre organisation. Lorsque vous activez les dossiers de base Amazon S3 pour une pile d' WorkSpaces applications, les utilisateurs de la pile peuvent accéder à un dossier de stockage persistant pendant leurs sessions de streaming d'applications. Aucune conﬁguration supplémentaire n'est requise de la part des utilisateurs pour que ceux-ci puissent accéder à leur dossier de base. Les données stockées par les utilisateurs dans leur dossier de base sont automatiquement sauvegardées dans un compartiment Amazon S3 de votre Compte AWS répertoire et sont mises à la disposition de ces utilisateurs lors des sessions suivantes. Pour de plus amples informations, veuillez consulter [Activez et gérez les dossiers personnels pour les utilisateurs de vos WorkSpaces applications](home-folders.md).

Pour garantir une expérience fluide et remédier à certaines limitations existantes, lorsqu'une synchronisation de fichiers incohérente peut être observée lorsque les utilisateurs enregistrent des fichiers texte volumineux depuis leurs instances de streaming dans leurs dossiers personnels, les administrateurs d' WorkSpaces applications peuvent activer l'option de configuration **heavy\$1sync** si le téléchargement de fichiers volumineux vers Amazon S3 est un scénario utilisateur courant lors de l'utilisation d'applications. WorkSpaces L'activation de cette option peut ajouter de la latence au processus de synchronisation des fichiers du dossier de base, mais l'exhaustivité de toutes les synchronisations avec Amazon S3 est garantie.

Cette fonctionnalité est disponible sur toutes les images Red Hat Enterprise Linux et les images d' WorkSpaces applications Linux qui utilisent un agent d' WorkSpaces applications Linux publié le 12 septembre 2024 ou après cette date.

La fonctionnalité de synchronisation intensive est désactivée par défaut pour les sessions de streaming Red Hat Enterprise Linux et Amazon Linux. Pour configurer des autorisations de synchronisation étendues pour vos utilisateurs sur un générateur d'images Red Hat Enterprise Linux ou Amazon Linux, créez `/etc/appstream/appstream.conf` et ajoutez le contenu suivant :

**Note**  
Spécifiez **1** si vous souhaitez activer la synchronisation intensive ou **0** désactiver la synchronisation intensive.

```
[storage]
heavy_sync = 1
```

# Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée
<a name="tutorial-create-linux-image"></a>

Ce didacticiel explique comment créer une image WorkSpaces Amazon Applications personnalisée basée sur Linux contenant des applications que vous pouvez diffuser à vos utilisateurs.

**Important**  
Ne créez pas d'utilisateur nommé « as2-streaming-user » dans votre générateur d'images. Il s'agit d'un nom d'utilisateur réservé à Fleet. Si vous créez ce nom d'utilisateur en dehors du flux de travail WorkSpaces des applications, vous risquez de rencontrer des problèmes de streaming dans les flottes.

**Topics**
+ [Étape 1 : installer les applications Linux sur l’instance Image Builder](#tutorial-linux-image-install)
+ [Étape 2 : générer un fichier manifeste d’optimisation des applications](#tutorial-linux-image-manifest)
+ [Étape 3 : Création d'un catalogue d' WorkSpaces applications](#tutorial-linux-image-catalog)
+ [Étape 4 : créer les paramètres d’application et les variables d’environnement par défaut](#tutorial-linux-image-create-default-app-settings)
+ [Étape 5 : tester les applications et les paramètres](#tutorial-linux-image-test-applications)
+ [Étape 6 : terminer la création de l’image](#tutorial-linux-image-finish-create-image)
+ [Étape 7 (facultative) : baliser et copier une image](#tutorial-linux-image-tag-copy)
+ [Étape 8 : nettoyer](#tutorial-linux-image-finish)

## Étape 1 : installer les applications Linux sur l’instance Image Builder
<a name="tutorial-linux-image-install"></a>

Au cours de cette étape, vous allez vous connecter à une instance Image Builder Linux et y installer les applications.

**Pour installer des applications sur l’instance Image Builder**

1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes : 
   + [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
   + [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**  
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.

1. Installez les applications nécessaires. Par exemple, pour installer un navigateur Chromium à partir d’un référentiel yum public, ouvrez d’abord l’application Terminal, puis exécutez la commande suivante :

   **[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164** 
**Note**  
Téléchargez et installez uniquement les applications de sites dans lesquels vous avez confiance.

## Étape 2 : générer un fichier manifeste d’optimisation des applications
<a name="tutorial-linux-image-manifest"></a>

Au cours de cette étape, vous allez générer le fichier manifeste de chaque application installée à l’étape 1.

**Pour générer un fichier manifeste destiné à optimiser les performances de lancement d’une application**

1. Assurez-vous que l’application (Chromium, par exemple) à optimiser est lancée et en cours d’exécution.

1. Dans une fenêtre de l’application Terminal, exécutez la commande suivante pour afficher les processus liés à l’application :

   **[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **

1. Recherchez le PID du parent racine dans la sortie de la commande ci-dessus. Dans l’exemple de sortie suivant, le PID du parent racine est 16712 :  
**Example**  

   ```
   [ImageBuilderAdmin]$ ps -ef | grep chromium
   
   ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
   
   ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
   
   ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
   ```

1. Maintenez l’application en cours d’exécution et veillez à utiliser les composants initiaux requis par vos utilisateurs. Vous garantissez ainsi que ces composants sont capturés par le processus d’optimisation. 

1. Créez un fichier de script (`~/getfilestool.sh`, par exemple) avec le contenu suivant :

   ```
   #!/bin/bash
   ## usage getfilestool.sh $pid
   lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
   ```

1. Exécutez la commande suivante pour vérifier que le fichier peut être exécuté :

   **[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh** 

1. Exécutez la commande suivante pour capturer tous les fichiers en cours d’exécution à partir du processus parent racine trouvé à l’étape 3 ci-dessus. Ensuite, enregistrez-les dans un fichier manifeste temporaire :

   **[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **

1. Vérifiez le contenu du manifeste d’optimisation (fichier texte délimité par des lignes pour chaque application).

## Étape 3 : Création d'un catalogue d' WorkSpaces applications
<a name="tutorial-linux-image-catalog"></a>

Au cours de cette étape, vous utilisez l'outil `AppStreamImageAssistant` CLI du générateur d'images pour créer un catalogue d' WorkSpaces applications en spécifiant des applications pour votre image. Pour chaque application que vous prévoyez de diffuser, spécifiez le nom, le nom d’affichage, le fichier exécutable à lancer et l’icône à afficher.

**Pour créer un catalogue d' WorkSpaces applications**

1. Depuis le bureau de l’instance Image Builder, ouvrez l’application **Terminal** à partir du volet latéral ou affichez la grille des applications.

1. Exécutez **AppStreamImageAssistant --help** pour afficher la liste des commandes disponibles. Vous allez utiliser ces commandes pour ajouter des applications et créer une image. 

1. Exécutez la commande suivante pour ajouter une application installée (par exemple, Chromium) à la liste des WorkSpaces applications pour les utilisateurs d'applications :

   ```
   AppStreamImageAssistant add-application \
    --name Chromium \
    --absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
    --display-name Chromium \
    --absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
    --absolute-manifest-path /tmp/chromium-manifest.txt
   ```

   Vous pouvez également exécuter la commande suivante :

   ```
   AppStreamImageAssistant add-application \
    --name="Chromium" \
    --absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
    --display-name="Chromium" \
    --absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
    --absolute-manifest-path="/tmp/chromium-manifest.txt"
   ```

1. Pour ajouter d’autres applications, répétez l’étape 3 pour chacune d’elles.

1. Pour afficher la liste des applications ajoutées au catalogue, ainsi que les métadonnées telles que les chemins d’icônes et les paramètres de lancement, exécutez la commande suivante :

   **AppStreamImageAssistant list-applications**

1. Pour supprimer une application du catalogue, exécutez la commande suivante :

   **AppStreamImageAssistant remove-application –-name *application\$1name***

## Étape 4 : créer les paramètres d’application et les variables d’environnement par défaut
<a name="tutorial-linux-image-create-default-app-settings"></a>

Au cours de cette étape, vous créez les paramètres d'application par défaut et les variables d'environnement pour les utilisateurs de vos WorkSpaces applications. Cela permet à vos utilisateurs de démarrer rapidement avec les applications pendant leurs sessions de streaming d' WorkSpaces applications, sans avoir à créer ou à configurer eux-mêmes ces paramètres.

**Pour créer les paramètres d’application et les variables d’environnement par défaut des utilisateurs**

1. Lancez l’application pour laquelle vous souhaitez créer les paramètres par défaut. Par exemple, dans une fenêtre Terminal, exécutez la commande suivante pour lancer le navigateur Chromium :

    **[ImageBuilderAdmin]\$1 chromium-browser**

1. Configurez les paramètres de l’application. Par exemple, définissez **https://aws.amazon.com** comme page d’accueil du navigateur Chromium.

1. Assurez-vous que l'application Chromium est fermée, puis exécutez les commandes suivantes pour copier la configuration de Chromium dans **/etc/skel** :

   **[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**

   **[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config** 

1. Définissez les variables d’environnement et ajoutez-les au fichier de script. Par exemple, exécutez les commandes suivantes :

   **[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh** 

   **[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh** 

## Étape 5 : tester les applications et les paramètres
<a name="tutorial-linux-image-test-applications"></a>

Au cours de cette étape, vérifiez que les applications ajoutées s’exécutent correctement et que les paramètres d’application et les variables d’environnement par défaut fonctionnent comme prévu. 

**Pour tester vos applications et vos paramètres par défaut sur une instance Image Builder**

1. Créez un utilisateur test qui ne dispose d’aucune autorisation root. Par exemple, dans une fenêtre **Terminal**, exécutez les commandes suivantes pour créer **test-user** sur l’instance Image Builder :

   **[ImageBuilderAdmin]\$1 sudo useradd -m test-user**

   **[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user** 

1. Basculez vers l’utilisateur test :

   **[ImageBuilderAdmin]\$1 su - test-user**

1. Lancez l’application (par exemple, Chromium) en tant qu’utilisateur test :

   **[test-user]\$1 /usr/bin/chromium-browser** 

1. Vérifiez que les paramètres par défaut sont disponibles pour l'utilisateur de test (par exemple, la page d'accueil de Chromium est https://aws.amazon.com/).

1. Vérifiez aussi qu’il a accès aux variables d’environnement. Par exemple, exécutez la commande suivante :

   **[test-user]\$1 echo \$1*FOO***

   La commande doit afficher la sortie ***BAR*** dans l’application Terminal.

1. Exécutez les commandes suivantes pour supprimer l’utilisateur test avant de créer une image à partir de l’instance Image Builder : 

   **\$1 logout test user**

   **[test-user]\$1 logout**

   **\$1 kill test user's running processes**

   **[ImageBuilderAdmin]\$1 sudo killall -u test-user**

   **\$1 delete user**

   **[ImageBuilderAdmin]\$1 sudo userdel -r test-user**

## Étape 6 : terminer la création de l’image
<a name="tutorial-linux-image-finish-create-image"></a>

Au cours de cette étape, vous allez attribuer un nom à l’image et achever sa création. 

**Pour créer l’image**

1. Dans une fenêtre de l’application **Terminal**, exécutez **AppStreamImageAssistant create-image** pour créer une image depuis l’instance Image Builder. Cette image contient les applications que vous avez installées et enregistrées, ainsi que les scripts de session et les paramètres d’application par défaut que vous avez configurés.

   Pour afficher la liste des options disponibles, exécutez **AppStreamImageAssistant create-image --help**. Pour plus d’informations, consultez l’opération **create-image** dans [Créez votre image Amazon WorkSpaces Applications par programmation à l'aide des opérations de la CLI de l'Assistant Image](programmatically-create-image.md).

1. La session à distance se déconnecte au bout de quelques instants. Lorsque le message **Connectivité perdue** s’affiche, fermez l’onglet du navigateur. Pendant la création de l’image, l’instance Image Builder a pour état **Création de l’instantané en cours**. Vous ne pouvez pas vous connecter à l'Image Builder tant que ce processus n'est pas terminé. 

1. Revenez à la console et naviguez jusqu’à **Images**, **Registre d’images**. Vérifiez que la nouvelle image figure dans la liste.

   Pendant la création de l’image, son état dans le registre d’images de la console est **En attente**. Il est impossible de se connecter aux images dont l’état est **En attente**. 

1. Choisissez l’icône **Actualiser** pour mettre à jour l’état. Une fois que votre image est créée, l'état de l'image devient **Available (Disponible)** et l'Image Builder est automatiquement arrêté.

   Pour continuer à créer des images, démarrez l'Image Builder et connectez-vous y à partir de la console, ou créez un nouvel Image Builder.

## Étape 7 (facultative) : baliser et copier une image
<a name="tutorial-linux-image-tag-copy"></a>

Vous pouvez ajouter une ou plusieurs balise(s) à une image pendant ou après sa création. Vous pouvez également copier l’image dans la même région, ou dans une nouvelle région du même compte Amazon Web Services. La copie d'une image source permet d'obtenir une image de destination identique mais distincte. AWS ne copie toutefois aucune balise définie par l'utilisateur. De plus, vous pouvez uniquement copier les images personnalisées que vous créez, pas les images de base fournies par AWS. 

**Note**  
Vous ne pouvez pas copier simultanément plus de deux images vers une destination. Si la destination vers laquelle vous copiez une image atteint la limite d'images, vous recevez une erreur. Dans ce cas, avant de copier l’image, vous devez supprimer des images de la destination. Une fois que le nombre d’images de la région de destination est inférieur au quota (aussi appelé limite) défini, lancez la copie d’image à partir de la région source. Pour plus d’informations, consultez [Quotas du Service Amazon WorkSpaces Applications](limits.md).

**Pour ajouter des balises à une image existante**

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**. 

1. Dans la liste des images, sélectionnez celle à laquelle vous souhaitez ajouter des balises.

1. Choisissez successivement **Balises**, **Ajouter/modifier des balises** et **Ajouter une balise**. Spécifiez la clé et la valeur de la balise, puis choisissez **Enregistrer**.

Pour plus d’informations, consultez [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).

**Pour copier une image**

La copie d'une image entre différentes régions géographiques vous permet de diffuser des applications à partir de plusieurs régions, à partir de la même image. En diffusant vos applications au plus près de vos utilisateurs, vous pouvez améliorer l'expérience de vos utilisateurs en diffusant des applications avec WorkSpaces Applications.

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**. 

1. Dans la liste des images, sélectionnez celle à copier.

1. Choisissez **Actions**, puis **Copier**.

1. Dans la boîte de dialogue **Copier une image**, spécifiez les informations suivantes, puis choisissez **Copier l’image** :
   + Pour **Destination region** (Région de destination), choisissez la région vers laquelle copier la nouvelle image. 
   + Pour **Name** (Nom), spécifiez un nom que l'image aura lorsqu'elle sera copiée dans la destination. 
   + Pour **Description** (facultatif), spécifiez une description que l'image aura lorsqu'elle sera copiée dans la destination. 

1. Pour vérifier la progression de l'opération de copie, revenez dans la console et naviguez jusqu'à **Images**, **Image Registry** (Registre d'images). Utilisez la barre de navigation pour basculer vers la région de destination (le cas échéant) et vérifiez que la nouvelle image s’affiche dans la liste des images.

   La nouvelle image s'affiche d'abord avec un statut **Copying** (En cours de copie) dans le registre d'images de votre console. Lorsque l'image est créée avec succès, l'état de l'image devient **Available**, ce qui signifie que vous pouvez désormais utiliser l'image pour lancer une pile et diffuser vos applications. 

## Étape 8 : nettoyer
<a name="tutorial-linux-image-finish"></a>

Enfin, arrêtez les instances Image Builder en cours d’exécution pour libérer des ressources et éviter l’imputation de frais inutiles à votre compte. Il est recommandé d’arrêter toutes les instances Image Builder en cours d’exécution et non utilisées. Pour plus d'informations, consultez la section [Tarification des WorkSpaces applications](https://aws.amazon.com/appstream2/pricing/).

**Pour arrêter une instance Image Builder en cours d’exécution**

1. Dans le volet de navigation, choisissez **Images**, **Instances Image Builder**, puis sélectionnez l’instance Image Builder en cours d’exécution.

1. Choisissez **Actions**, puis **Arrêter**.

# Didacticiel : Activation de la prise en charge du japonais pour vos images Linux
<a name="enable-japanese-support-linux"></a>

Ce didacticiel explique comment activer la prise en charge du japonais pour une image Linux. Cela permet aux applications présentes sur l’image d’afficher des caractères japonais et aux utilisateurs du streaming d’utiliser la méthode de saisie japonaise dans les sessions de streaming à partir de l’image.

**Topics**
+ [Étape 1 : installer la police et la méthode de saisie japonaises](#tutorial-japanese-font)
+ [Étape 2 : définir le fuseau horaire du système](#tutorial-japanese-zone)
+ [Étape 3 : définir les paramètres régionaux et la langue d’affichage du système](#tutorial-japanese-locale)
+ [Étape 4 : configurer les méthodes de saisie](#tutorial-japanese-input)
+ [Étape 5 : définir la disposition du clavier](#tutorial-japense-keyboard)
+ [Étape 6 : vérifier sur l’instance Image Builder](#tutorial-japense-verify)
+ [Étape 7 : créer l’image](#tutorial-japanese-create)

## Étape 1 : installer la police et la méthode de saisie japonaises
<a name="tutorial-japanese-font"></a>

Au cours de cette étape, vous connectez une instance Image Builder Linux et vous installez les packages de police et de méthode de saisie de votre choix.

**Pour installer la police et la méthode de saisie japonaises**

1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes : 
   + [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
   + [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**  
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.

1. Installez la police et la méthode de saisie dont vous avez besoin. Pour ce faire, ouvrez l’application Terminal, puis exécutez les commandes suivantes :

   **sudo yum install vlgothic-p-fonts.noarch**

   **sudo yum install ibus-kkc.x86\$164**

1. Outre les commandes ci-dessus, pour Rocky Linux et Red Hat Enterprise Linux, exécutez la commande suivante :

   **sudo yum install glibc-langpack-ja**

## Étape 2 : définir le fuseau horaire du système
<a name="tutorial-japanese-zone"></a>

Pour définir le fuseau horaire du système, exécutez la commande suivante :

**sudo timedatectl set-timezone "Asia/Tokyo"**

## Étape 3 : définir les paramètres régionaux et la langue d’affichage du système
<a name="tutorial-japanese-locale"></a>

Pour définir les paramètres régionaux et la langue d’affichage du système, exécutez les commandes suivantes. 

**Pour définir les paramètres régionaux et la langue d’affichage du système**

1. Mettez à jour le fichier `cloud-init config` en exécutant la commande **sudo vim /etc/cloud/cloud.cfg** et remplacez **locale** par **locale: ja\$1JP.utf8**, puis enregistrez et fermez le fichier.

1. Mettez à jour les paramètres système en exécutant **sudo localectl set-locale LANG=ja\$1JP.utf8**.

1. Mettez à jour les paramètres du shell Gnome en exécutant **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.

## Étape 4 : configurer les méthodes de saisie
<a name="tutorial-japanese-input"></a>

Configurez les méthodes de saisie pour l’application que vous souhaitez ajouter à l’image. Pour plus d’informations sur l’installation d’une application, la génération d’un fichier manifeste et la création de paramètres par défaut, consultez [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md). Dans cette étape, nous partons du principe que vous avez déjà installé l’application Firefox, qui se trouve sous `/usr/local/firefox/firefox`.

**Pour configurer les méthodes de saisie**

1. Créez un script en exécutant la commande **sudo vim /usr/local/bin/update-input-method.sh**, puis ajoutez-y le contenu suivant :

   ```
   #!/bin/bash
   
   function start_process()
   {
       command=$1
       process_name=$2
   
       process_count=$(pgrep $process_name -c)
       echo "$(date) current $process_name count: $process_count"
       while [ $process_count -lt 1 ]
       do
           echo "$(date) starting $process_name"
           eval $command
           sleep 1
           process_count=$(pgrep $process_name -c)
       done
       echo "$(date) $process_name started"
   }
   
   start_process "ibus-daemon --xim &" "ibus-daemon"
   start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
   
   gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
   gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['<Control>space']"
   gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['<Shift><Control>space']"
   
   echo "$(date) updated input source and switch shortcut"
   ```

   Dans le script ci-dessus, la première source d’entrée (’ibus’, ’kkc’) est la méthode de saisie par défaut. Vous pouvez modifier la méthode de saisie par défaut en modifiant l’ordre des sources d’entrée. En outre, « Ctrl\$1Espace » et « Maj\$1Ctrl\$1Espace » sont spécifiés comme combinaisons de touches de raccourci pour passer d’une méthode de saisie à l’autre. Vous pouvez définir vos propres combinaisons de touches que vos utilisateurs pourront utiliser pour changer de méthode de saisie pendant les sessions de streaming.

1. Créez le script de lancement de l’application (Firefox) que vous allez ajouter à l’image. Pour ce faire, exécutez la commande**sudo vim /usr/local/bin/firefox-jp.sh**, puis ajoutez le contenu suivant au script :

   ```
   #!/bin/bash
   
   # Gather required environment variables from the GNOME shell session
   while IFS= read -r -d $'\0' env_var; do
       case "$env_var" in
           DBUS_SESSION_BUS_ADDRESS=*|\
           GTK_IM_MODULE=*|\
           QT_IM_MODULE=*|\
           XMODIFIERS=*|\
           XAUTHORITY=*)
               echo "$env_var"
               export "$env_var"
               ;;
       esac
   done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
   
   /usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
   
   /usr/local/firefox/firefox &
   ```

1. Ajoutez l’autorisation d’exécution aux deux scripts en exécutant les commandes suivantes :

   **sudo chmod \$1x /usr/local/bin/update-input-method.sh**

   **sudo chmod \$1x /usr/local/bin/firefox-jp.sh**

1. Si vous avez déjà créé le fichier manifeste d’optimisation pour l’application, exécutez les commandes suivantes pour ajouter le script de lancement de l’application au catalogue d’applications :

   ```
   sudo AppStreamImageAssistant add-application \
   --name firefox \
   --absolute-app-path /usr/local/bin/firefox-jp.sh \
   --display-name firefox \
   --absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
   --absolute-manifest-path /tmp/firefox-manifest.txt
   ```

Vous pouvez également configurer les méthodes de saisie en ajoutant le script update-input-method .sh en tant qu'application distincte au catalogue d'applications pour l'image. Pendant les sessions de streaming, vos utilisateurs peuvent lancer cette application pour activer la saisie en japonais, et passer d’une méthode de saisie à l’autre à l’aide des touches de raccourci spécifiées au cours de la même session.

## Étape 5 : définir la disposition du clavier
<a name="tutorial-japense-keyboard"></a>

Définissez la disposition du clavier pour qu’elle corresponde aux claviers que vos utilisateurs utiliseront pendant les sessions de streaming. Vous pouvez utiliser la commande **localectl list-keymaps** pour répertorier tous les mappages de touches disponibles, et la commande **sudo localectl set-keymap jp106** pour définir le mappage de touches sur le clavier japonais de 106 touches, par exemple.

## Étape 6 : vérifier sur l’instance Image Builder
<a name="tutorial-japense-verify"></a>

Pour vérifier sur l’instance Image Builder, redémarrez d’abord celle-ci en exécutant la commande **sudo shutdown -r now**. Après le redémarrage, reconnectez-vous à l’instance Image Builder et vérifiez que tout fonctionne comme prévu, y compris le fuseau horaire, les paramètres régionaux, la langue et la méthode de saisie.

## Étape 7 : créer l’image
<a name="tutorial-japanese-create"></a>

Créez l’image sur l’instance Image Builder. Pour plus d’informations, consultez [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md). Assurez-vous de créer les paramètres d’application par défaut, y compris les paramètres régionaux que vous venez de configurer. Pour plus d’informations, consultez « Création de paramètres d’application par défaut pour vos utilisateurs » dans [Création d’images basées sur Linux](create-linux-based-images.md).

Toutes les instances de flotte Linux créées à partir de cette image auront les mêmes paramètres régionaux, de fuseau horaire, de langue et de méthode de saisie par défaut que ceux que vous avez configurés pour l’image.