Crie imagens personalizadas com o Image Builder

Existem várias maneiras diferentes de criar uma nova imagem do Image Builder. Por exemplo, você pode usar um dos métodos a seguir para criar uma imagem com o AWS Management Console ou AWS CLI. Você também pode usar a CreateImageAPIação ou executar um pipeline de construção para criar a imagem. Para a SDK solicitação associada à API ação, você pode consultar o link Consulte também desse comando na APIReferência do EC2 Image Builder.

AWS Management Console

Para criar uma nova imagem com base em um pipeline existente, você pode executar manualmente o pipeline como segue. Você também pode usar o assistente de pipeline para criar uma nova imagem a partir do zero. Veja Assistente de console: Criar AMI ou Assistente de console: criar imagem de contêiner, dependendo do tipo de imagem que deseja criar.

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

2. No painel de navegação, selecione Pipelines de imagem.

3. Marque a caixa de seleção ao lado do nome do pipeline que você deseja executar.

4. Para criar a imagem, selecione Executar pipeline no menu Ações. Isto inicia o pipeline.

Você também pode especificar um cronograma para executar seu pipeline ou usar EventBridge a Amazon para executar seu pipeline com base nas regras que você configura.

AWS CLI

Antes de executar o create-image comando no AWS CLI, você deve criar os seguintes recursos se eles ainda não existirem:

Recursos necessários do

• Fórmula: você deve especificar exatamente uma fórmula para sua imagem, da seguinte forma:

  Fórmula da imagem

  Especifique o Amazon Resource Name (ARN) para seu recurso de receita de imagem com o --image-recipe-arn parâmetro.

  Fórmula do contêiner

  Especifique o recurso de receita ARN para seu contêiner com o --container-recipe-arn parâmetro.

• Configuração da infraestrutura — Especifique ARN o recurso de configuração da sua infraestrutura com o --infrastructure-configuration-arn parâmetro.

Você também pode especificar qualquer um dos seguintes recursos que sua imagem requer:

Recursos e configuração opcionais

• Configuração de distribuição: por padrão, o Image Builder distribui o recurso de imagem de saída para sua conta na região em que você executa o comando create-image. Para fornecer destinos ou configurações adicionais para sua distribuição, especifique o recurso de configuração ARN para sua distribuição com o --distribution-configuration-arn parâmetro.

• Verificação de imagens: para configurar instantâneos das descobertas do Amazon Inspector em sua instância de teste de imagem ou contêiner, use o parâmetro --image-scanning-configuration. Para imagens de contêineres, você também especifica o ECR repositório que o Amazon Inspector usa para suas digitalizações.

• Testes de imagem: para suprimir o estágio de teste do Image Builder, use o parâmetro --image-tests-configuration. Como alternativa, você pode definir um tempo limite para execução.

• Tags de imagem — Use o --tags parâmetro para adicionar tags ao seu recurso de imagem de saída.

• Fluxos de trabalho de imagem: se você não especificar nenhum fluxo de trabalho de compilação ou teste, o Image Builder criará sua imagem com seu fluxo de trabalho de imagem padrão. Para especificar fluxos de trabalho que você criou, use o parâmetro --workflows.

  nota

  Se você especificar fluxos de trabalho de imagem, também deverá fornecer o nome ou ARN a IAM função que o Image Builder usa para executar suas ações de fluxo de trabalho no --execution-role parâmetro.

O exemplo a seguir mostra como criar uma imagem com o create-image AWS CLI comando. Para obter mais informações, consulte o .AWS CLI Referência de comando.

Exemplo: criar uma imagem básica com distribuição padrão

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

Saída:

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

Cancelar a criação da imagem a partir do AWS CLI

Para cancelar uma compilação de imagem em andamento, use o comando cancel-image-creation da seguinte forma:

aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1