Wie kann ich eine fehlgeschlagene CodeDeploy-Bereitstellung auf Amazon EC2-Instances beheben?

Kurzbeschreibung

Sie können das AWSSupport-TroubleshootCodeDeploy-Automation-Runbook von AWS Systems Manager verwenden, um fehlgeschlagene Bereitstellungen zu beheben. Das Runbook hilft Ihnen zu erkennen, wann eine Bereitstellung aus den folgenden Gründen fehlschlägt:

• Der CodeDeploy-Agent ist nicht installiert oder läuft nicht auf der Instance.
• Das erforderliche Instance-Profil fehlt.
• Das Instance-Profil hat keine korrekten Amazon Simple Storage Service (Amazon S3)-Berechtigungen.
• Es gibt ein Problem mit einem der Lebenszyklus-Hooks, die von CodeDeploy verwaltet werden, wie AllowTraffic oder BlockTraffic.
• Es gibt ein Problem mit einem der vom Kunden verwalteten Lebenszyklus-Hooks.
• Während der Bereitstellung ist ein Problem mit einem Abwärtsskalierungsereignis der Auto Scaling-Gruppe aufgetreten.
• Eine AppSpec-Datei fehlt oder ist falsch formatiert.

Auflösung

**Wichtig:**Verwenden Sie das AWSSupport-TroubleshootCodeDeploy-Runbook in derselben AWS-Region, in der sich Ihre CodeDeploy-Anwendung befindet.

1.    Öffnen Sie die AWS Systems Manager-Konsole.

2.    Wählen Sie im Navigationsbereich im Abschnitt Change Management die Option Automatisierung.

3.    Wählen Sie Automatisierung ausführen.

4.    Geben Sie auf der Registerkarte Owned by Amazon in das Suchfeld für Automatisierungsdokumente den Text AWSSupport-TroubleshootCodeDeploy ein. Wählen Sie dann das Suchsymbol oder drücken Sie die Eingabetaste auf Ihrer Tastatur.

5.    Aktivieren Sie das Optionsfeld auf der AWSSupport-TroubleshootCodeDeploy-Karte.

**Hinweis:**Stellen Sie sicher, dass Sie das Optionsfeld und nicht den mit einem Hyperlink versehenen Automatisierungsnamen aktivieren.

6.    Wählen Sie im Abschnitt Dokumentdetails die Option Weiter.

7.    Geben Sie im Abschnitt Eingabeparameter für DeploymentID die Bereitstellungs-ID ein, bei der der Fehler aufgetreten ist.

8.    Geben Sie für InstanceID die Instance-ID ein, bei der die Bereitstellung fehlgeschlagen ist.

9.    Geben Sie für AutomationAssumeRole den Amazon-Ressourcennamen (ARN) der Rolle ein, die es Systems Manager Automation ermöglicht, Aktionen auszuführen.

**Hinweis:**Wenn keine AWS Identity and Access Management (IAM)-Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen der IAM-Benutzerrolle, die das Runbook ausführt. Weitere Informationen zum Erstellen der zu übernehmenden Rolle für Systems Manager Automation finden Sie unter Aufgabe 1: Erstellen einer Servicerolle für Automation.

**Wichtig:**Entweder AutomationAssumeRole oder die Benutzerrolle muss über Berechtigungen für die folgenden Aktionen verfügen: codedeploy:GetDeployment, codedeploy:GetDeploymentTarget und ec2:DescribeInstances.

10.    Wählen Sie Ausführen.

Die Ausgabe des Runbooks enthält Schritte zur Fehlerbehebung und Empfehlungen zur Behebung des Problems, das zu Ihrem Bereitstellungsfehler geführt hat.

Ähnliche Informationen

Problembehandlung bei CodeDeploy

Behebung von Problemen bei der Bereitstellung von EC2/On-Premises