Configuration de AMI la distribution à l'aide d'un modèle de EC2 lancement

Pour garantir une expérience de lancement cohérente pour votre Image Builder AMI dans les comptes cibles et les régions, vous pouvez spécifier un modèle de EC2 lancement Amazon dans vos paramètres de distribution, en utilisantlaunchTemplateConfigurations. 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 AMI identifiant de la version. Pour plus d'informations sur le lancement d'une EC2 instance à 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

• Lancer une instance Windows à partir d'un modèle de lancement

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 EC2 lancement aux paramètres de AMI distribution depuis la console

Pour fournir un modèle de lancement avec votre sortieAMI, procédez comme suit dans la console :

1. Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.

2. Choisissez Paramètres de distribution dans le volet de navigation. Cela affiche la liste des paramètres de distribution créés sous votre compte.

3. 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.

4. Dans la section Type d'image, choisissez le type de sortie Amazon Machine Image (AMI). Il s’agit du paramètre par défaut.

5. Dans la section Général, entrez le nom de la ressource de paramètres de distribution que vous souhaitez créer (obligatoire).

6. Dans la section Paramètres régionaux, sélectionnez le nom d'un modèle de EC2 lancement dans la liste. S'il n'existe aucun modèle de lancement dans votre compte, choisissez Créer un nouveau modèle de lancement, ce qui ouvre les modèles de lancement dans le EC2tableau de bord.

   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 sortieAMI.

   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.

7. 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 EC2 lancement aux paramètres AMI de distribution à 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 du AWS CLI pour créer et distribuer un Image Builder AMI 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 un Image Builder AMI avec un modèle de lancement, à l'aide du AWS CLI, vous devez créer une JSON structure 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"
   }

2. 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-configurationcommande AWS CLI, entrez les paramètres suivants dans la commande :

   • Entrez le nom de la distribution dans le --name paramètre.

   • Joignez le JSON fichier 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 la file:// notation au début du chemin du JSON fichier.

   • Le chemin du JSON fichier doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. En effet, Windows utilise la barre oblique inverse ( \) pour faire référence au chemin du répertoire, et Linux utilise la barre oblique directe (/).

Vous pouvez également le fournir JSON directement dans la commande, en utilisant le --distributions paramètre.