Création d'une nouvelle version d'une recette d'image

Pour créer une nouvelle version de recette imagée, procédez comme suit :

1. En haut de la page des détails de la recette, choisissez Créer une nouvelle version. Cela vous amène à la page Créer une recette d'image.

2. Pour créer la nouvelle version, apportez vos modifications, puis choisissez Créer une recette d'image.

1. Création d'un JSON fichier CLI d'entrée

   Vous pouvez fournir toutes les entrées de la create-image-recipe commande avec des paramètres de commande intégrés. Cependant, la commande qui en résulte peut être assez longue. Pour rationaliser la commande, vous pouvez à la place fournir un JSON fichier contenant tous les paramètres de la recette.

   Note

   La convention de dénomination des valeurs de données du JSON fichier suit le modèle spécifié pour les paramètres de demande API d'action Image Builder. Pour consulter les paramètres de la demande de API commande, consultez la CreateImageRecipecommande dans le document EC2Image Builder API Reference.

   Pour fournir les valeurs de données sous forme de paramètres de ligne de commande, reportez-vous aux noms de paramètres spécifiés dans la référence des AWS CLI commandes.

   Voici un résumé des paramètres spécifiés dans ces exemples :

   • name (chaîne, obligatoire) — Le nom de la recette d'image.

   • description (chaîne) — Description de la recette d'image.

   • parentImage(chaîne, obligatoire) — L'image que la recette d'image utilise comme base pour votre image personnalisée. La valeur peut être l'image de base ARN ou un AMI identifiant.

     Note

     L'exemple Linux utilise un Image BuilderAMI, tandis que l'exemple Windows utilise unARN.

   • semanticVersion<major>(chaîne, obligatoire) — La version sémantique de la recette d'image, exprimée dans le format suivant, avec des valeurs numériques à chaque position pour indiquer une version spécifique :. <minor>. <patch>. Par exemple, une valeur peut être1.0.0. Pour en savoir plus sur le versionnement sémantique des ressources Image Builder, consultez. Versionnage sémantique dans Image Builder

   • components (tableau, obligatoire) — Contient un tableau d'ComponentConfigurationobjets. Au moins un composant de construction doit être spécifié :

     Note

     Image Builder installe les composants dans l'ordre dans lequel vous les avez spécifiés dans la recette. Cependant, les composants CIS de renforcement sont toujours exécutés en dernier pour garantir que les tests de référence s'exécutent par rapport à votre image de sortie.

     • component ARN (chaîne, obligatoire) — Le composantARN.

       Astuce

       Pour utiliser l'un des exemples afin de créer votre propre recette d'image, vous devez le remplacer par ARNs celui correspondant ARNs aux composants que vous utilisez pour votre recette.

     • paramètres (tableau d'objets) — Contient un tableau d'ComponentParameterobjets. Si un paramètre d'entrée est obligatoire, mais qu'aucune valeur par défaut n'est définie dans le composant, vous devez fournir une valeur. Image Builder ne créera pas la version de la recette s'il manque des paramètres requis et si aucune valeur par défaut n'est définie.

       Important

       Les paramètres des composants sont des valeurs en texte brut et sont connectés AWS CloudTrail. Nous vous recommandons d'utiliser AWS Secrets Manager le AWS Systems Manager Parameter Store pour stocker vos secrets. Pour plus d'informations sur Secrets Manager, voir Qu'est-ce que Secrets Manager ? dans le guide de AWS Secrets Manager l'utilisateur. Pour plus d'informations sur AWS Systems Manager Parameter Store, voir AWS Systems Manager Parameter Store dans le guide de AWS Systems Manager l'utilisateur.

       • name (chaîne, obligatoire) — Le nom du paramètre du composant à définir.

       • valeur (tableau de chaînes, obligatoire) — Contient un tableau de chaînes pour définir la valeur du paramètre de composant nommé. Si une valeur par défaut est définie pour le composant et qu'aucune autre valeur n'est fournie, AWSTOE utilise la valeur par défaut.

   • additionalInstanceConfiguration(objet) — Spécifiez des paramètres supplémentaires et lancez des scripts pour vos instances de build.

     • systemsManagerAgent(objet) — Contient les paramètres de l'agent Systems Manager sur votre instance de build.

       • uninstallAfterBuild(Booléen) — Contrôle si l'agent Systems Manager est supprimé de votre image de build finale avant de créer la nouvelle. AMI Si cette option est définie surtrue, l'agent est supprimé de l'image finale. Si l'option est définie surfalse, l'agent est laissé en place afin qu'il soit inclus dans le nouveauAMI. La valeur par défaut est false.

         Note

         Si l'uninstallAfterBuildattribut n'est pas inclus dans le JSON fichier et que les conditions suivantes sont remplies, Image Builder supprime l'agent Systems Manager de l'image finale afin qu'il ne soit pas disponible dans le AMI :

         • Le userDataOverride est vide ou a été omis du JSON fichier.

         • Image Builder a automatiquement installé l'agent Systems Manager sur l'instance de build pour un système d'exploitation sur lequel l'agent n'était pas préinstallé sur l'image de base.

     • userDataOverride(string) — Fournissez des commandes ou un script de commande à exécuter lorsque vous lancez votre instance de build.

       Note

       Les données utilisateur sont toujours codées en base 64. Par exemple, les commandes suivantes sont codées comme IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg== :

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       L'exemple Linux utilise cette valeur codée.

   Linux

   L'image de base (parentImagepropriété) de l'exemple suivant est uneAMI. Lorsque vous utilisez unAMI, vous devez avoir accès à la AMI région source et vous AMI devez vous trouver dans la région source (la même région où Image Builder exécute la commande). Enregistrez le fichier sous create-image-recipe.json et utilisez-le dans la create-image-recipe commande.

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   L'exemple suivant fait référence à la dernière version de l'image de base complète en anglais de Windows Server 2016. ARNDans cet exemple, la dernière image du est SKU référencée sur la base des filtres de version sémantiques que vous avez spécifiés :arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x.

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   Note

   Pour en savoir plus sur le versionnement sémantique des ressources Image Builder, consultez. Versionnage sémantique dans Image Builder

2. Créez la recette

   Utilisez la commande suivante pour créer la recette. Indiquez le nom du JSON fichier que vous avez créé à l'étape précédente dans le --cli-input-json paramètre :

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.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 (/).

1. Dans la section Sélectionner une image pour l'image de base, sélectionnez l'option Importer l'image de base.

2. Choisissez le système d'exploitation des images (OS) et la version du système d'exploitation comme vous le feriez normalement.

1. Source : il peut s'agir d'un compartiment S3 ou d'un EBS instantané.

2. Sélectionnez l'emplacement S3 du disque : entrez l'emplacement dans Amazon S3 où vos images de disque sont stockées. Pour rechercher l'emplacement, choisissez Parcourir S3.

3. Pour ajouter un conteneur de disques, choisissez Ajouter un conteneur de disques.

Général

1. Spécifiez un nom unique pour l'image de base. Si vous n'entrez aucune valeur, l'image de base hérite du nom de la recette.

2. Spécifiez une version pour l'image de base. Utilisez le format suivant : <major>.<minor>.<patch>. Si vous n'entrez aucune valeur, l'image de base hérite de la version de la recette.

3. Vous pouvez également saisir une description pour l'image de base.