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 recursos aprimorados de distribuição de AMI
O Image Builder oferece recursos avançados de distribuição que oferecem flexibilidade e controle sobre como AMIs você é distribuído entre regiões e contas. Esses recursos separam a distribuição do processo de criação, permitindo que você distribua imagens existentes sob demanda, recupere-se de falhas de distribuição com eficiência e implemente estratégias de distribuição controladas em vários estágios por meio de fluxos de trabalho personalizáveis.
Você pode usar recursos aprimorados de distribuição de AMI no Image Builder para realizar atividades de distribuição diretamente sem a necessidade de executar novamente uma criação de imagem completa.
Distribuição desacoplada
A DistributeImage API aceita três tipos de referências de imagem de origem:
-
ID da AMI — Um identificador padrão da AMI (por exemplo,
ami-0abcdef1234567890) -
Parâmetro SSM — Um parâmetro SSM que armazena uma ID de AMI (por exemplo,)
ssm:/my/ami/parameter -
Versão ARN do Image Builder — Uma versão ARN da imagem do Image Builder
Tentativa de distribuição
Se uma distribuição de imagem falhar, use a RetryImage API para tentar novamente a distribuição. Isso reduz o tempo para solucionar a causa da falha, evitando a reconstrução completa da imagem. Use RetryImage depois de resolver a causa subjacente da falha de distribuição.
A RetryImage API aceita uma versão ARN de criação de imagem (por exemplo,arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1). Quando você invoca a API, o Image Builder retoma automaticamente o processo de distribuição a partir do ponto de falha usando a configuração e as configurações originais da distribuição. A RetryImage API pode tentar novamente distribuições que falharam durante a fase de distribuição, a fase de teste ou a fase de integração. Ele funciona AMIs nos seguintes estados: pendente, com falha, excluído ou disponível.
Pré-requisitos
Antes de tentar novamente uma distribuição, verifique o seguinte:
-
Você identificou e resolveu a causa raiz da falha. Revise os registros de distribuição no CloudWatch Logs para obter detalhes do erro.
-
Você tem as permissões do IAM necessárias para tentar criar novamente a imagem.
-
Para falhas de distribuição entre contas, verifique se a conta
EC2ImageBuilderDistributionCrossAccountRolede destino tem aEc2ImageBuilderCrossAccountDistributionAccesspolítica anexada.
Importante: tentar novamente sem corrigir o problema subjacente resultará em falhas repetidas.
Fluxos de trabalho de distribuição
Os fluxos de trabalho de distribuição são um novo tipo de fluxo de trabalho que complementa os fluxos de trabalho de criação e teste, permitindo que você defina e controle o processo de distribuição com etapas sequenciais. Com fluxos de trabalho de distribuição, você pode criar processos de distribuição personalizados que incluem operações de cópia da AMI, wait-for-action pontos de verificação, modificações de atributos de imagem e outras etapas relacionadas à distribuição. Isso fornece controle estruturado sobre como AMIs você é distribuído, com visibilidade em nível de etapas, recursos de distribuição paralela e relatórios granulares de erros.
Para saber mais sobre como criar e personalizar fluxos de trabalho, consulte Gerenciar fluxos de trabalho de imagem.
