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.
# Créez des images personnalisées avec Image Builder
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 [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)API 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](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso) correspondant à cette commande dans le manuel 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](start-build-image-pipeline.md) ou[Assistant de pipeline : création d'une image de conteneur](start-build-container-pipeline.md), selon le type d'image que vous souhaitez créer.
1. Ouvrez la console [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder à l'adresse.
1. Choisissez **Image pipelines** dans le volet de navigation.
1. Cochez la case à côté du **nom du pipeline** que vous souhaitez exécuter.
1. 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) AWS CLI . Pour plus d’informations, consultez la référence de la commande *AWS CLI *.
**Exemple : créer 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",
...
}
]
}
```
------
## Annuler 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
```