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. # Configuration de la distribution d'AMI avec un modèle de lancement EC2 Spécifier un modèle de lancement d'AMI Pour garantir une expérience de lancement cohérente pour votre AMI Image Builder dans les comptes cibles et les régions, vous pouvez spécifier un modèle de lancement Amazon EC2 dans vos paramètres de distribution, en utilisant. `launchTemplateConfigurations` Lorsqu'ils `launchTemplateConfigurations` sont présents pendant le processus de distribution, Image Builder crée une nouvelle version du modèle de lancement qui inclut tous les paramètres d'origine du modèle et le nouvel ID d'AMI issu de la compilation. Pour plus d'informations sur le lancement d'une instance EC2 à l'aide d'un modèle de lancement, consultez l'un des liens suivants, en fonction de votre système d'exploitation cible. + [Lancer une instance Linux à partir d'un modèle de lancement](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html) + [Lancer une instance Windows à partir d'un modèle de lancement](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html) **Note** Lorsque vous incluez un modèle de lancement pour activer Windows Fast Launch dans votre image, le modèle de lancement doit inclure la balise suivante afin qu'Image Builder puisse activer Windows Fast Launch en votre nom. `CreatedBy: EC2 Image Builder` ## Ajouter un modèle de lancement EC2 aux paramètres de distribution de l'AMI depuis la console Pour fournir un modèle de lancement avec votre AMI de sortie, procédez comme suit dans la console : 1. Ouvrez la console [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder à l'adresse. 1. Choisissez **Paramètres de distribution** dans le volet de navigation. Cela affiche la liste des paramètres de distribution créés sous votre compte. 1. En haut de la page des **paramètres de distribution**, choisissez **Créer des paramètres de distribution**. Cela ouvre la page **Créer des paramètres de distribution**. 1. Dans la section **Type d'image**, choisissez le **type de sortie** **Amazon Machine Image (AMI)**. Il s’agit du paramètre par défaut. 1. Dans la section **Général**, entrez le **nom** de la ressource de paramètres de distribution que vous souhaitez créer (*obligatoire*). 1. Dans la section **Paramètres régionaux**, sélectionnez le nom d'un modèle de lancement EC2 dans la liste. Si votre compte ne contient aucun modèle de lancement, choisissez **Créer un nouveau modèle de lancement**, qui ouvre les **modèles de lancement** dans le tableau de **bord EC2**. Cochez la case **Définir la version par défaut** pour mettre à jour la version par défaut du modèle de lancement vers la nouvelle version créée par Image Builder avec votre AMI de sortie. Pour ajouter un autre modèle de lancement à la région sélectionnée, choisissez **Ajouter une configuration de modèle de lancement**. Pour supprimer un modèle de lancement, choisissez **Supprimer**. 1. Continuez à spécifier les paramètres supplémentaires dont vous avez besoin, puis choisissez **Créer des paramètres** pour créer votre nouvelle ressource de paramètres de distribution. ## Ajoutez un modèle de lancement EC2 aux paramètres de distribution de l'AMI à partir du AWS CLI Cette section décrit comment configurer un fichier de paramètres de distribution avec un modèle de lancement et utiliser la **create-image** commande contenue dans le AWS CLI pour créer et distribuer une AMI Image Builder et une nouvelle version du modèle de lancement qui l'utilise. 1. **Configuration d'un fichier de paramètres de distribution** Avant de créer une AMI Image Builder avec un modèle de lancement AWS CLI, vous devez créer une structure JSON de configuration de distribution qui spécifie les `launchTemplateConfigurations` paramètres. Vous devez spécifier au moins une `launchTemplateConfigurations` entrée dans la région source. Le fichier d'exemple suivant, nommé`create-distribution-config-launch-template.json`, montre quelques scénarios possibles pour la configuration du modèle de lancement dans la région source. ``` { "name": "NewDistributionConfiguration", "description": "This is just a test", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}", "description": "description" }, "launchTemplateConfigurations": [ { "launchTemplateId": "lt-0a1bcde2fgh34567", "accountId": "935302948087", "setDefaultVersion": true }, { "launchTemplateId": "lt-0aaa1bcde2ff3456" }, { "launchTemplateId": "lt-12345678901234567", "accountId": "123456789012" } ] } ], "clientToken": "clientToken1" } ``` 1. **Création des paramètres de distribution** Pour créer une ressource de paramètres de distribution Image Builder à l'aide de la [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)commande AWS CLI, entrez les paramètres suivants dans la commande : + Entrez le nom de la distribution dans le `--name` paramètre. + Joignez le fichier JSON de configuration de distribution que vous avez créé dans le `--cli-input-json` paramètre. ``` aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json ``` **Note** Vous devez inclure l'option `file://` au début du chemin du fichier JSON. Le chemin d'accès du fichier JSON doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. Par exemple, Windows utilise la barre oblique inverse (\$1) pour faire référence au chemin du répertoire, tandis que Linux et macOS utilisent la barre oblique (/). *Vous pouvez également fournir du JSON directement dans la commande, à l'aide du `--distributions` paramètre.*