View a markdown version of this page

Liste e visualize detalhes da fórmula de contêiner - EC2 Image Builder
Liste as fórmulas de contêiner no consoleListe receitas de contêineres com o AWS CLIVisualizar detalhes da fórmula de contêiner no consoleObtenha detalhes da receita do recipiente com o AWS CLIObtenha detalhes da política de receitas de contêineres com o AWS CLI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Liste e visualize detalhes da fórmula de contêiner

Esta seção descreve as maneiras pelas quais você pode encontrar informações e visualizar detalhes de suas fórmulas de contêiner do EC2 Image Builder.

Liste as fórmulas de contêiner no console

Para ver uma lista das fórmulas de contêiner que foram criadas em sua conta no console do Image Builder, siga estas etapas:

  1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder/.

  2. Escolha Fórmulas de contêiner do painel de navegação. Isso mostra uma lista das fórmulas de contêiner criadas em sua conta.

  3. Para ver detalhes ou criar uma nova versão da fórmula, escolha o link Nome da fórmula. Isso abre a visualização de detalhes da fórmula.

    nota

    (Você também pode selecionar a caixa ao lado de Nome da fórmula, e depois escolher Exibir detalhes.

Liste receitas de contêineres com o AWS CLI

O exemplo a seguir mostra como listar todas as fórmulas de contêiner, usando a AWS CLI.

aws imagebuilder list-container-recipes

O comando retorna um resumo para cada receita de contêiner, mostrado no exemplo de saída a seguir.

{
    "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": {}
        }
    ]
}

Você pode filtrar os resultados por proprietário para controlar quais receitas o comando retorna. Use Self para listar as receitas que você possui ou Shared para listar receitas que outras contas compartilharam com você.

aws imagebuilder list-container-recipes --owner Self

Para limitar o número de resultados que o comando retorna em cada página, use o --max-results parâmetro. Se houver mais resultados disponíveis, a resposta incluirá um nextToken valor que você passa para o próximo comando para recuperar a página seguinte.

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

Visualizar detalhes da fórmula de contêiner no console

Para visualizar detalhes de uma fórmula de contêiner específica com o console do Image Builder, selecione a fórmula de contêiner a ser visualizada e use as etapas descritas em Liste as fórmulas de contêiner no console.

Na página de detalhes da fórmula, você pode fazer o seguinte:

Obtenha detalhes da receita do recipiente com o AWS CLI

O exemplo a seguir mostra como usar um comando CLI imagebuilder para obter os detalhes de uma fórmula de contêiner especificando seu ARN.

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

O comando retorna a receita completa do contêiner, mostrada no exemplo de saída a seguir.

{
    "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"
    }
}

Obtenha detalhes da política de receitas de contêineres com o AWS CLI

Uma política de receitas é uma política baseada em recursos. Ele controla o acesso entre contas à sua receita. Quando você compartilha uma receita por meio de AWS Resource Access Manager (AWS RAM), o Image Builder cria a política automaticamente. Você também pode definir uma política personalizada com o put-container-recipe-policy comando.

O exemplo a seguir mostra como usar um comando CLI imagebuilder para obter os detalhes de uma política da fórmula de contêiner especificando seu ARN. Se nenhuma política for anexada à receita, a resposta estará vazia.

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