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á.
# Criar 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 Console de gerenciamento da AWS ou AWS CLI. Você também pode usar a ação da [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)API ou executar um pipeline de construção para criar a imagem. Para a solicitação de SDK associada à ação de API, você pode consultar o link [See also](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso) desse comando na *Referência de API do EC2 Image Builder*.
------
#### [ Console de gerenciamento da AWS ]
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 pipeline: criar AMI](start-build-image-pipeline.md) ou [Assistente de pipeline: criar imagem de contêiner](start-build-container-pipeline.md), dependendo do tipo de imagem que deseja criar.
1. Abra o console [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)do EC2 Image Builder em.
1. No painel de navegação, selecione **Pipelines de imagem**.
1. Marque a caixa de seleção ao lado do **nome do pipeline** que você deseja executar.
1. 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** comando no AWS CLI, você deve criar os seguintes recursos, caso eles ainda não existam:
**Recursos necessários**
+ **Fórmula**: você deve especificar exatamente uma fórmula para sua imagem, da seguinte forma:
Fórmula da imagem
Especifica o nome do recurso da Amazon (ARN) para seu recurso de fórmula de imagem com o parâmetro `--image-recipe-arn`.
Fórmula do contêiner
Especifique o ARN do seu recurso de fórmula de contêiner com o parâmetro `--container-recipe-arn`.
+ **Configuração de infraestrutura**: especifique o ARN para seu recurso de configuração de infraestrutura com o parâmetro `--infrastructure-configuration-arn`.
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 ARN do seu recurso de configuração de distribuição com o parâmetro `--distribution-configuration-arn`.
+ **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 repositório ECR que o Amazon Inspector usa para suas verificaçõ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 parâmetro `--tags` para adicionar tags ao 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 o ARN do perfil do IAM que o Image Builder usa para executar suas ações de fluxo de trabalho no parâmetro `--execution-role`.
O exemplo a seguir mostra como criar uma imagem com o comando [create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) da AWS CLI . Para obter mais informações, consulte *Referência de comandos da AWS CLI *.
**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
```