Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Créez des images personnalisées avec Image Builder

Mode de mise au point

Sur cette page

Créez des images personnalisées avec Image Builder - EC2 Image Builder

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.

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.

Vous pouvez créer une nouvelle image Image Builder de différentes manières. Par exemple, vous pouvez utiliser l'une des méthodes suivantes pour créer une image avec le AWS Management Console ou AWS CLI. Vous pouvez également utiliser l'action CreateImageAPI ou exécuter un pipeline de génération pour créer l'image. Pour la demande de SDK associée à l'action d'API, vous pouvez vous référer au lien Voir aussi correspondant à cette commande dans le Guide de référence de l'API EC2 Image Builder.

AWS Management Console

Pour créer une nouvelle image à partir d'un pipeline existant, vous pouvez exécuter le pipeline manuellement, comme suit. Vous pouvez également utiliser l'assistant de pipeline pour créer une nouvelle image à partir de zéro. Voir Assistant de pipeline : création d'une AMI ouAssistant de pipeline : création d'une image de conteneur, selon le type d'image que vous souhaitez créer.

  1. Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.

  2. Choisissez Image pipelines dans le volet de navigation.

  3. Cochez la case à côté du nom du pipeline que vous souhaitez exécuter.

  4. Pour créer l'image, sélectionnez Exécuter le pipeline dans le menu Actions. Cela démarre le pipeline.

Vous pouvez également définir un calendrier pour exécuter votre pipeline ou utiliser Amazon EventBridge pour exécuter votre pipeline en fonction des règles que vous configurez.

AWS CLI

Avant d'exécuter la create-image commande dans le AWS CLI, vous devez créer les ressources suivantes si elles n'existent pas déjà :

Ressources requises
  • Recette — Vous devez spécifier exactement une recette pour votre image, comme suit :

    Recette d'images

    Spécifiez le nom de ressource Amazon (ARN) pour votre ressource de recette d'image à l'aide du --image-recipe-arn paramètre.

    Recette de contenant

    Spécifiez l'ARN de votre ressource de recette de conteneur à l'aide du --container-recipe-arn paramètre.

  • Configuration de l'infrastructure — Spécifiez l'ARN de votre ressource de configuration d'infrastructure à l'aide du --infrastructure-configuration-arn paramètre.

Vous pouvez également spécifier l'une des ressources suivantes dont votre image a besoin :

Ressources et configuration facultatives
  • Configuration de distribution — Par défaut, Image Builder distribue la ressource d'image de sortie à votre compte dans la région où vous exécutez la create-image commande. Pour fournir des destinations ou une configuration supplémentaires pour votre distribution, spécifiez l'ARN de votre ressource de configuration de distribution à l'aide du --distribution-configuration-arn paramètre.

  • Numérisation d'images : pour configurer des instantanés correspondant aux résultats d'Amazon Inspector sur votre instance de test d'image ou de conteneur, utilisez le --image-scanning-configuration paramètre. Pour les images de conteneurs, vous spécifiez également le référentiel ECR qu'Amazon Inspector utilise pour ses scans.

  • Tests d'image : pour supprimer la phase de test Image Builder, utilisez le --image-tests-configuration paramètre. Vous pouvez également définir un délai d'expiration pour sa durée d'exécution.

  • Balises d'image : utilisez le --tags paramètre pour ajouter des balises à votre ressource d'image de sortie.

  • Flux de travail d'images : si vous ne spécifiez aucun flux de création ou de test, Image Builder crée votre image avec son flux de travail d'image par défaut. Pour spécifier les flux de travail que vous avez créés, utilisez le --workflows paramètre.

    Note

    Si vous spécifiez des flux de travail d'image, vous devez également fournir le nom ou l'ARN du rôle IAM qu'Image Builder utilise pour exécuter vos actions de flux de travail dans le --execution-role paramètre.

L'exemple suivant montre comment créer une image à l'aide de la commande create-image AWS CLI . Pour plus d’informations, consultez la référence de la commande AWS CLI .

Exemple : création d'une image de base avec une distribution par défaut

aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux

Sortie :

{ "requestId": "1abcd234-e567-8fa9-0123-4567b890cd12", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0", "name": "simple-recipe-linux", ... } ] }

Pour créer une nouvelle image à partir d'un pipeline existant, vous pouvez exécuter le pipeline manuellement, comme suit. Vous pouvez également utiliser l'assistant de pipeline pour créer une nouvelle image à partir de zéro. Voir Assistant de pipeline : création d'une AMI ouAssistant de pipeline : création d'une image de conteneur, selon le type d'image que vous souhaitez créer.

  1. Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.

  2. Choisissez Image pipelines dans le volet de navigation.

  3. Cochez la case à côté du nom du pipeline que vous souhaitez exécuter.

  4. Pour créer l'image, sélectionnez Exécuter le pipeline dans le menu Actions. Cela démarre le pipeline.

Vous pouvez également définir un calendrier pour exécuter votre pipeline ou utiliser Amazon EventBridge pour exécuter votre pipeline en fonction des règles que vous configurez.

Annulez la création d'image à partir du AWS CLI

Pour annuler une création d'image en cours, utilisez la cancel-image-creation commande suivante :

aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.