Répertorier les images et créer des versions

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.

Sur la page Images de la console Image Builder, vous pouvez consulter la liste de toutes les ressources d'image Image Builder que vous possédez, qui sont partagées avec vous et auxquelles vous avez accès. Les résultats de la liste incluent des informations clés sur ces ressources.

Vous pouvez également voir toutes les images de votre compte pour lesquelles des actions de flux de travail sont en attente.

Liste des images

Cette section décrit les différentes manières de répertorier les informations relatives à vos images.

Vous pouvez utiliser l'une des méthodes suivantes pour répertorier les ressources d'image Image Builder auxquelles vous avez accès. Pour l'action de l'API, voir le ListImagesGuide de référence de l'API EC2 Image Builder. Pour la demande de SDK associée, reportez-vous au lien Voir aussi sur la même page.

Répertorier les images dans la console

Pour ouvrir la page de liste des images dans la console, procédez comme suit :

La page Images de la console est divisée en onglets, en fonction de la propriété de l'image ou des actions de flux de travail en attente. Cette section couvre les trois premiers onglets qui affichent les images que vous possédez ou auxquelles vous avez accès.

Répertorier les images avec des AWS CLI commandes

Lorsque vous exécutez la list-images commande dans le AWS CLI, vous pouvez obtenir une liste des images que vous possédez ou auxquelles vous avez accès.

L'exemple de commande suivant montre comment utiliser la list-images commande sans filtre pour répertorier toutes les ressources d'image Image Builder que vous possédez.

Exemple : liste toutes les images

aws imagebuilder list-images

Sortie :

{
	"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
	"imageVersionList": [
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0",
				"platform": "Linux",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		},
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1",
				"name": "image-recipe-win",
				"type": "AMI",
				"version": "1.0.1",
				"platform": "Windows",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		},
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1",
				"name": "image-recipe-macos",
				"type": "AMI",
				"version": "1.1.1",
				"platform": "macOS",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		}
	]
}

Lorsque vous exécutez la list-images commande, vous pouvez appliquer des filtres pour rationaliser les résultats, comme le montre l'exemple suivant. Pour plus d'informations sur le filtrage des résultats, consultez la commande list-images dans la référence des AWS CLI commandes.

Exemple : filtre pour images Linux

aws imagebuilder list-images --filters name="platform",values="Linux"

Sortie :

{
	"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
	"imageVersionList": [
		{
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0",
				"platform": "Linux",
				"owner": "123456789012",
				"dateCreated": "2022-04-28T01:38:23.286Z"
		}
	]
}

Répertorier les images en attente d'action

Lorsque vous utilisez l'action d'WaitForActionétape dans votre flux de travail d'images, le flux de travail est suspendu jusqu'à ce que vous lui envoyiez un signal lui demandant de reprendre le traitement ou d'échouer. Vous pouvez utiliser cette action d'étape si un processus externe doit être exécuté avant de continuer. Vous pouvez ensuite utiliser le SendWorkflowStepAction pour envoyer un signal à l'étape interrompue vers RESUME ouSTOP. Vous pouvez également arrêter ou reprendre votre flux de travail depuis la console.

Les onglets suivants indiquent comment obtenir une liste de toutes les ressources d'image de votre compte avec les étapes du flux de travail actuellement suspendues pour attendre la reprise ou l'arrêt d'un signal. Les onglets couvrent les étapes de la console et la AWS CLI commande.

Vous pouvez également utiliser l'API ou un SDK pour obtenir une liste des étapes du flux de travail en attente d'une action. Pour l'action de l'API, voir le ListWaitingWorkflowStepsGuide de référence de l'API EC2 Image Builder. Pour la demande de SDK associée, reportez-vous au lien Voir aussi sur la même page.

Console

Pour accéder à l'onglet En attente d'action de la console, procédez comme suit :

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

2. Choisissez Images dans le volet de navigation. Cela ouvre la page de liste des images.

3. Sélectionnez l'onglet En attente d'action dans la page de liste.

4. (facultatif) Pour arrêter ou reprendre une étape, cochez la case à côté du nom, puis choisissez Arrêter l'étape ou Reprendre l'étape. Vous pouvez cocher plusieurs cases pour exécuter la même action pour toutes les étapes sélectionnées.

Détails des étapes du flux de travail en attente

Les détails du flux de travail pour l'étape en attente sont les suivants :

• Nom de l'image : nom de la ressource d'image dont l'étape est en attente. Vous pouvez sélectionner le lien du nom pour afficher la page détaillée de cette image.

