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á.

# Tutorial: criar um pipeline de imagens com a AMI de saída por meio do assistente do console do Image Builder
<a name="start-build-image-pipeline"></a>

Esse tutorial explica como criar um pipeline automatizado para criar e manter uma imagem personalizada do EC2 Image Builder usando o assistente de console **Criar pipeline de imagem**. Para ajudá-lo a percorrer as etapas com eficiência, as configurações padrão são usadas, quando disponíveis, e as seções opcionais são ignoradas.

**Topics**
+ [Etapa 1: especificar detalhes do pipeline](#start-build-image-step1)
+ [Etapa 2: Escolher fórmula](#start-build-image-step2)
+ [Etapa 3: Definir a configuração da infraestrutura - opcional](#start-build-image-step3)
+ [Etapa 4: definir as configurações de distribuição - opcional](#start-build-image-step4)
+ [Etapa 5: Revisão](#start-build-image-step5)
+ [Etapa 6: limpar](#start-build-image-cleanup)

## Etapa 1: especificar detalhes do pipeline
<a name="start-build-image-step1"></a>

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

1. Para começar a criar seu pipeline, escolha **Criar pipeline de imagem**.

1. Na seção **Geral**, insira o **nome do seu pipeline** (*obrigatório*).
**dica**  
Por padrão, a coleta de metadados aprimorada está ativada. Para garantir a compatibilidade entre componentes e imagens básicas, deixe ativada.

1. Na seção **Compilar schedule**, você pode manter os padrões para as **opções de schedule**. Observe que a **zona horária** mostrada para o schedule padrão é Horário Universal Coordenado (UTC). Para obter mais informações sobre o horário UTC e encontrar a diferença do seu fuso horário, consulte [‭‬Time Zone Abbreviations, Worldwide List‭](https://www.timeanddate.com/time/zones/) (Abreviações de fuso horário: lista mundial‭).

   Em **Configurações de atualização de dependência**, escolha a opção **Executar pipeline no horário programado se houver a opção de atualizações de dependência**. Essa configuração faz com que seu pipeline verifique se há atualizações antes de iniciar a compilação. Se não houver atualizações, ele ignora a compilação programada do pipeline.
**nota**  
Para garantir que seu pipeline reconheça as atualizações e compilações de dependências conforme o esperado, você deve usar o controle de versionamento semântico (x.x.x) para sua imagem base e seus componentes. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte [Versionamento semântico no Image Builder](ibhow-semantic-versioning.md).

1. Para prosseguir para a próxima etapa, escolha **Avançar**.

## Etapa 2: Escolher fórmula
<a name="start-build-image-step2"></a>

1. O padrão do Image Builder é **Usar a fórmula existente** na seção **Fórmula**. Porém, na primeira vez, escolha a opção **Criar nova fórmula**.

1. Na seção **Tipo de imagem**, escolha a opção **imagem de máquina da Amazon (AMI)** para criar um pipeline de imagem que produzirá e distribuirá uma AMI.

1. Na seção **Geral**, insira as seguintes caixas obrigatórias:
   + **Nome**: o nome da sua fórmula
   + **Versão**: a versão da sua fórmula (use o formato *<major>.<minor>.<patch>*, onde major, minor e patch são valores inteiros). As novas fórmulas geralmente começam com `1.0.0`.

1. Na seção **Imagem de origem**, mantenha os valores padrão para **Selecionar imagem**, **Sistema operacional da imagem** e **Origem da imagem**. Isso resulta em uma lista de Linux AMIs que são gerenciados pela Amazon. Para este tutorial, selecione a `Amazon Linux 2 x86` imagem.

   1. No menu suspenso **Nome da imagem**, escolha uma imagem.

   1. Mantenha o padrão para as **opções de controle de versionamento automático** (**use a versão mais recente disponível do SO**).
**nota**  
Essa configuração garante que seu pipeline use versionamento semântico para a imagem base, para detectar atualizações de dependências para trabalhos programados automaticamente. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte [Versionamento semântico no Image Builder](ibhow-semantic-versioning.md).

1. Na seção **Configuração da instância**, mantenha os valores padrão para o **Systems Manager Agent**. Isso faz com que o Image Builder mantenha o agente do Systems Manager após a conclusão da compilação e dos testes, para incluir o agente do Systems Manager em sua nova imagem.

   Mantenha o campo **Dados do usuário** em branco para este tutorial. Use esta propriedade para fornecer comandos ou um script de comando a executar na inicialização da instância de compilação. No entanto, ele substitui qualquer comando que o Image Builder possa ter adicionado para garantir que o Systems Manager seja instalado. Quando você usá-lo, certifique-se de que o agente do Systems Manager esteja pré-instalado na imagem de base ou que você inclua a instalação nos dados do usuário.

1. Na seção **Componentes**, você pode optar por não adicionar nenhum componente e continuar. Se você quiser adicionar componentes, no painel **Construir componentes**, escolha **Adicionar componentes de construção** e selecione na lista `Amazon managed` de filtros do proprietário do componente. Isso abre um painel de seleção no lado direito da interface do console, onde você pode navegar e filtrar os componentes que estão disponíveis.

   Para este tutorial, escolha um componente que atualize o Linux com as atualizações de segurança mais recentes, da seguinte forma:

   1. Filtre os resultados inserindo a palavra `update` na barra de pesquisa localizada na parte superior do painel.

   1. Marque a caixa de seleção para o componente de compilação `update-linux`.

   1. Mantenha o padrão para as **opções de controle de versão** (**use a versão mais recente disponível**).
**nota**  
Essa configuração garante que seu pipeline use versionamento semântico do componente selecionado, para detectar atualizações de dependências para trabalhos agendados automaticamente. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte [Versionamento semântico no Image Builder](ibhow-semantic-versioning.md).

   1. Escolha **Adicionar à receita** para adicionar o componente à sua receita. Isso fecha o painel de seleção de componentes.

   1. De volta ao painel **Criar componentes**, o componente que você adicionou é exibido.

1. 

**Reordenar componentes (opcional)**

   Se você escolheu mais de um componente para incluir em sua imagem, você pode usar a drag-and-drop ação para reorganizá-los na ordem em que devem ser executados durante o processo de criação.
**nota**  
Os componentes de endurecimento do CIS não seguem as regras padrão de ordenação de componentes nas fórmulas do Image Builder. Os componentes de endurecimento do CIS sempre são executados por último para garantir que os testes de benchmark sejam executados em relação à sua imagem de saída.

   1. Repita as etapas anteriores para adicionar o `update-linux-kernel-5` componente à sua receita.

   1. O componente que você acabou de adicionar tem um parâmetro de entrada para a versão do kernel. Para expandir as configurações das **opções de versionamento** ou **dos parâmetros de entrada**, você pode escolher a seta ao lado do nome da configuração. Para expandir todas as configurações de todos os componentes selecionados, você pode ativar e desativar a opção **Expandir tudo**. Para obter mais informações sobre como usar parâmetros de entrada em seus componentes e configurá-los em suas fórmulas, consulte [Tutorial: criar um componente personalizado com parâmetros de entrada](tutorial-component-parameters.md).

   1. Escolha um dos componentes e arraste-o para cima ou para baixo para alterar a ordem na qual os componentes serão executados.

   1. Para remover o componente `update-linux-kernel-5`, escolha `X` no canto superior direito da caixa do componentes.

      Repita essa etapa para remover quaisquer outros componentes que você possa ter adicionado, deixando somente o `update-linux` componente selecionado.

1. Para prosseguir para a próxima etapa, escolha **Avançar**.

## Etapa 3: Definir a configuração da infraestrutura - opcional
<a name="start-build-image-step3"></a>

O Image Builder inicia instâncias do EC2 em sua conta para personalizar imagens e executar testes de validação. As configurações da infraestrutura especificam os detalhes da infraestrutura para as instâncias que serão executadas na sua Conta da AWS durante o processo de criação.

Na seção **Configuração da infraestrutura**, as **opções de configuração** são padronizadas como `Create infrastructure configuration using service defaults`. Isso cria um perfil do IAM e um perfil de instância associado para as instâncias de compilação e teste do EC2 que são usadas para configurar sua imagem. Para obter mais informações sobre as configurações de infraestrutura, consulte [CreateInfrastructureConfiguration](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateInfrastructureConfiguration.html)na Referência da *API EC2 Image Builder*.

Para este tutorial, estamos usando as configurações padrão.

**nota**  
Para especificar uma sub-rede a ser usada em uma VPC privada, você pode criar sua própria configuração de infraestrutura personalizada ou usar configurações que você já criou.
+ Para prosseguir para a próxima etapa, escolha **Avançar**.

## Etapa 4: definir as configurações de distribuição - opcional
<a name="start-build-image-step4"></a>

As configurações de distribuição incluem o nome da AMI de saída, configurações de região específicas para criptografia, permissões de lançamento e Contas da AWS organizações e unidades organizacionais (OUs) que podem iniciar a AMI de saída e configurações de licença.

Na seção **Configurações de distribuição**, as **opções de configuração** estão padronizadas com `Create distribution settings using service defaults`. Essa opção distribuirá a AMI de saída para a região atual. Para obter mais informações sobre as configurações de distribuição, consulte [Gerenciar as configurações de distribuição do Image Builder](manage-distribution-settings.md).

Para este tutorial, estamos usando as configurações padrão.
+ Para prosseguir para a próxima etapa, escolha **Avançar**.

## Etapa 5: Revisão
<a name="start-build-image-step5"></a>

A seção **Revisar** exibe todas as configurações que você definiu. Para editar informações em qualquer seção, escolha o botão **Editar** localizado no canto superior direito da seção da etapa. Por exemplo, se você quiser alterar o nome do pipeline, escolha o botão **Editar** no canto superior direito da seção **Etapa 1: Detalhes do pipeline**.

1. Depois de revisar suas configurações, escolha **Criar pipeline** para criar seu pipeline.

1. Você pode ver mensagens de sucesso ou falha na parte superior da página, à medida que seus recursos são criados para configurações de distribuição, configuração de infraestrutura, sua nova fórmula e o pipeline. Para ver detalhes de um recurso, incluindo o identificador do recurso, escolha **Exibir detalhes**.

1. Depois de visualizar os detalhes de um recurso, você pode ver detalhes de outros recursos escolhendo o tipo de recurso no painel de navegação. Por exemplo, para ver detalhes do seu novo pipeline, escolha **Pipelines de imagem** no painel de navegação. Se sua compilação for bem-sucedida, seu novo pipeline será exibido na lista **Pipelines de imagem**.

## Etapa 6: limpar
<a name="start-build-image-cleanup"></a>

Seu ambiente Image Builder, assim como sua casa, precisa de manutenção regular para ajudá-lo a encontrar o que precisa e concluir suas tarefas sem bagunça. Certifique-se de limpar regularmente os recursos temporários que você criou para testes. Caso contrário, você pode esquecer esses recursos e, mais tarde, não se lembrar para que eles foram usados. E então, talvez você não possa se livrar deles com segurança.

**dica**  
Para evitar erros de dependência ao excluir recursos, certifique-se de excluir seus recursos na seguinte ordem:  
Pipeline de imagens
Fórmula da imagem
Todos os recursos restantes

Siga estas etapas para limpar os recursos criados neste tutorial:

**Exclua o pipeline**

1. Para ver uma lista dos pipelines de compilação criados em sua conta, escolha **Pipelines de imagem** no painel de navegação.

1. Marque a caixa de seleção ao lado de **‭‬‬Pipeline de ‭nome**‭‬ para selecionar o pipeline que deseja excluir.

1. Na parte superior do painel **Pipelines de imagem**, no menu **Ações**, escolha **Excluir**.

1. Insira `Delete` para confirmar a exclusão e depois escolha **Excluir**.

**Exclua a fórmula**

1. Para ver uma lista das fórmulas criadas em sua conta, escolha **Fórmulas de imagem** no painel de navegação.

1. Marque a caixa de seleção ao lado de ‭**nome da fórmula**‭‬ para selecionar a fórmula que deseja excluir.

1. Na parte superior do painel **Fórmulas de imagens**, no menu **Ações**, escolha **Excluir fórmula**.

1. Insira `Delete` para confirmar a exclusão e depois escolha **Excluir**.

**Excluir uma configuração de infraestrutura**

1. Para ver uma lista das configurações de infraestrutura criadas em sua conta, escolha **Configuração de infraestrutura** no painel de navegação.

1. Marque a caixa de seleção ao lado de **Nome da configuração** para selecionar a configuração de infraestrutura que deseja excluir.

1. Na parte superior do painel **Configurações de infraestrutura**, escolha **Excluir**.

1. Insira `Delete` para confirmar a exclusão e depois escolha **Excluir**.

**Excluir configurações de distribuição**

1. Para ver uma lista das configurações de distribuição criadas em sua conta, escolha **Configurações de distribuição** no painel de navegação.

1. Marque a caixa de seleção ao lado de **Nome da configuração** para selecionar as configurações de distribuição que você criou para este tutorial.

1. Na parte superior do painel **Configurações de distribuição**, escolha **Excluir**.

1. Insira ‭‬`Delete` para confirmar a exclusão e depois escolha **‭‬Excluir‭**‬.

**Excluir a imagem**  
Siga estas etapas para verificar se você excluiu qualquer imagem criada no pipeline do tutorial. Não é provável que este tutorial crie uma imagem, a menos que tenha decorrido tempo suficiente desde a criação do pipeline para que ela seja executada, de acordo com o cronograma de compilação.

1. Para ver uma lista das imagens criadas em sua conta, escolha **Imagens** no painel de navegação.

1. Escolha a **Versão** da imagem que deseja remover. Isso abre a página **Versões de compilação de imagens**.

1. Marque a caixa de seleção ao lado da **Versão** da imagem que você deseja excluir. Você pode selecionar mais de uma versão de imagem de cada vez.

1. Na parte superior do painel **Versões de compilação de imagens**, escolha **Excluir versão**.

1. Insira ‭‬`Delete` para confirmar a exclusão e depois escolha **‭‬Excluir‭**‬.