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 suas AMIs são distribuídas entre regiões e contas. Esses recursos separam a distribuição do processo de criação, permitindo que você distribua imagens existentes sob demanda, se recupere 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 os 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 imagens de origem:
-
ID da AMI — Um identificador de AMI padrão (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 de imagem do Image Builder ARN
Tentativa de distribuição
Se a distribuição de uma imagem falhar, use a RetryImage API para tentar a distribuição novamente. Isso reduz o tempo para solucionar a causa da falha, evitando uma 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 construçã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 de distribuição originais. A RetryImage API pode tentar novamente as distribuições que falharam durante a fase de distribuição, fase de teste ou fase de integração. Ele funciona com AMIs nos seguintes estados: pendente, com falha, excluído ou disponível.
Pré-requisitos
Antes de tentar uma distribuição novamente, certifique-se do seguinte:
-
Você identificou e resolveu a causa raiz da falha. Revise os registros de distribuição em CloudWatch Registros para obter detalhes sobre os erros.
-
Você tem as permissões de IAM necessárias para tentar criar novamente a imagem.
-
Para falhas na distribuição entre contas, verifique se a
Ec2ImageBuilderCrossAccountDistributionAccesspolítica está anexadaEC2ImageBuilderDistributionCrossAccountRolena conta de destino.
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, pontos de verificação de espera por ação, modificações de atributos de imagem e outras etapas relacionadas à distribuição. Isso fornece controle estruturado sobre como suas AMIs são distribuídas, com visibilidade em nível de etapa, 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.
