Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Beheben Sie fehlgeschlagene Builds mit AI — Preview
Vorschaufunktion
Diese Funktion befindet sich in der Vorschauversion und kann sich ändern.
Wenn EC2 Image Builder-Builders fehlschlagen, kann die Identifizierung der Grundursache zeitaufwändig und komplex sein. Die Funktion zur Fehlerbehebung in Image Builder, unterstützt von AWS DevOps Agent, automatisiert diesen Prozess mithilfe AI-powered von Analysen. Sie können schnell die Ursache komplexer Build-Fehler identifizieren oder Muster in mehreren ausgefallenen Pipelines erkennen.
Wenn ein Build fehlschlägt, können Sie mithilfe der Problembehandlung Build-Logs, CloudWatch Amazon-Logs, die Ausführung von Workflow-Schritten und zugehörige AWS Ressourcen analysieren. Sie erhalten eine Ursachenanalyse und Schritte zur Behebung des Problems.
Sie können die Fehlerbehebung bei einem einzelnen fehlgeschlagenen Pipeline-Build beheben oder mehrere ausgefallene Pipelines analysieren, um gemeinsame Muster und gemeinsame Grundursachen zu identifizieren.
Inhalt
Voraussetzungen
Bevor Sie die Funktion zur Problembehandlung verwenden, stellen Sie sicher, dass der von Ihnen verwendete IAM-Benutzer oder die verwendete IAM-Rolle über die folgenden Berechtigungen verfügt:
-
aidevops:ListAgentSpaces— Erforderlich, um verfügbare Agentenbereiche zu ermitteln. -
aidevops:CreateChat— Erforderlich, um Sitzungen zur Problembehandlung zu starten. -
aidevops:SendChatMessage— Erforderlich, um während der Problembehandlung Nachrichten zu senden. -
aidevops:CreateAgentSpace— Nur erforderlich, wenn Image Builder einen Agentenbereich für Sie einrichten soll. Sie können diese Erlaubnis weglassen, wenn Sie Ihren eigenen Agentenbereich mitbringen.
Weitere Informationen zu IAM-Richtlinien finden Sie unter Richtlinien und Berechtigungen in IAM.
Richten Sie die Fehlerbehebung ein
Für die Funktion zur Fehlerbehebung ist ein AWS DevOps Agentenspeicherplatz erforderlich. Sie können einen vorhandenen Agentenbereich verwenden oder von Image Builder einen für Sie erstellen lassen:
-
Bringen Sie Ihren eigenen Agentenbereich mit — Wenn Sie bereits einen Agentenbereich haben, verwendet Image Builder ihn zur Problembehandlung.
-
Lassen Sie Image Builder einen erstellen — Wenn Sie keinen Agentenbereich haben, erstellt und konfiguriert Image Builder einen, wenn Sie mit Ihrer ersten Untersuchung beginnen. Für diese Option ist die
aidevops:CreateAgentSpaceGenehmigung erforderlich.
Um mit der Problembehandlung zu beginnen, wählen Sie das Fehlerbehebungssymbol in der AWS-Managementkonsole Kopfzeile.
Anmerkung
Weitere Informationen zum AWS DevOps Agenten finden Sie im AWS DevOps Agent-Benutzerhandbuch.
Beheben Sie einen fehlgeschlagenen Build
Wenn ein Image-Build fehlschlägt, können Sie eine AI-powered Untersuchung von mehreren Einstiegspunkten im Image Builder aus starten AWS-Managementkonsole.
Starten Sie eine Untersuchung zur Fehlerbehebung
Verwenden Sie eine der folgenden Methoden, um mit der Fehlerbehebung bei einem fehlgeschlagenen Build zu beginnen:
-
Pipelines-Tabelle — Wählen Sie in der Liste der Image-Pipelines das Symbol zur Problembehandlung neben dem Status einer fehlgeschlagenen Pipeline aus.
-
Tabelle mit Ausgabebildern — Wählen Sie in der Liste der Ausgabebilder das Symbol für die Problembehandlung neben einem fehlgeschlagenen Image-Build.
-
Problembehandlungsleiste — Klicken Sie in der AWS-Managementkonsole Kopfzeile auf das Symbol zur Problembehandlung und wählen Sie dann die Pipeline aus, die Sie untersuchen möchten.
Während der Untersuchung
Nachdem Sie mit der Problembehandlung begonnen haben, untersucht Troubleshooting den Fehler. Sie können den Fortschritt in Echtzeit in der Schublade verfolgen, während Protokolle und Ressourcen analysiert werden. Die Untersuchung ist in der Regel in wenigen Minuten abgeschlossen. Während der Analyse können Sie in anderen AWS-Managementkonsole Bereichen weiterarbeiten. Nach Abschluss der Untersuchung erhalten Sie:
-
Ursachenanalyse, die feststellt, warum der Build fehlgeschlagen ist
-
Schritte zur Behebung des Problems
-
Befehle oder Konfigurationsänderungen zur Behebung des Problems
Nachdem Sie die Ergebnisse überprüft haben, können Sie uns Feedback zur Qualität der Antworten geben. Um die Analyse für denselben fehlgeschlagenen Build erneut auszuführen, wählen Sie erneut Problembehandlung aus.
Beheben Sie Fehler bei mehreren ausgefallenen Pipelines
Wenn mehrere Pipelines ausgefallen sind, können Sie diese gemeinsam analysieren, um gemeinsame Muster und gemeinsame Grundursachen zu identifizieren.
Starten Sie eine aggregierte Untersuchung
Verwenden Sie eine der folgenden Methoden, um Fehler bei mehreren Pipelines zu beheben:
-
Wählen Sie in der Tabelle Image-Pipelines mehrere ausgefallene Pipelines aus und wählen Sie Problembehandlung ausgewählt aus.
-
Öffnen Sie die Problembehandlungsleiste und wählen Sie Alle beheben, um alle ausgefallenen Pipelines zu analysieren.
Aggregieren Sie die Analyseergebnisse
Sie erhalten eine gruppierte Analyse, die nach der Ursache geordnet ist. Für jede Gruppe erhalten Sie:
-
Beschreibung der gemeinsamen Grundursache
-
Pipelines, die von dieser Grundursache betroffen sind
-
Schritte zur Problembehebung für die Gruppe
Nach der Aggregatanalyse können Sie eine Drilldown-Aufforderung wählen, um eine bestimmte Pipeline genauer zu untersuchen.
Was untersucht Troubleshooting
Bei der Fehlerbehebung bei einem fehlgeschlagenen Build deckt die Analyse die folgenden Bereiche ab:
-
Build-Logs und CloudWatch Amazon-Logs — Sucht nach Fehlern, Exit-Codes ungleich Null, Timeouts und Stack-Traces.
-
Ausführung von Workflow-Schritten — Identifiziert den fehlgeschlagenen Schritt und untersucht seine Details.
-
Netzwerk und Berechtigungen — Überprüft IAM-Instance-Profilberechtigungen, Sicherheitsgruppen, Subnetz-Routing, NAT-Gateways, Internet-Gateways und VPC-Endpunkte.
-
Komponenten- und Rezeptkonfiguration — Prüft auf Skriptfehler, fehlende Abhängigkeiten, defekte URLs und die Gültigkeit der Basis-AMIs.
-
Netzwerkkonnektivität — Überprüft AWS Systems Manager (Systems Manager) die Erreichbarkeit des Agenten, die DNS-Auflösung und die Proxykonfiguration.
-
Build-Verlauf — Überprüft aktuelle Builds, um anhaltende Fehler von zeitweiligen Problemen zu unterscheiden.
Überlegungen
Beachten Sie Folgendes, wenn Sie die Funktion zur Fehlerbehebung verwenden:
-
Bei der Fehlerbehebung wird eine schreibgeschützte Analyse durchgeführt. Ihre Ressourcen werden nicht geändert.
-
Die Problembehandlung beschränkt sich auf Image Builder-Build-Fehler und die zugehörige Infrastruktur wie IAM, VPC und Systems Manager Agent.
Anmerkung
AI generiert diese Antworten. Überprüfen Sie die Analyse und die Empfehlungen, bevor Sie Ihre Ressourcen ändern.
Weitere Informationen zur Problembehandlung bei Image Builder-Pipeline-Builds finden Sie unterFehlerbehebung bei Pipeline-Builds.
