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á.
Solucione problemas de compilações com falha com IA - Pré-visualização
Recurso de pré-visualização
Esse recurso está em versão prévia e está sujeito a alterações.
Quando as compilações do EC2 Image Builder falham, a causa raiz pode ser demorada e complexa de identificar. O recurso de solução de problemas do Image Builder, desenvolvido pelo AWS DevOps Agent, automatiza esse processo com AI-powered análise. Você pode identificar rapidamente a causa de falhas de compilação complexas ou detectar padrões em vários pipelines com falha.
Quando uma compilação falha, você pode usar a Solução de problemas para analisar registros de compilação, CloudWatch registros da Amazon, execuções de etapas do fluxo de trabalho e recursos relacionados AWS . Você recebe uma análise da causa raiz e etapas de remediação para resolver o problema.
Você pode solucionar problemas de uma única compilação de pipeline com falha ou analisar vários pipelines com falha para identificar padrões comuns e causas-raiz compartilhadas.
Conteúdos
Pré-requisitos
Antes de usar o recurso de solução de problemas, certifique-se de que o usuário ou a função do IAM que você usa tenha as seguintes permissões:
-
aidevops:ListAgentSpaces— Necessário para descobrir os espaços disponíveis para agentes. -
aidevops:CreateChat— Necessário para iniciar sessões de solução de problemas. -
aidevops:SendChatMessage— Necessário para enviar mensagens durante a solução de problemas. -
aidevops:CreateAgentSpace— Exigido somente se você quiser que o Image Builder crie um espaço de agente para você. Você pode omitir essa permissão se trouxer seu próprio espaço de agente.
Para obter mais informações sobre as políticas do IAM, consulte Políticas e permissões no IAM.
Configurar a solução de problemas
O recurso de solução de problemas requer um espaço de AWS DevOps agente do agente. Você pode usar um espaço de agente existente ou fazer com que o Image Builder crie um para você:
-
Traga seu próprio espaço de agente — Se você já tem um espaço de agente, o Image Builder o usa para solucionar problemas.
-
Faça com que o Image Builder crie um — Se você não tem um espaço de agente, o Image Builder cria e configura um quando você inicia sua primeira investigação. Essa opção requer a
aidevops:CreateAgentSpacepermissão.
Para iniciar a solução de problemas, escolha o ícone Solução de problemas no Console de gerenciamento da AWS cabeçalho.
nota
Para obter mais informações sobre o AWS DevOps Agente, consulte o Guia do Usuário do AWS DevOps Agente.
Solucionar problemas de uma compilação com falha
Quando a criação de uma imagem falha, você pode iniciar uma AI-powered investigação a partir de vários pontos de entrada no Image Builder Console de gerenciamento da AWS.
Inicie uma investigação de solução de problemas
Use um dos métodos a seguir para iniciar a solução de problemas em uma compilação com falha:
-
Tabela de pipelines — escolha o ícone Solução de problemas ao lado do status de um pipeline com falha na lista de pipelines de imagem.
-
Tabela de imagens de saída — Escolha o ícone Solução de problemas ao lado de uma criação de imagem com falha na lista de imagens de saída.
-
Gaveta de solução de problemas — No Console de gerenciamento da AWS cabeçalho, escolha o ícone Solução de problemas e selecione o pipeline que você deseja investigar.
Durante a investigação
Depois de iniciar a solução de problemas, a Solução de problemas investiga a falha. Você pode acompanhar o progresso em tempo real na gaveta à medida que os registros e os recursos são analisados. A investigação normalmente é concluída em alguns minutos. Você pode continuar trabalhando em outras Console de gerenciamento da AWS áreas enquanto a análise é executada. Quando a investigação for concluída, você receberá:
-
Análise da causa raiz que identifica por que a compilação falhou
-
Etapas de correção para resolver o problema
-
Comandos ou alterações de configuração para corrigir o problema
Depois de analisar os resultados, você pode fornecer feedback sobre a qualidade da resposta. Para executar novamente a análise na mesma compilação com falha, escolha Solucionar problemas novamente.
Solucionar problemas de vários pipelines com falha
Se você tiver vários pipelines com falha, poderá analisá-los juntos para identificar padrões comuns e causas-raiz compartilhadas.
Inicie uma investigação agregada
Use um dos métodos a seguir para solucionar problemas em vários pipelines:
-
Na tabela de pipelines de imagem, selecione vários pipelines com falha e escolha Solucionar problemas selecionados.
-
Abra a gaveta de solução de problemas e escolha Solucionar problemas de tudo para analisar todas as tubulações com falha.
Resultados da análise agregada
Você recebe uma análise agrupada organizada por causa raiz. Para cada grupo, você recebe:
-
Descrição da causa raiz compartilhada
-
Dutos afetados por essa causa raiz
-
Etapas de remediação para o grupo
Após a análise agregada, você pode escolher uma solicitação de detalhamento para investigar um pipeline específico com mais detalhes.
O que o Troubleshoot investiga
Quando você soluciona problemas de uma compilação com falha, a análise abrange as seguintes áreas:
-
Crie registros e CloudWatch registros da Amazon — verifica erros, códigos de saída diferentes de zero, tempos limite e rastreamentos de pilha.
-
Execuções de etapas do fluxo de trabalho — identifica a etapa que falhou e examina seus detalhes.
-
Rede e permissões — analisa as permissões do perfil da instância do IAM, os grupos de segurança, o roteamento de sub-rede, os gateways NAT, os gateways da Internet e os VPC endpoints.
-
Configuração de componentes e receitas — verifica erros de script, dependências ausentes, URLs quebrados e validade básica da AMI.
-
Conectividade de rede — verifica a acessibilidade do agente AWS Systems Manager (Systems Manager), a resolução do DNS e a configuração do proxy.
-
Histórico de compilações — analisa compilações recentes para distinguir falhas persistentes de problemas intermitentes.
Considerações
Observe o seguinte ao usar o recurso Solução de problemas:
-
A solução de problemas realiza uma análise somente para leitura. Seus recursos não são modificados.
-
A solução de problemas tem como escopo as falhas de compilação do Image Builder e a infraestrutura relacionada, como IAM, VPC e Systems Manager Agent.
nota
A IA gera essas respostas. Verifique a análise e as recomendações antes de modificar seus recursos.
Para obter mais informações sobre como solucionar problemas de compilações de pipeline do Image Builder, consulteSolucionar problemas em compilação de pipelines.
