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á.
Use componentes para personalizar sua imagem do Image Builder
O Image Builder usa o aplicativo de gerenciamento de componentes AWS Task Orchestrator and Executor (AWSTOE) para orquestrar fluxos de trabalho complexos. Os componentes de criação e teste que funcionam com o AWSTOE aplicativo são baseados em documentos YAML que definem os scripts para personalizar ou testar sua imagem. Para imagens da AMI, o Image Builder instala componentes e o aplicativo de gerenciamento de AWSTOE componentes em suas instâncias de compilação e teste do Amazon EC2. Para imagens de contêiner, os AWSTOE componentes e o aplicativo de gerenciamento de componentes são instalados dentro do contêiner em execução.
O Image Builder usa AWSTOE para realizar todas as atividades na instância. Não é necessária nenhuma configuração adicional para interagir AWSTOE quando você executa os comandos do Image Builder ou usa o console do Image Builder.
nota
Quando um componente gerenciado pela Amazon chega ao fim de sua vida útil de suporte, ele não é mais mantido. Cerca de quatro semanas antes que isso ocorra, todas as contas que estão usando o componente recebem uma notificação e uma lista das fórmulas afetadas em sua conta AWS Health Dashboard. Para saber mais sobre isso AWS Health, consulte o Guia AWS Health do usuário.
Etapas do fluxo de trabalho para criar uma nova imagem
O fluxo de trabalho do Image Builder para criar novas imagens inclui os dois estágios distintos a seguir.
-
Estágio de criação (pré-snapshot): durante o estágio de criação, você faz alterações na instância de compilação do Amazon EC2 que está executando sua imagem base, para criar a linha de base para sua nova imagem. Por exemplo, sua fórmula pode incluir componentes que instalam uma aplicação ou modificam as configurações do firewall do sistema operacional.
As seguintes fases do documento do componente são executadas durante a fase de construção:
-
build
-
validar
Depois que esse estágio for concluído com êxito, o Image Builder cria um snapshot ou imagem de contêiner que ele usa para o estágio de teste e além.
-
-
Estágio de teste (pós-snapshot): durante o estágio de teste, há algumas diferenças entre imagens que criam AMIs e imagens de contêiner. Para fluxos de trabalho da AMI, o Image Builder inicia uma instância do EC2 com base no snapshot que ele criou como etapa final do estágio de compilação. Os testes são executados na nova instância para validar as configurações e garantir que a instância esteja funcionando conforme o esperado. Para fluxos de trabalho de contêineres, os testes são executados na mesma instância usada para a compilação.
A fase a seguir do documento do componente é executada para cada componente incluído na receita durante o estágio de teste de criação da imagem:
-
teste
Essa fase de componente se aplica aos tipos de componentes de compilação e teste. Depois que esse estágio for concluído com êxito, o Image Builder poderá criar e distribuir sua imagem final a partir do snapshot ou da imagem do contêiner.
-
nota
Embora a estrutura do AWSTOE aplicativo permita definir várias fases em um documento componente, o Image Builder tem regras rígidas sobre quais fases ele é executado e durante quais estágios ele as executa. Para que um componente seja executado durante o estágio de criação da imagem, o documento do componente deve definir pelo menos uma dessas fases: build ouvalidate. Para que um componente seja executado durante o estágio de teste de imagem, o documento do componente deve definir a test fase e não outras fases.
Como o Image Builder executa os estágios de forma independente, o encadeamento de referências em documentos componentes não pode ultrapassar os limites do estágio. Você não pode encadear um valor de uma fase que é executada no estágio de construção para uma fase que é executada no estágio de teste. No entanto, você pode definir parâmetros de entrada para o destino pretendido e transmitir valores por meio da linha de comando. Para obter mais informações sobre como definir parâmetros de componentes em suas fórmulas do Image Builder, consulteTutorial: Crie um componente personalizado com parâmetros de entrada do EC2 Image Builder.
Para ajudar na solução de problemas em sua instância de compilação ou teste, AWSTOE crie uma pasta de log que contém o documento de entrada e os arquivos de log para monitorar o que está acontecendo sempre que um componente é executado. Se você configurou um bucket do Amazon S3 na configuração do pipeline, os registros também são gravados lá. Para obter mais informações sobre documentos YAML e saída de log, consulteUse a estrutura de documentos de AWSTOE componentes para componentes personalizados.
dica
Quando você tem muitos componentes para monitorar, a marcação ajuda a identificar um componente ou versão específica com base nas tags que você atribuiu a ele. Para obter mais informações sobre como marcar seus recursos usando os comandos do Image Builder no AWS CLI, consulte a Marcar recursos seção deste guia.
Esta seção aborda como listar, visualizar, criar e importar componentes usando o console do Image Builder ou os comandos do AWS CLI.
Tópicos
