Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisez des composants pour personnaliser votre image Image Builder
Image Builder utilise l'application de gestion des composants AWS Task Orchestrator and Executor (AWSTOE) pour orchestrer des flux de travail complexes. Les composants de création et de test qui fonctionnent avec l' AWSTOE application sont basés sur des documents YAML qui définissent les scripts permettant de personnaliser ou de tester votre image. Pour les images AMI, Image Builder installe les composants et l'application de gestion des AWSTOE composants sur ses instances de build et de test Amazon EC2. Pour les images de conteneur, les composants et l'application de gestion des AWSTOE composants sont installés à l'intérieur du conteneur en cours d'exécution.
Image Builder permet AWSTOE d'effectuer toutes les activités sur instance. Aucune configuration supplémentaire n'est requise pour interagir AWSTOE lorsque vous exécutez des commandes Image Builder ou utilisez la console Image Builder.
Note
Lorsqu'un composant géré par Amazon atteint la fin de sa durée de support, il n'est plus maintenu. Environ quatre semaines avant que cela ne se produise, tous les comptes utilisant le composant reçoivent une notification et une liste des recettes concernées dans leur compte de la part de leur compte AWS Health Dashboard. Pour en savoir plus AWS Health, consultez le guide de AWS Health l'utilisateur.
Étapes du flux de travail pour créer une nouvelle image
Le flux de travail Image Builder pour créer de nouvelles images comprend les deux étapes distinctes suivantes.
-
Étape de création (pré-instantané) — Au cours de la phase de génération, vous apportez des modifications à l'instance de génération Amazon EC2 qui exécute votre image de base, afin de créer la base de référence pour votre nouvelle image. Par exemple, votre recette peut inclure des composants qui installent une application ou modifient les paramètres du pare-feu du système d'exploitation.
Les phases suivantes du document de votre composant s'exécutent au cours de la phase de création :
-
build
-
valider
Une fois cette étape terminée avec succès, Image Builder crée un instantané ou une image conteneur qu'il utilise pour la phase de test et au-delà.
-
-
Phase de test (post-capture instantanée) — Au cours de la phase de test, il existe certaines différences entre les images qui créent des AMI et les images de conteneur. Pour les flux de travail AMI, Image Builder lance une instance EC2 à partir de l'instantané qu'il a créé comme dernière étape de la phase de création. Des tests sont exécutés sur la nouvelle instance pour valider les paramètres et s'assurer que l'instance fonctionne comme prévu. Pour les flux de travail de conteneurs, les tests s'exécutent sur la même instance que celle utilisée pour la création.
La phase suivante du document de votre composant s'exécute pour chaque composant inclus dans la recette lors de la phase de test de création de l'image :
-
test
Cette phase de composant s'applique à la fois aux types de composants de construction et de test. Une fois cette étape terminée avec succès, Image Builder peut créer et distribuer votre image finale à partir de l'instantané ou de l'image du conteneur.
-
Note
Bien que le framework d' AWSTOE application vous permette de définir de nombreuses phases dans un document de composant, Image Builder applique des règles strictes concernant les phases à exécuter et au cours desquelles il les exécute. Pour qu'un composant s'exécute pendant la phase de création de l'image, le document du composant doit définir au moins l'une des phases suivantes : build ouvalidate. Pour qu'un composant soit exécuté pendant la phase de test de l'image, le document du composant doit définir la test phase, et aucune autre phase.
Image Builder exécute les étapes de manière indépendante, le chaînage des références dans les documents des composants ne peut pas dépasser les limites des étapes. Vous ne pouvez pas enchaîner une valeur d'une phase exécutée dans la phase de génération à une phase exécutée dans la phase de test. Vous pouvez toutefois définir des paramètres d'entrée pour la cible prévue et transmettre des valeurs via la ligne de commande. Pour plus d'informations sur la définition des paramètres des composants dans vos recettes Image Builder, consultezTutoriel : Création d'un composant personnalisé avec les paramètres d'entrée d'EC2 Image Builder.
Pour faciliter le dépannage de votre instance de build ou de test, AWSTOE créez un dossier journal contenant le document d'entrée et les fichiers journaux pour suivre ce qui se passe à chaque exécution d'un composant. Si vous avez configuré un compartiment Amazon S3 dans la configuration de votre pipeline, les journaux y sont également écrits. Pour plus d'informations sur les documents YAML et les résultats du journal, consultezUtiliser le cadre de documentation des AWSTOE composants pour les composants personnalisés.
Astuce
Lorsque vous devez suivre de nombreux composants, le balisage vous aide à identifier un composant ou une version spécifique en fonction des balises que vous lui avez attribuées. Pour plus d'informations sur le balisage de vos ressources à l'aide des commandes Image Builder dans le AWS CLI, consultez la Balisage des ressources section de ce guide.
Cette section explique comment répertorier, afficher, créer et importer des composants à l'aide de la console Image Builder ou des commandes du AWS CLI.
Rubriques
