AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager Referenz zum Automatisierungs-Runbook

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.

AWSSupport-TroubleshootCodeDeploy

Beschreibung

Das AWSSupport-TroubleshootCodeDeploy Runbook hilft bei der Diagnose, warum eine AWS CodeDeploy Bereitstellung auf einer Amazon Elastic Compute Cloud (Amazon EC2) -Instance fehlgeschlagen ist. Das Runbook gibt Schritte aus, die Ihnen bei der Lösung des Problems oder bei der weiteren Problembehandlung helfen. CodeDeployEs werden auch bewährte Methoden für bereitgestellt, mit denen Sie ähnliche Probleme in Zukunft vermeiden können.

Dieses Runbook kann Ihnen helfen, die folgenden Probleme zu lösen:

  • Der CodeDeploy Agent ist nicht installiert oder läuft nicht auf der Amazon EC2-Instance

  • An die Amazon EC2-Instance ist kein AWS Identity and Access Management (IAM-) Instance-Profil angehängt

  • Das an die Amazon EC2-Instance angehängte IAM-Instance-Profil verfügt nicht über die erforderlichen Amazon Simple Storage Service (Amazon S3) -Berechtigungen

  • Eine in Amazon S3 gespeicherte Revision fehlt, oder der verwendete Amazon S3-Bucket befindet sich in einer AWS-Region anderen als der Amazon EC2-Instance

  • Probleme mit der Anwendungsspezifikationsdatei (AppSpec)

  • Fehler „Datei ist bereits am Speicherort vorhanden“

  • Event-Hooks für den CodeDeploy verwalteten Lebenszyklus fehlgeschlagen

  • Fehlgeschlagene vom Kunden verwaltete Lifecycle-Event-Hoo

  • Scale-In-Ereignisse während der Bereitstellung

Diese Automatisierung ausführen (Konsole)

Art des Dokuments

-Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • DeploymentId

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ID der Bereitstellung, die fehlgeschlagen ist.

  • InstanceId

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ID der Amazon EC2-Instance, in der die Bereitstellung fehlgeschlagen ist.

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • codedeploy:GetDeployment

  • codedeploy:GetDeploymentTarget

  • ec2:DescribeInstances

Dokumentschritte

  • aws:executeAwsApi- Überprüft die für die InstanceId Parameter DeploymentId und angegebenen Werte.

  • aws:executeScript- Sammelt Informationen aus der Amazon EC2-Instance wie den Status der Instance und die Profildetails der IAM-Instance.

  • aws:executeScript— Überprüft die angegebene Bereitstellung und gibt eine Analyse darüber zurück, warum die Bereitstellung fehlgeschlagen ist.