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. # Configurez Res Ready AMIs Grâce aux Amazon Machine Images (AMI) compatibles RES, vous pouvez préinstaller les dépendances RES pour les instances de bureau virtuel (VDI) sur vos AMI personnalisées. L'utilisation d'AMI compatibles RES améliore les temps de démarrage des instances VDI à l'aide des images préconfigurées. À l'aide d'EC2 Image Builder, vous pouvez créer et enregistrer AMIs vos piles de logiciels en tant que nouvelles. Pour plus d'informations sur Image Builder, consultez le [guide de l'utilisateur d'Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html). Avant de commencer, vous devez [déployer la dernière version de RES](update-the-product.md). **Important** Les versions RES Ready AMIs créées avant RES 2025.06.01 sont incompatibles avec RES 2025.06.01 et toutes les versions suivantes. Lorsque vous mettez à niveau votre environnement RES d'une version antérieure au 01/06/2020 vers la version la plus récente, vous devez reconstruire tous les environnements compatibles RES. AMIs **Topics** + [Préparer un rôle IAM pour accéder à l'environnement RES](#prepare-role) + [Création d'un composant EC2 Image Builder](#image-builder-component) + [Préparez votre recette pour EC2 Image Builder](#prepare-recipe) + [Configuration de l'infrastructure EC2 Image Builder](#configure-ib-infrastructure) + [Configurer le pipeline d'images Image Builder](#image-builder-pipeline) + [Exécuter le pipeline d'images Image Builder](#run-image-pipeline) + [Enregistrez une nouvelle pile logicielle dans RES](#register-res-ready-stack) ## Préparer un rôle IAM pour accéder à l'environnement RES Pour accéder au service d'environnement RES depuis EC2 Image Builder, vous devez créer ou modifier un rôle IAM appelé RES-. EC2 InstanceProfileForImageBuilder Pour plus d'informations sur la configuration d'un rôle IAM à utiliser dans Image Builder, consultez [Gestion des identités et des accès AWS (IAM)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq) dans le guide de l'*utilisateur d'Image Builder*. **Votre rôle nécessite :** + Des relations de confiance incluant le service Amazon EC2. + Amazon S3, ReadOnlyAccess Amazon SSMManaged InstanceCore et politiques. EC2 InstanceProfileForImageBuilder ## Création d'un composant EC2 Image Builder Suivez les instructions pour [créer un composant à l'aide de la console Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html) dans le *guide de l'utilisateur d'Image Builder*. **Entrez les détails de votre composant :** 1. Dans **Type**, choisissez **Build**. 1. Pour le **système d'exploitation Image (OS)**, choisissez Linux ou Windows. 1. Pour **Nom du composant**, entrez un nom significatif tel que**research-and-engineering-studio-vdi-**. 1. Entrez le numéro de version de votre composant et ajoutez éventuellement une description. ``` key : value ``` 1. Pour le **document de définition**, entrez le fichier de définition suivant. Si vous rencontrez des erreurs, le fichier YAML est sensible à l'espace et en est la cause la plus probable. **Important** Dans le fichier de définition, remplacez **latest** l'URI de téléchargement (`- source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz'`) par le numéro de version exact (par exemple,**2025.06**) si la version de votre environnement RES n'est pas la plus récente. ------ #### [ Linux ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-linux description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI. schemaVersion: 1.0 parameters: - GPUFamily: type: string description: GPU family (NONE, NVIDIA, or AMD) default: NONE phases: - name: build steps: - name: PrepareRESBootstrap action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "mkdir -p /root/bootstrap/logs" - "mkdir -p /root/bootstrap/latest" - name: DownloadRESLinuxInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: "s3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz" destination: "/root/bootstrap/res-installation-scripts/res-installation-scripts.tar.gz" - name: RunInstallScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts" - "tar -xf res-installation-scripts.tar.gz" - "cd scripts/virtual-desktop-host/linux" - "/bin/bash install.sh -g {{ GPUFamily }}" - name: RebootAfterInstall action: Reboot onFailure: Abort maxAttempts: 3 inputs: delaySeconds: 0 - name: RunInstallPostRebootScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts/scripts/virtual-desktop-host/linux" - 'sed -i ''/^export AWS_DEFAULT_PROFILE="bootstrap_profile"$/d'' install_post_reboot.sh' - "/bin/bash install_post_reboot.sh -g {{ GPUFamily }}" - name: PreventAL2023FromUninstallingCronie action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "rm -f /tmp/imagebuilder_service/crontab_installed" ``` ------ #### [ Windows ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-windows description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI. schemaVersion: 1.0 phases: - name: build steps: - name: CreateRESBootstrapFolder action: CreateFolder onFailure: Abort maxAttempts: 3 inputs: - path: 'C:\Users\Administrator\RES\Bootstrap' overwrite: true - name: DownloadRESWindowsInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz' destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res-installation-scripts.tar.gz' - name: RunInstallScript action: ExecutePowerShell onFailure: Abort maxAttempts: 3 inputs: commands: - 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}' - 'tar -xf res-installation-scripts.tar.gz' - 'Import-Module .\scripts\virtual-desktop-host\windows\Install.ps1' - 'Install-WindowsEC2Instance -PrebakeAMI' ``` ------ 1. Créez des balises facultatives et choisissez **Créer un composant**. ## Préparez votre recette pour EC2 Image Builder Une recette EC2 Image Builder définit l'image de base à utiliser comme point de départ pour créer une nouvelle image, ainsi que l'ensemble des composants que vous ajoutez pour personnaliser votre image et vérifier que tout fonctionne comme prévu. Vous devez créer ou modifier une recette pour construire l'AMI cible avec les dépendances logicielles RES nécessaires. Pour plus d'informations sur les recettes, voir [Gérer les recettes](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html). RES prend en charge les systèmes d'exploitation d'image suivants : + Amazon Linux 2 (x86 et ARM64) + Amazon Linux 2023 (x86 et ARM64) + RHEL 8 (x86) et 9 (x86) + Rocky Linux 9 (x86) + Ubuntu 22.04.3 (x86) + Ubuntu 24.04.3 (x86) + Windows Server 2019, 2022 (x86) + Windows 10, 11 (x86) **Note** À compter de la version 2026.03, Amazon Linux 2 et RHEL 8 ne sont plus inclus en tant que piles logicielles par défaut. Les piles logicielles personnalisées dotées de ces systèmes d'exploitation peuvent toujours être enregistrées si nécessaire. ------ #### [ Create a new recipe ] 1. Ouvrez la console [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) EC2 Image Builder à l'adresse. 1. Sous **Ressources enregistrées**, choisissez **Image recipes**. 1. Choisissez **Créer une recette d'image**. 1. Entrez un nom unique et un numéro de version. 1. Sélectionnez une image de base prise en charge par RES. 1. Sous **Configuration de l'instance**, installez un agent SSM s'il n'en existe pas un préinstallé. Entrez les informations dans **Données utilisateur** et toute autre donnée utilisateur nécessaire. **Note** Pour plus d'informations sur l'installation d'un agent SSM, voir : [Installation manuelle de l'agent SSM sur les instances EC2 pour Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html). [Installation et désinstallation manuelles de l'agent SSM sur les instances EC2 pour Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html). 1. Pour les recettes basées sur Linux, ajoutez le composant de `aws-cli-version-2-linux` compilation géré par Amazon à la recette. Pour les recettes basées sur Windows, ajoutez le composant de `aws-cli-version-2-windows` génération géré par Amazon à la recette. Les scripts d'installation RES utilisent le AWS CLI pour fournir un accès VDI aux valeurs de configuration des paramètres du cluster DynamoDB. 1. Ajoutez le composant EC2 Image Builder créé pour votre environnement Linux ou Windows. **Important** Vous devez ajouter ces composants dans l'ordre avec le composant de compilation `aws-cli-version-2-linux` (pour Linux) ou ` aws-cli-version-2-windows` (pour Windows) ajouté en premier. ![\[Page des composants montrant les composants de construction ajoutés\]](http://docs.aws.amazon.com/fr_fr/res/latest/ug/images/res-ami-build-components.png) 1. (Recommandé) Ajoutez le composant de `simple-boot-test-` test géré par Amazon pour vérifier que l'AMI peut être lancée. Il s'agit d'une recommandation minimale. Vous pouvez sélectionner d'autres composants de test qui répondent à vos exigences. 1. Complétez les sections facultatives si nécessaire, ajoutez les autres composants souhaités et choisissez **Créer une recette**. ------ #### [ Modify a recipe ] Si vous possédez déjà une recette EC2 Image Builder, vous pouvez l'utiliser en ajoutant les composants suivants : 1. Pour les recettes basées sur Linux, ajoutez le composant de `aws-cli-version-2-linux` compilation géré par Amazon à la recette. Pour les recettes basées sur Windows, ajoutez le composant de `aws-cli-version-2-windows` génération géré par Amazon à la recette. Les scripts d'installation RES utilisent le AWS CLI pour fournir un accès VDI aux valeurs de configuration des paramètres du cluster DynamoDB. 1. Ajoutez le composant EC2 Image Builder créé pour votre environnement Linux ou Windows. **Important** Vous devez ajouter ces composants dans l'ordre avec le composant de compilation `aws-cli-version-2-linux` (pour Linux) ou ` aws-cli-version-2-windows` (pour Windows) ajouté en premier. ![\[Page des composants montrant les composants de construction ajoutés\]](http://docs.aws.amazon.com/fr_fr/res/latest/ug/images/res-ami-build-components.png) 1. Complétez les sections facultatives si nécessaire, ajoutez les autres composants souhaités et choisissez **Créer une recette**. ------ ## Configuration de l'infrastructure EC2 Image Builder Vous pouvez utiliser les configurations d'infrastructure pour spécifier l'infrastructure Amazon EC2 qu'Image Builder utilise pour créer et tester votre image Image Builder. Pour une utilisation avec RES, vous pouvez choisir de créer une nouvelle configuration d'infrastructure ou d'utiliser une configuration existante. + Pour créer une nouvelle configuration d'infrastructure, voir [Création d'une configuration d'infrastructure](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html). + Pour utiliser une configuration d'infrastructure existante, [mettez à jour une configuration d'infrastructure](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html). **Pour configurer votre infrastructure Image Builder :** 1. Pour le **rôle IAM**, entrez le rôle que vous avez configuré précédemment. [Préparer un rôle IAM pour accéder à l'environnement RES](#prepare-role) 1. Pour le **type d'instance**, choisissez un type avec au moins 4 Go de mémoire et compatible avec l'architecture AMI de base que vous avez choisie. Consultez la section [Types d'instances Amazon EC2](https://aws.amazon.com/ec2/instance-types/). 1. Pour les **VPC, les sous-réseaux et les groupes de sécurité,** vous devez autoriser l'accès à Internet pour télécharger des packages logiciels. L'accès doit également être autorisé à la table `cluster-settings` DynamoDB et au compartiment de cluster Amazon S3 de l'environnement RES. ## Configurer le pipeline d'images Image Builder Le pipeline d'images Image Builder assemble l'image de base, les composants pour la création et les tests, la configuration de l'infrastructure et les paramètres de distribution. Pour configurer un pipeline d'images pour qu' AMIsil soit prêt pour RES, vous pouvez choisir de créer un nouveau pipeline ou d'utiliser un pipeline existant. Pour plus d'informations, consultez la section [Création et mise à jour de pipelines d'images AMI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html) dans le *guide de l'utilisateur d'Image Builder*. ------ #### [ Create a new Image Builder pipeline ] 1. Ouvrez la console Image Builder à l'adresse[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder). 1. Dans le volet de navigation, choisissez **Image pipelines**. 1. Choisissez **Créer un pipeline d'images**. 1. Spécifiez les détails de votre pipeline en saisissant un nom unique, une description facultative, un calendrier et une fréquence. 1. Pour **Choisir une recette**, choisissez **Utiliser une recette existante** et sélectionnez la recette créée dans[Préparez votre recette pour EC2 Image Builder](#prepare-recipe). Vérifiez que les détails de votre recette sont corrects. 1. Pour **Définir le processus de création d'image**, choisissez le flux de travail par défaut ou personnalisé selon le cas d'utilisation. Dans la plupart des cas, les flux de travail par défaut sont suffisants. Pour plus d'informations, consultez [Configurer les flux de travail d'imagerie pour votre pipeline EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html). 1. Pour **Définir la configuration de l'infrastructure**, **choisissez Choisir la configuration d'infrastructure existante** et sélectionnez la configuration d'infrastructure créée dans[Configuration de l'infrastructure EC2 Image Builder](#configure-ib-infrastructure). Vérifiez que les détails de votre infrastructure sont corrects. 1. Pour **Définir les paramètres de distribution, choisissez Créer les paramètres** **de distribution à l'aide des paramètres de distribution par défaut du service**. L'image de sortie doit se trouver dans le même environnement RES Région AWS que celui de votre environnement RES. En utilisant les paramètres par défaut du service, l'image sera créée dans la région où Image Builder est utilisé. 1. Passez en revue les détails du pipeline et choisissez **Create pipeline**. ------ #### [ Modify an existing Image Builder pipeline ] 1. Pour utiliser un pipeline existant, modifiez les détails afin d'utiliser la recette créée dans[Préparez votre recette pour EC2 Image Builder](#prepare-recipe). 1. Sélectionnez **Enregistrer les modifications**. ------ ## Exécuter le pipeline d'images Image Builder Pour produire l'image de sortie configurée, vous devez lancer le pipeline d'images. Le processus de création peut prendre jusqu'à une heure selon le nombre de composants contenus dans la recette d'image. **Pour exécuter le pipeline d'images :** 1. Dans **Pipelines d'images**, sélectionnez le pipeline créé dans[Configurer le pipeline d'images Image Builder](#image-builder-pipeline). 1. Dans **Actions**, sélectionnez **Exécuter le pipeline**. ## Enregistrez une nouvelle pile logicielle dans RES 1. Suivez les instructions [Piles de logiciels () AMIs](software-stacks.md) pour enregistrer une pile logicielle. 1. Pour l'**ID AMI**, entrez l'ID AMI de l'image de sortie intégrée[Exécuter le pipeline d'images Image Builder](#run-image-pipeline).