Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Résoudre les problèmes liés aux builds ayant échoué avec l'IA - Aperçu
Fonction de prévisualisation
Cette fonctionnalité est en version préliminaire et est sujette à modification.
Lorsque les builds d'EC2 Image Builder échouent, la cause première peut être longue et complexe à identifier. La fonctionnalité de résolution des problèmes d'Image Builder, optimisée par AWS DevOps Agent, automatise ce processus grâce AI-powered à l'analyse. Vous pouvez rapidement identifier la cause d'échecs de construction complexes ou détecter des modèles sur plusieurs pipelines défaillants.
Lorsqu'une compilation échoue, vous pouvez utiliser Troubleshoot pour analyser les journaux de génération, les CloudWatch journaux Amazon, les exécutions des étapes du flux de travail et les AWS ressources associées. Vous recevez une analyse de la cause première et des mesures correctives pour résoudre le problème.
Vous pouvez résoudre les problèmes liés à l'échec de la construction d'un seul pipeline ou analyser plusieurs pipelines défaillants pour identifier des modèles communs et des causes profondes communes.
Table des matières
Conditions préalables
Avant d'utiliser la fonctionnalité de résolution des problèmes, assurez-vous que l'utilisateur ou le rôle IAM que vous utilisez dispose des autorisations suivantes :
-
aidevops:ListAgentSpaces— Nécessaire pour découvrir les places d'agent disponibles. -
aidevops:CreateChat— Nécessaire pour démarrer les sessions de dépannage. -
aidevops:SendChatMessage— Nécessaire pour envoyer des messages lors du dépannage. -
aidevops:CreateAgentSpace— Obligatoire uniquement si vous souhaitez qu'Image Builder crée un espace d'agent pour vous. Vous pouvez omettre cette autorisation si vous apportez votre propre espace d'agent.
Pour plus d'informations sur les politiques IAM, consultez la section Politiques et autorisations dans IAM.
Configurer le dépannage
La fonctionnalité de résolution des problèmes nécessite un espace AWS DevOps agent. Vous pouvez utiliser un espace d'agent existant ou demander à Image Builder d'en créer un pour vous :
-
Apportez votre propre espace d'agent — Si vous disposez déjà d'un espace d'agent, Image Builder l'utilise pour résoudre les problèmes.
-
Demandez à Image Builder d'en créer un — Si vous ne disposez pas d'un espace d'agent, Image Builder en crée un et le configure lorsque vous commencez votre première enquête. Cette option nécessite l'
aidevops:CreateAgentSpaceautorisation.
Pour commencer le dépannage, cliquez sur l'icône Résolution des problèmes dans l' Console de gestion AWS en-tête.
Note
Pour plus d'informations sur AWS DevOps l'agent, consultez le guide de l'utilisateur de l'AWS DevOpsagent.
Résoudre les problèmes liés à une compilation qui a échoué
Lorsqu'une création d'image échoue, vous pouvez lancer une AI-powered enquête à partir de plusieurs points d'entrée dans l'Image Builder Console de gestion AWS.
Lancer une enquête de dépannage
Utilisez l'une des méthodes suivantes pour commencer à résoudre les problèmes liés à l'échec de la compilation :
-
Tableau Pipelines : cliquez sur l'icône de dépannage à côté de l'état d'un pipeline défaillant dans la liste Image des pipelines.
-
Tableau des images de sortie — Choisissez l'icône de résolution des problèmes à côté d'une image ayant échoué dans la liste des images de sortie.
-
Tiroir de résolution des problèmes : dans l' Console de gestion AWS en-tête, cliquez sur l'icône de résolution des problèmes, puis sélectionnez le pipeline que vous souhaitez examiner.
Au cours de l'enquête
Une fois que vous avez commencé à résoudre les problèmes, Troubleshoot étudie la panne. Vous pouvez suivre les progrès en temps réel dans le tiroir au fur et à mesure que les journaux et les ressources sont analysés. L'enquête se termine généralement en quelques minutes. Vous pouvez continuer à travailler dans d'autres Console de gestion AWS domaines pendant que l'analyse est en cours. À la fin de l'enquête, vous recevez :
-
Analyse des causes premières qui identifie les raisons de l'échec de la compilation
-
Étapes de correction pour résoudre le problème
-
Commandes ou modifications de configuration pour résoudre le problème
Après avoir examiné les résultats, vous pouvez fournir des commentaires sur la qualité de la réponse. Pour réexécuter l'analyse sur la même version qui a échoué, choisissez à nouveau Résoudre les problèmes.
Résoudre les problèmes liés à plusieurs pipelines défaillants
Si vous avez plusieurs pipelines défaillants, vous pouvez les analyser ensemble pour identifier des modèles communs et des causes profondes communes.
Lancer une enquête globale
Utilisez l'une des méthodes suivantes pour dépanner plusieurs pipelines :
-
Dans le tableau Pipelines d'image, sélectionnez plusieurs pipelines défaillants et choisissez Résoudre les problèmes sélectionnés.
-
Ouvrez le tiroir de dépannage et choisissez Tout résoudre pour analyser tous les pipelines défaillants.
Résultats d'analyse agrégés
Vous recevez une analyse groupée organisée par cause première. Pour chaque groupe, vous obtenez :
-
Description de la cause première partagée
-
Pipelines concernés par cette cause fondamentale
-
Étapes de remédiation pour le groupe
Après l'analyse globale, vous pouvez choisir une invite d'exploration pour étudier plus en détail un pipeline spécifique.
Ce que Troubleshoot étudie
Lorsque vous dépannez une compilation qui a échoué, l'analyse couvre les domaines suivants :
-
Créez des journaux et des CloudWatch journaux Amazon — Vérifie les erreurs, les codes de sortie différents de zéro, les délais d'attente et les traces de pile.
-
Exécutions des étapes du flux de travail : identifie l'étape qui a échoué et examine ses détails.
-
Réseau et autorisations : examine les autorisations des profils d'instance IAM, les groupes de sécurité, le routage des sous-réseaux, les passerelles NAT, les passerelles Internet et les points de terminaison VPC.
-
Configuration des composants et des recettes — Vérifie les erreurs de script, les dépendances manquantes, les URL cassées et la validité de base de l'AMI.
-
Connectivité réseau : vérifie l'accessibilité de l'agent AWS Systems Manager (Systems Manager), la résolution DNS et la configuration du proxy.
-
Historique des versions : passe en revue les versions récentes pour distinguer les défaillances persistantes des problèmes intermittents.
Considérations
Prenez note des points suivants lorsque vous utilisez la fonction de résolution des problèmes :
-
Le dépannage effectue une analyse en lecture seule. Vos ressources ne sont pas modifiées.
-
Le dépannage est limité aux défaillances de génération d'Image Builder et à l'infrastructure associée, telle qu'IAM, VPC et Systems Manager Agent.
Note
L'IA génère ces réponses. Vérifiez l'analyse et les recommandations avant de modifier vos ressources.
Pour plus d'informations sur la résolution des problèmes liés à la génération de pipelines d'Image Builder, consultezRésoudre les problèmes liés aux builds de pipelines.