• Nom de l'étape en attente : nom de l'étape du flux de travail en attente d'une action.

• ID d'exécution de l'étape : identifie de manière unique l'instance d'exécution de l'étape du flux de travail. Vous pouvez sélectionner l'ID lié pour afficher les détails d'exécution de l'étape.

• Début de l'étape : horodatage du début de l'instance d'exécution de l'étape du flux de travail.

• ARN du flux de travail : nom de ressource Amazon (ARN) du flux de travail avec l'étape en attente.

• Actions : action d'étape en état d'attente.

AWS CLI

Lorsque vous exécutez la list-waiting-workflow-steps commande dans le AWS CLI, vous obtenez une liste de toutes les images de votre compte dont les étapes du flux de travail sont en attente d'une action avant de terminer le processus de création d'image.

L'exemple de commande suivant montre comment utiliser la list-waiting-workflow-steps commande pour répertorier toutes les images de votre compte avec les étapes du flux de travail en attente d'une action.

Exemple : répertorier les images de votre compte avec les étapes du flux de travail en attente

aws imagebuilder list-waiting-workflow-steps

Sortie :

Le résultat de cet exemple montre une image du compte avec une étape en attente d'action.

{
    "steps": [
        {
            "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:image/example-image/1.0.0/8",
            "name": "WaitForAction",
            "workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/wait-for-action/1.0.0/1",
            "startTime": "2023-11-21T23:21:23.609Z",
            "action": "WaitForAction"
        }
    ]
}

anchoranchor

• Console
• AWS CLI

Pour accéder à l'onglet En attente d'action de la console, procédez comme suit :

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

2. Choisissez Images dans le volet de navigation. Cela ouvre la page de liste des images.

3. Sélectionnez l'onglet En attente d'action dans la page de liste.

4. (facultatif) Pour arrêter ou reprendre une étape, cochez la case à côté du nom, puis choisissez Arrêter l'étape ou Reprendre l'étape. Vous pouvez cocher plusieurs cases pour exécuter la même action pour toutes les étapes sélectionnées.

Détails des étapes du flux de travail en attente

Les détails du flux de travail pour l'étape en attente sont les suivants :

• Nom de l'image : nom de la ressource d'image dont l'étape est en attente. Vous pouvez sélectionner le lien du nom pour afficher la page détaillée de cette image.

• Nom de l'étape en attente : nom de l'étape du flux de travail en attente d'une action.

• ID d'exécution de l'étape : identifie de manière unique l'instance d'exécution de l'étape du flux de travail. Vous pouvez sélectionner l'ID lié pour afficher les détails d'exécution de l'étape.

• Début de l'étape : horodatage du début de l'instance d'exécution de l'étape du flux de travail.

• ARN du flux de travail : nom de ressource Amazon (ARN) du flux de travail avec l'étape en attente.

• Actions : action d'étape en état d'attente.

Lister les versions de génération d'images

Sur la page des versions de génération d'images de la console Image Builder, vous pouvez consulter la liste des versions de génération et des informations supplémentaires sur une ressource d'image dont vous êtes le propriétaire. Vous pouvez également utiliser des commandes ou des actions avec l'API Image Builder ou AWS CLI pour répertorier les versions de génération d'image. SDKs

Vous pouvez utiliser l'une des méthodes suivantes pour répertorier les versions de génération d'image pour les ressources d'images que vous possédez. Pour l'action de l'API, voir le ListImageBuildVersionsGuide de référence de l'API EC2 Image Builder. Pour la demande de SDK associée, reportez-vous au lien Voir aussi sur la même page.

Console

Détails de la version

La page des versions d'Image build de la console Image Builder contient les informations suivantes :

• Version — Version de génération de la ressource image. Dans la console Image Builder, la version renvoie à une page détaillée de l'image.

• Type : type de sortie distribué par Image Builder lors de la création de cette ressource d'image (une AMI ou une image de conteneur).

• Date de création : date et heure auxquelles Image Builder a créé la version de génération de l'image.

• État de l'image — État actuel de la version créée par l'image. L'état peut être lié à la création ou à la disposition de l'image. Par exemple, pendant le processus de création, vous pouvez voir le statut Building ouDistributing. Pour la disposition de l'image, le statut Deprecated ou peut s'afficherDeleted.

