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

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 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 ID d'AMI issu de la compilation. 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 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 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 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.

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 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"
   }

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 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 (\) 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.