Création d'une nouvelle version d'une recette de conteneur

Pour créer une nouvelle version de recette de conteneur :

1. Sur la page des détails de la recette du conteneur, choisissez Créer une nouvelle version en haut de la page. La console ouvre la page Créer une recette pour les recettes de conteneurs.

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

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

   Vous pouvez fournir toutes les entrées de la create-container-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 plutôt fournir un fichier JSON contenant tous les paramètres des recettes du conteneur

   Note

   La convention de dénomination des valeurs de données dans le fichier JSON suit le modèle spécifié pour les paramètres de demande d'opération de l'API Image Builder. Pour consulter les paramètres de demande d'opération d'API, consultez la CreateContainerRecipecommande dans le manuel de référence de l'API EC2 Image Builder.

   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 de cet exemple :

   • composants (tableau d'objets, facultatif) — Contient un tableau d'ComponentConfigurationobjets. Les composants sont facultatifs pour les recettes en contenant. Vous pouvez personnaliser l'image de sortie avec des composants BUILD, avec des instructions dans votre modèle Dockerfile (par exemple, RUN ou COPY des instructions), ou les deux. Les composants TEST valident l'image mais ne la modifient pas.

     Note

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

     • componentArn (string, obligatoire) — L'ARN du composant.

       Astuce

       Pour utiliser cet exemple afin de créer votre propre recette de conteneur, remplacez les ARN d'exemple par les ARN des composants que vous utilisez pour votre recette,. Il s'agit Région AWS notamment du nom et du numéro de version de chacun.

     • 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) — 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.

   • containerType (chaîne, obligatoire) — Type de conteneur à créer. Les valeurs valides incluentDOCKER.

   • dockerfile TemplateData (string) — Le modèle Dockerfile intégré pour créer votre image. Les données en ligne sont limitées à 16 000 caractères. Vous devez spécifier dockerfileTemplateData ou dockerfileTemplateUri, mais pas les deux.

     Votre modèle Dockerfile peut inclure des variables contextuelles (espaces réservés qu'Image Builder remplace par des informations de build lors de l'exécution). Incluez au moins la parentImage variable. Si votre recette inclut des composants, incluez également la environments variable et la components variable.

     ParentImage (obligatoire)

     Au moment de la création, cette variable devient l'image de base de votre recette.

     Exemple :

     FROM
     {{{ imagebuilder:parentImage }}}

     environnements (obligatoire si des composants sont spécifiés)

     Au moment de la création, cette variable correspond aux directives Dockerfile qui placent vos composants dans le contexte de construction. Ces directives copient les scripts des composants dans l'image et définissent les variables d'environnement utilisées par ces scripts. Il prépare l'environnement mais n'exécute pas les composants que vous spécifiez. Placez cette variable avant la components variable.

     Exemple :

     {{{ imagebuilder:environments }}}

     composants (facultatif)

     Au moment de la génération, cette variable est convertie en commande qui exécute les scripts des composants de génération et de test pour les composants inclus dans la recette du conteneur, puis supprime ces scripts de l'image. Il s'agit de la variable qui exécute vos composants. Placez-le après la environments variable.

     Exemple :

     {{{ imagebuilder:components }}}

     Pour stocker le modèle dans Amazon S3 à la place, utilisez le TemplateUri paramètre dockerfile avec un URI Amazon S3 valide (par exemple,s3://my-bucket/templates/Dockerfile).

   • name (chaîne, obligatoire) — Le nom de la recette du conteneur.

   • description (chaîne) — Description de la recette du conteneur.

   • parentImage (chaîne, obligatoire) — L'image du Docker conteneur à utiliser dans la recette du conteneur comme référence pour votre image personnalisée.

     • Images publiques hébergées sur DockerHub

     • Images de conteneurs existantes dans Amazon ECR

     • Amazon-managed images de conteneurs

   • PlatforMoverride (chaîne) — Spécifie la plate-forme du système d'exploitation lorsque vous utilisez une image de base personnalisée. Nous vous recommandons de définir cette valeur lorsque vous utilisez une image Docker Hub ou une image Amazon ECR. Si vous l'omettez, Image Builder tente de détecter la plate-forme à partir du manifeste du conteneur, qui n'est peut-être pas toujours disponible. Vous ne pouvez pas spécifier platformOverride quand votre image parent est un ARN d'image Image Builder. Les valeurs valides sont Linux et Windows. Les recettes de conteneurs ne sont pas compatibles avec la plateforme macOS.

   • SemanticVersion <major>(chaîne, obligatoire) — La version sémantique de la recette de conteneur spécifiée au format suivant, avec des valeurs numériques à chaque position pour indiquer une version spécifique :. <minor>. <patch>. Un exemple serait 1.0.0. Pour en savoir plus sur le versionnement sémantique des ressources Image Builder, consultez. Versionnage sémantique dans Image Builder

   • tags (string map) — Tags attachés à la recette du conteneur.

   • InstanceConfiguration (object) — Groupe d'options qui peuvent être utilisées pour configurer une instance afin de créer et de tester des images de conteneurs.

     • image (string) — L'image de base pour une instance de construction et de test de conteneur. Il peut contenir un ID AMI ou spécifier un paramètre de magasin de paramètres AWS Systems Manager (SSM), préfixé parssm:, suivi du nom du paramètre ou de l'ARN. Si vous utilisez un paramètre SSM, la valeur du paramètre doit contenir un ID d'AMI. Si vous ne spécifiez pas d'image de base, Image Builder utilise l'AMI optimisée Amazon ECS appropriée comme image de base.

     • block DeviceMappings (tableau d'objets) : définit les périphériques de type bloc à associer pour créer une instance à partir de l'AMI Image Builder spécifiée dans le image paramètre.

       • DeviceName (chaîne) — Le périphérique auquel ces mappages s'appliquent.

       • ebs (object) — Utilisé pour gérer la configuration spécifique d'Amazon EBS pour ce mappage.

         • delete OnTermination (booléen) — Utilisé pour configurer la suppression à la fin de l'appareil associé.

         • crypté (booléen) — Utilisé pour configurer le chiffrement de l'appareil.

         • VolumeSize (entier) — Utilisé pour remplacer la taille du volume de l'appareil.

         • VolumeType (string) — Utilisé pour remplacer le type de volume du périphérique.

   • TargetRepository (objet, obligatoire) — Le référentiel de destination pour l'image du conteneur si aucun autre référentiel n'est spécifié dans la configuration de distribution de votre pipeline pour la région où le pipeline s'exécute (région 1).

     • RepositoryName (chaîne, obligatoire) — Nom du référentiel de conteneurs dans lequel l'image de conteneur de sortie est stockée. Ce nom est doté du préfixe de l'emplacement du référentiel.

     • service (chaîne, obligatoire) — Spécifie le service de référentiel qui stocke l'image de sortie. La valeur valide est ECR. Le référentiel cible doit déjà exister.

   • WorkingDirectory (string) — Le répertoire de travail à utiliser lors des workflows de génération et de test.

   L'exemple suivant montre un fichier d'entrée de recette de conteneur complet qui définit un Docker conteneur Linux avec des composants de build. Enregistrez-le sous create-container-recipe.json et utilisez-le dans la create-container-recipe commande.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890abcdef1",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. Créez la recette

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

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

   L'exemple de sortie suivant montre l'ARN de la recette de conteneur nouvellement créée, ainsi que l'ID de demande et le jeton client pour la demande.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2"
   }