• Raison de l'échec : raison de l'état de l'image. La console Image Builder affiche uniquement la raison de l'échec de la génération (le statut de l'image est égal àFailed).

• Résultats de sécurité : résultats de numérisation d'images agrégés pour la version de génération d'image référencée.

• ARN — Le nom de ressource Amazon (ARN) pour la version référencée de la ressource image.

• Flux de journal : lien vers le détail du flux de journal pour la version de génération de l'image référencée.

Versions de liste

Pour répertorier les versions de génération d'image dans la console Image Builder, effectuez les opérations suivantes :

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

2. Choisissez Images dans le volet de navigation. Par défaut, la liste des images affiche la version actuelle de chacune des images que vous possédez.

3. Pour voir la liste de toutes les versions d'une image, cliquez sur le lien de la version actuelle. Le lien ouvre la page des versions de génération d'image qui répertorie toutes les versions de génération pour une image spécifique.

AWS CLI

Lorsque vous exécutez la list-image-build-versions commande dans le AWS CLI, vous obtenez une liste complète des versions de build pour la ressource d'image spécifiée. Vous devez posséder l'image pour exécuter cette commande.

L'exemple de commande suivant montre comment utiliser la list-image-build-versions commande pour répertorier toutes les versions de compilation pour l'image spécifiée.

Exemple : liste des versions de compilation pour une image spécifique

aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0

Sortie :

La sortie de cet exemple inclut deux versions de génération pour la recette d'image spécifiée.

{
	 "requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01",
	 "imageSummaryList": [
		  {
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0/2",
				"platform": "Linux",
				"osVersion": "Amazon Linux 2",
				"state": {
					 "status": "AVAILABLE"
				},
				"owner": "123456789012",
				"dateCreated": "2023-03-10T01:04:40.609Z",
				"outputResources": {
					 "amis": [
						  {
								"region": "us-west-2",
								"image": "ami-012b3456789012c3d",
								"name": "image-recipe-name 2023-03-10T01-05-12.541Z",
								"description": "First verison of image-recipe-name",
								"accountId": "123456789012"
						  }
					 ]
				},
				"tags": {}
		  },
		  {
				"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1",
				"name": "image-recipe-name",
				"type": "AMI",
				"version": "1.0.0/1",
				"platform": "Linux",
				"osVersion": "Amazon Linux 2",
				"state": {
					 "status": "AVAILABLE"
				},
				"owner": "123456789012",
				"dateCreated": "2023-03-10T00:07:16.384Z",
				"outputResources": {
					 "amis": [
						  {
								"region": "us-west-2",
								"image": "ami-0d1e23456789f0a12",
								"name": "image-recipe-name 2023-03-10T00-07-18.146132Z",
								"description": "First verison of image-recipe-name",
								"accountId": "123456789012"
						  }
					 ]
				},
				"tags": {}
		  }
	 ]
}

Note

Le résultat de la list-image-build-versions commande n'inclut pas les résultats de sécurité ni les flux de journaux pour le moment.

anchoranchor

• Console
• AWS CLI

Détails de la version

La page des versions d'Image build de la console Image Builder contient les informations suivantes :

• Version — Version de génération de la ressource image. Dans la console Image Builder, la version renvoie à une page détaillée de l'image.

• Type : type de sortie distribué par Image Builder lors de la création de cette ressource d'image (une AMI ou une image de conteneur).

• Date de création : date et heure auxquelles Image Builder a créé la version de génération de l'image.

• État de l'image — État actuel de la version créée par l'image. L'état peut être lié à la création ou à la disposition de l'image. Par exemple, pendant le processus de création, vous pouvez voir le statut Building ouDistributing. Pour la disposition de l'image, le statut Deprecated ou peut s'afficherDeleted.

• Raison de l'échec : raison de l'état de l'image. La console Image Builder affiche uniquement la raison de l'échec de la génération (le statut de l'image est égal àFailed).

• Résultats de sécurité : résultats de numérisation d'images agrégés pour la version de génération d'image référencée.

• ARN — Le nom de ressource Amazon (ARN) pour la version référencée de la ressource image.

• Flux de journal : lien vers le détail du flux de journal pour la version de génération de l'image référencée.

Versions de liste

Pour répertorier les versions de génération d'image dans la console Image Builder, effectuez les opérations suivantes :

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

2. Choisissez Images dans le volet de navigation. Par défaut, la liste des images affiche la version actuelle de chacune des images que vous possédez.

3. Pour voir la liste de toutes les versions d'une image, cliquez sur le lien de la version actuelle. Le lien ouvre la page des versions de génération d'image qui répertorie toutes les versions de génération pour une image spécifique.