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 échoués grâce à 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, l'identification de la cause première peut être longue et complexe. La fonctionnalité de résolution des problèmes d'Image Builder, développée par AWS DevOps Agent, automatise ce processus grâce AI-powered à l'analyse. Vous pouvez rapidement identifier la cause des défaillances de génération complexes ou détecter des modèles dans plusieurs pipelines défaillants.
Lorsqu'une compilation échoue, vous pouvez utiliser Troubleshoot pour analyser les journaux de compilation, les CloudWatch journaux Amazon, les exécutions des étapes du flux de travail et les AWS ressources associées. Vous recevez une analyse des causes premières et des mesures correctives pour résoudre le problème.
Vous pouvez résoudre les problèmes liés à la création d'un seul pipeline défaillant ou analyser plusieurs pipelines défaillants afin d'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 espaces 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 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 et en configure un lorsque vous commencez votre première investigation. Cette option nécessite une
aidevops:CreateAgentSpaceautorisation.
Pour commencer le dépannage, cliquez sur l'icône Dépannage dans l' AWS Management Console 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 à l'échec d'une compilation
En cas d'échec de la création d'une image, vous pouvez démarrer une AI-powered enquête à partir de plusieurs points d'entrée dans Image Builder AWS Management Console.
Lancer une enquête de dépannage
Utilisez l'une des méthodes suivantes pour commencer à résoudre les problèmes liés à un échec de compilation :
-
Tableau des pipelines : choisissez l'icône de résolution des problèmes à côté de l'état d'un pipeline défaillant dans la liste des pipelines d'images.
-
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' AWS Management Console en-tête, cliquez sur l'icône de résolution des problèmes, puis sélectionnez le pipeline que vous souhaitez étudier.
Au cours de l'enquête
Une fois que vous avez commencé le dépannage, Troubleshoot examine 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 AWS Management Console domaines pendant l'exécution de l'analyse. Lorsque l'enquête est terminée, vous recevez :
-
Analyse des causes profondes qui identifie les raisons de l'échec de la construction
-
É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 par rapport à la même version échouée, choisissez à nouveau Troubleshoot.
Résoudre les problèmes liés à plusieurs pipelines défaillants
Si plusieurs pipelines sont défaillants, vous pouvez les analyser ensemble afin d'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'images, sélectionnez plusieurs pipelines défaillants et choisissez Troubleshoot selected.
-
Ouvrez le tiroir de résolution des problèmes 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
-
Canalisations touchées par cette cause première
-
Étapes de correction pour le groupe
Après l'analyse agrégée, vous pouvez choisir une invite détaillée pour étudier un pipeline spécifique de manière plus détaillée.
Ce que Troubleshoot étudie
Lorsque vous dépannez un échec de construction, l'analyse couvre les domaines suivants :
-
Créez des journaux et des CloudWatch journaux Amazon : vérifie la présence d'erreurs, de codes de sortie différents de zéro, de délais d'expiration et de traces de pile.
-
Exécutions des étapes du flux de travail : identifie l'étape qui a échoué et examine ses détails.
-
Mise en réseau et autorisations : examine les autorisations du profil 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 l'AMI de base.
-
Connectivité réseau — Vérifie AWS Systems Manager (Systems Manager) l'accessibilité de l'agent, la résolution DNS et la configuration du proxy.
-
Historique des versions : analyse les versions récentes pour distinguer les défaillances persistantes des problèmes intermittents.
Considérations
Lorsque vous utilisez la fonction de résolution des problèmes, tenez compte des points suivants :
-
Troubleshoot effectue une analyse en lecture seule. Vos ressources ne sont pas modifiées.
-
Le dépannage concerne les défaillances de build d'Image Builder et les infrastructures associées telles que 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 aux builds du pipeline Image Builder, consultezRésoudre les problèmes liés aux builds de pipelines.
