View a markdown version of this page

Répertorier et afficher les détails des recettes des contenants - EC2 Image Builder
Répertorier les recettes de conteneurs dans la consoleRépertoriez les recettes de contenants avec AWS CLIAfficher les détails des recettes des contenants dans la consoleObtenez des détails sur les recettes des contenants grâce au AWS CLIObtenez les détails de la politique relative aux recettes relatives aux contenants grâce au AWS CLI

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.

Répertorier et afficher les détails des recettes des contenants

Cette section décrit comment vous pouvez trouver des informations et afficher les détails de vos recettes de conteneur EC2 Image Builder.

Répertorier les recettes de conteneurs dans la console

Pour consulter la liste des recettes de conteneurs qui ont été créées sous votre compte dans la console Image Builder, procédez comme suit :

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

  2. Choisissez des recettes de conteneurs dans le volet de navigation. Cela affiche une liste des recettes de conteneurs créées sous votre compte.

  3. Pour afficher les détails ou créer une nouvelle version de recette, cliquez sur le lien Nom de la recette. Cela ouvre la vue détaillée de la recette.

    Note

    Vous pouvez également cocher la case à côté du nom de la recette, puis choisir Afficher les détails.

Répertoriez les recettes de contenants avec AWS CLI

L'exemple suivant montre comment répertorier toutes vos recettes de contenants à l'aide du AWS CLI.

aws imagebuilder list-container-recipes

La commande renvoie un résumé pour chaque recette de contenant, comme indiqué dans l'exemple de sortie suivant.

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "containerRecipeSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.0",
            "name": "my-container-recipe",
            "containerType": "DOCKER",
            "platform": "Linux",
            "owner": "123456789012",
            "dateCreated": "2024-01-15T10:30:00.000Z",
            "tags": {}
        }
    ]
}

Vous pouvez filtrer les résultats par propriétaire pour contrôler les recettes renvoyées par la commande. SelfUtilisez-le pour répertorier les recettes que vous possédez ou Shared pour répertorier les recettes que d'autres comptes ont partagées avec vous.

aws imagebuilder list-container-recipes --owner Self

Pour limiter le nombre de résultats renvoyés par la commande sur chaque page, utilisez le --max-results paramètre. Si d'autres résultats sont disponibles, la réponse inclut une nextToken valeur que vous transmettez à la commande suivante pour récupérer la page suivante.

aws imagebuilder list-container-recipes --max-results 10 --next-token "eyJuZXh0VG9rZW4..."

Afficher les détails des recettes des contenants dans la console

Pour afficher les détails d'une recette de conteneur spécifique à l'aide de la console Image Builder, sélectionnez la recette de conteneur à consulter et suivez les étapes décrites dansRépertorier les recettes de conteneurs dans la console.

Sur la page détaillée de la recette, vous pouvez effectuer les opérations suivantes :

Obtenez des détails sur les recettes des contenants grâce au AWS CLI

L'exemple suivant montre comment utiliser une commande imagebuilder CLI pour obtenir les détails d'une recette de conteneur en spécifiant son ARN.

aws imagebuilder get-container-recipe --container-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2

La commande renvoie la recette complète du conteneur, illustrée dans l'exemple de sortie suivant.

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "containerRecipe": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2",
        "containerType": "DOCKER",
        "name": "my-container-recipe",
        "description": "My Linux Docker container image",
        "platform": "Linux",
        "components": [
            {
                "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.0.0/1"
            }
        ],
        "parentImage": "amazonlinux:latest",
        "dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
        "targetRepository": {
            "service": "ECR",
            "repositoryName": "my-repo"
        },
        "dateCreated": "2024-01-15T10:30:00.000Z",
        "owner": "123456789012"
    }
}

Obtenez les détails de la politique relative aux recettes relatives aux contenants grâce au AWS CLI

Une politique de recette est une politique basée sur les ressources. Il contrôle l'accès de tous les comptes à votre recette. Lorsque vous partagez une recette via AWS Resource Access Manager (AWS RAM), Image Builder crée automatiquement la politique. Vous pouvez également définir une politique personnalisée à l'aide de la put-container-recipe-policy commande.

L'exemple suivant montre comment utiliser une commande imagebuilder CLI pour obtenir les détails d'une politique de recette de conteneur en spécifiant son ARN. Si aucune politique n'est associée à la recette, la réponse est vide.

aws imagebuilder get-container-recipe-policy --container-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2