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

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

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

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 en ligne. 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 de recette du conteneur

   Note

   La convention de dénomination des valeurs de données du fichier JSON suit le modèle spécifié pour les paramètres de demande d'opération de l'API Image Builder. Pour passer en revue les paramètres de demande de fonctionnement de l'API, consultez la CreateContainerRecipe commande dans le document 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 :

   • components (tableau d'objets, facultatif) — Contient un tableau d'ComponentConfigurationobjets. Les composants sont facultatifs pour les recettes de contenants. Vous pouvez personnaliser l'image de sortie avec les 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 que vous avez indiqué dans la recette. Cependant, les composants de renforcement CIS 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.

     • componentArn (chaîne, obligatoire) — L'ARN du composant.

       Astuce

       Pour utiliser l'exemple afin de créer votre propre recette de contenant, remplacez les exemples d'ARN 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 ou 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 le stockage des AWS Systems Manager paramètres, consultez la section AWS Systems Manager Parameter Store dans le Guide de AWS Systems Manager l'utilisateur.

       • name (chaîne, obligatoire) — Nom du paramètre de 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 en ligne 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 génération lors de l'exécution). Incluez au moins la parentImage variable. Si votre recette comprend des composants, incluez également la environments variable et la components variable.

     Image du parent (obligatoire)

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

     Exemple :

     FROM
     {{{ imagebuilder:parentImage }}}

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

     Au moment de la génération, cette variable est résolue en fonction des directives Dockerfile qui placent vos composants dans le contexte de génération. Ces directives copient les scripts des composants dans l'image et définissent les variables d'environnement que ces scripts utilisent. 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 (en option)

     Au moment de la génération, cette variable correspond à la commande qui exécute les scripts de génération et de test des composants 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, utilisez plutôt 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 contenant.

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

   • 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 parente est un ARN d'image Image Builder. Les valeurs valides sont Linux et Windows. Les recettes de conteneurs ne sont pas compatibles avec la plate-forme macOS.

   • <major>SemanticVersion (chaîne, obligatoire) — La version sémantique de la recette de conteneur spécifiée dans le 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 la gestion sémantique des versions pour les ressources Image Builder, consultez. Versionnage sémantique dans Image Builder

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

   • InstanceConfiguration (objet) : 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 d'une instance de création et de test de conteneur. Il peut contenir un ID AMI ou spécifier un paramètre AWS Systems Manager (SSM) Parameter Store, 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 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) — L'appareil 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 lors de la fermeture de l'appareil associé.

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

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

         • VolumeType (chaîne) — Utilisé pour remplacer le type de volume de l'appareil.

   • TargetRepository (object, obligatoire) — Le référentiel de destination pour l'image du conteneur s'il n'y a aucun autre référentiel 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 en 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 (chaîne) — Le répertoire de travail à utiliser lors des flux de travail 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 construction. 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. Entrez 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"
   }