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 von Amazon ECS-Bereitstellungsproblemen
Themen
Beim Warten auf den Satz einer Ersatzaufgabe tritt ein Timeout auf
Beim Warten auf die Fortsetzung einer Benachrichtigung tritt ein Timeout auf
Beim Warten auf einen Statusrückruf ist bei der Bereitstellung ein Timeout aufgetreten
Meine Bereitstellung schlägt manchmal fehl, wenn Auto Scaling verwendet wird
Kann ich einer Bereitstellungsgruppe mehrere Load Balancer zuordnen?
Kann ich CodeDeploy blue/green Bereitstellungen ohne einen Load Balancer durchführen?
Beim Warten auf den Satz einer Ersatzaufgabe tritt ein Timeout auf
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit CodeDeploy:
The deployment timed out while waiting for the replacement task set to become
healthy. This time out period is 60 minutes.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Ihre Aufgabendefinitionsdatei oder andere bereitstellungsbezogene Dateien einen Fehler enthalten. Wenn das image Feld in Ihrer Aufgabendefinitionsdatei beispielsweise einen Tippfehler enthält, versucht Amazon ECS, das falsche Container-Image abzurufen und schlägt ständig fehl, was diesen Fehler verursacht.
Mögliche Korrekturen und nächste Schritte:
-
Korrigieren Sie Tippfehler und Konfigurationsprobleme in Ihrer Aufgabendefinitionsdatei und anderen Dateien.
-
Sehen Sie sich das entsprechende Amazon ECS-Serviceereignis an und finden Sie heraus, warum Ersatzaufgaben nicht mehr ordnungsgemäß ausgeführt werden. Weitere Informationen zu Amazon ECS-Ereignissen finden Sie unter Amazon ECS-Ereignisse im Amazon Elastic Container Service Developer Guide.
-
Im Amazon Elastic Container Service Developer Guide finden Sie im Abschnitt zur Amazon ECS-Fehlerbehebung Informationen zu Fehlern im Zusammenhang mit den Meldungen in der Veranstaltung.
Beim Warten auf die Fortsetzung einer Benachrichtigung tritt ein Timeout auf
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit CodeDeploy:
The deployment timed out while waiting for a notification to continue. This time out
period is
n minutes.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie bei der Erstellung Ihrer Bereitstellungsgruppe im Feld Geben Sie an, wann der Verkehr umgeleitet werden soll, eine Wartezeit angegeben haben, die Bereitstellung jedoch nicht abgeschlossen werden konnte, bevor die Wartezeit abgelaufen ist.
Mögliche Problembehebungen und nächste Schritte:
-
Stellen Sie in Ihrer Bereitstellungsgruppe die Option Geben Sie an, wann der Datenverkehr umgeleitet werden soll, auf einen längeren Zeitraum ein und führen Sie die Bereitstellung erneut durch. Weitere Informationen finden Sie unter Eine Bereitstellungsgruppe für eine Amazon ECS-Bereitstellung erstellen (Konsole).
-
Ändern Sie in Ihrer Bereitstellungsgruppe die Option Geben Sie an, wann der Verkehr umgeleitet werden soll in Verkehr sofort umleiten und erneut bereitstellen. Weitere Informationen finden Sie unter Eine Bereitstellungsgruppe für eine Amazon ECS-Bereitstellung erstellen (Konsole).
-
Stellen Sie es erneut bereit und führen Sie dann den AWS CLI Befehl aws deploy continue-deployment mit der Option auf aus.
--deployment-wait-typeREADY_WAITStellen Sie sicher, dass Sie diesen Befehl ausführen, bevor die unter Geben Sie an, wann der Verkehr umgeleitet werden soll, angegebene Zeit abläuft.
Die IAM-Rolle verfügt nicht über genügend Berechtigungen
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit: CodeDeploy
The IAM role
role-arn does not give you permission to
perform operations in the following AWS service: AWSLambda.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie im Hooks Abschnitt der AppSpec Datei eine Lambda-Funktion angegeben, dem Lambda-Service jedoch keine CodeDeploy Genehmigung erteilt haben.
Mögliche Lösung: Fügen Sie die lambda:InvokeFunction Berechtigung zur CodeDeploy Servicerolle hinzu. Um diese Berechtigung hinzuzufügen, fügen Sie der Rolle eine der AWS folgenden verwalteten Richtlinien hinzu: AWSCodeDeployRoleForECS oderAWSCodeDeployRoleForECSLimited. Informationen zu diesen Richtlinien und dazu, wie Sie sie der CodeDeploy Servicerolle hinzufügen, finden Sie unterSchritt 2: Erstellen Sie eine Servicerolle für CodeDeploy.
Beim Warten auf einen Statusrückruf ist bei der Bereitstellung ein Timeout aufgetreten
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit: CodeDeploy
The deployment timed out while waiting for a status callback. CodeDeploy expects a status
callback within one hour after a deployment hook is invoked.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie im Hooks Abschnitt der AppSpec Datei eine Lambda-Funktion angegeben haben, die Lambda-Funktion jedoch nicht die erforderliche PutLifecycleEventHookExecutionStatus API aufrufen konnte, an die ein Succeeded Failed OR-Status zurückgegeben werden sollte. CodeDeploy
Mögliche Korrekturen und nächste Schritte:
-
Fügen Sie die
codedeploy:putlifecycleEventHookExecutionStatusBerechtigung zur Lambda-Ausführungsrolle hinzu, die von der Lambda-Funktion verwendet wird, die Sie in der AppSpec Datei angegeben haben. Diese Berechtigung gewährt der Lambda-Funktion die Möglichkeit, den Status oder an zurückzugeben.SucceededFailedCodeDeploy Weitere Informationen zur Lambda-Ausführungsrolle finden Sie unter Lambda-Ausführungsrolle im AWS Lambda Benutzerhandbuch. -
Überprüfen Sie Ihren Lambda-Funktionscode und die Ausführungsprotokolle, um sicherzustellen, dass Ihre Lambda-Funktion die
PutLifecycleEventHookExecutionStatusAPI aufruft CodeDeploy, um zu CodeDeploy erfahren, ob der Lifecycle-Validierungstest oderSucceededFailedInformationen zurputlifecycleEventHookExecutionStatusAPI finden Sie PutLifecycleEventHookExecutionStatus in der AWS CodeDeploy API-Referenz. Informationen zu Lambda-Ausführungsprotokollen finden Sie unter Zugreifen auf CloudWatch Amazon-Protokolle für AWS Lambda.
Die Bereitstellung ist fehlgeschlagen, weil eine oder mehrere der Funktionen zur Überprüfung von Lebenszyklusereignissen fehlgeschlagen sind
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit CodeDeploy:
The deployment failed because one or more of the lifecycle event validation
functions failed.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie im Hooks Abschnitt der AppSpec Datei eine Lambda-Funktion angegeben haben, die Lambda-Funktion jedoch CodeDeploy beim Aufruf wieder Failed aktiviert wurde. PutLifecycleEventHookExecutionStatus Dieser Fehler weist darauf hin CodeDeploy , dass der Lifecycle-Validierungstest fehlgeschlagen ist.
Möglicher nächster Schritt: Überprüfen Sie Ihre Lambda-Ausführungsprotokolle, um festzustellen, warum der Validierungstestcode fehlschlägt. Informationen zu Lambda-Ausführungsprotokollen finden Sie unter Zugreifen auf CloudWatch Amazon-Protokolle für. AWS Lambda
Der ELB konnte aufgrund des folgenden Fehlers nicht aktualisiert werden: Die primäre Taskset-Zielgruppe muss sich hinter dem Listener befinden
Problem: Sie sehen die folgende Fehlermeldung bei der Bereitstellung Ihrer Amazon ECS-Anwendung mit: CodeDeploy
The ELB could not be updated due to the following error: Primary taskset target
group must be behind listener
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie einen optionalen Test-Listener konfiguriert haben und dieser mit der falschen Zielgruppe konfiguriert ist. Weitere Hinweise zum Test-Listener finden Sie unter CodeDeploy Bevor Sie mit einer Amazon-ECS-Bereitstellung beginnen und. Was passiert während einer Amazon ECS-Bereitstellung Weitere Informationen zu Aufgabensätzen finden Sie TaskSet in der Amazon Elastic Container Service API-Referenz und in describe-task-set im Abschnitt Amazon ECS der Befehlsreferenz. AWS CLI
Mögliche Lösung: Stellen Sie sicher, dass sowohl der Produktions-Listener als auch der Test-Listener von Elastic Load Balancing auf die Zielgruppe verweisen, die derzeit Ihre Workloads bedient. Es gibt drei Stellen, die Sie überprüfen sollten:
-
In Amazon EC2 in den Listener- und Regeleinstellungen Ihres Load Balancers. Weitere Informationen finden Sie unter Listener für Ihre Application Load Balancer im Benutzerhandbuch für Application Load Balancer oder Listener für Ihre Network Load Balancer im Benutzerhandbuch für Network Load Balancer.
-
In Amazon ECS, in Ihrem Cluster, unter der Netzwerkkonfiguration Ihres Dienstes. Weitere Informationen finden Sie unter Überlegungen zu Application Load Balancer und Network Load Balancer im Amazon Elastic Container Service Developer Guide.
-
In CodeDeploy, in den Einstellungen Ihrer Bereitstellungsgruppe. Weitere Informationen finden Sie unter Eine Bereitstellungsgruppe für eine Amazon ECS-Bereitstellung erstellen (Konsole).
Meine Bereitstellung schlägt manchmal fehl, wenn Auto Scaling verwendet wird
Problem: Sie verwenden Auto Scaling mit CodeDeploy und stellen fest, dass Ihre Bereitstellungen gelegentlich fehlschlagen. Weitere Informationen zu den Symptomen dieses Problems finden Sie im Amazon Elastic Container Service Developer Guide unter dem Thema Für Dienste, die für die Verwendung von Service Auto Scaling konfiguriert sind, und den blue/green Bereitstellungstyp, wird Auto Scaling während einer Bereitstellung nicht blockiert, aber die Bereitstellung kann unter bestimmten Umständen fehlschlagen.
Mögliche Ursache: Dieses Problem kann auftreten, wenn CodeDeploy die Auto Scaling-Prozesse miteinander in Konflikt geraten.
Mögliche Lösung: Unterbrechen und setzen Sie Auto Scaling-Prozesse während der CodeDeploy Bereitstellung mithilfe der RegisterScalableTarget API (oder des entsprechenden register-scalable-target AWS CLI Befehls) fort. Weitere Informationen finden Sie unter Unterbrechen und Fortsetzen der Skalierung für Application Auto Scaling im Application Auto Scaling-Benutzerhandbuch.
CodeDeploy kann nicht RegisterScaleableTarget direkt anrufen. Um diese API verwenden zu können, müssen Sie so konfigurieren, CodeDeploy dass eine Benachrichtigung oder ein Ereignis an Amazon Simple Notification Service (oder Amazon CloudWatch) gesendet wird. Anschließend müssen Sie Amazon SNS (oder CloudWatch) so konfigurieren, dass eine Lambda-Funktion aufgerufen wird, und die Lambda-Funktion so konfigurieren, dass sie die API aufruft. RegisterScalableTarget Die RegisterScalableTarget API muss mit dem SuspendedState Parameter auf auf aufgerufen werden, true um Auto Scaling-Operationen auszusetzen und wieder false aufzunehmen.
Die Benachrichtigung oder das Ereignis, das CodeDeploy gesendet wird, muss eintreten, wenn eine Bereitstellung gestartet wird (um Auto Scaling-Sperrvorgänge auszulösen) oder wenn eine Bereitstellung erfolgreich ist, fehlschlägt oder beendet wird (um Auto Scaling-Wiederaufnahmevorgänge auszulösen).
Informationen zur Konfiguration CodeDeploy der Generierung von Amazon SNS-Benachrichtigungen oder CloudWatch -Ereignissen finden Sie unterÜberwachung von Bereitstellungen mit Amazon Events CloudWatch. und. Monitoring Deployments with Amazon SNS Event Notifications
Nur ALB unterstützt das schrittweise Routing des Datenverkehrs. Verwenden Sie stattdessen das AllAtOnce Traffic-Routing, wenn Sie create/update eine Gruppe einrichten
Problem: Beim Erstellen oder Aktualisieren einer Bereitstellungsgruppe wird die folgende Fehlermeldung angezeigt in CodeDeploy:
Only ALB supports gradual traffic routing, use AllAtOnce Traffic routing instead when
you create/update Deployment group.
Mögliche Ursache: Dieser Fehler kann auftreten, wenn Sie einen Network Load Balancer verwenden und versuchen, eine andere vordefinierte Bereitstellungskonfiguration zu verwenden. CodeDeployDefault.ECSAllAtOnce
Mögliche Lösungen:
-
Ändern Sie Ihre vordefinierte Bereitstellungskonfiguration in
CodeDeployDefault.ECSAllAtOnce. Dies ist die einzige vordefinierte Bereitstellungskonfiguration, die von Network Load Balancers unterstützt wird.Weitere Informationen zu vordefinierten Bereitstellungskonfigurationen finden Sie unterVordefinierte Bereitstellungskonfigurationen für eine Amazon ECS-Rechenplattform.
-
Ändern Sie Ihren Load Balancer in einen Application Load Balancer. Die Application Load Balancer unterstützen alle vordefinierten Bereitstellungskonfigurationen. Weitere Informationen zum Erstellen eines Application Load Balancers finden Sie unter. Einen Load Balancer, Zielgruppen und Listener für CodeDeploy Amazon ECS-Bereitstellungen einrichten
Obwohl meine Bereitstellung erfolgreich war, besteht der Ersatz-Tasksatz bei den Elastic Load Balancing-Zustandsprüfungen nicht und meine Anwendung ist ausgefallen
Problem: Obwohl es CodeDeploy darauf hinweist, dass meine Bereitstellung erfolgreich war, besteht das Ersatz-Task-Set die Zustandsprüfungen von Elastic Load Balancing nicht und meine Anwendung ist ausgefallen.
Mögliche Ursache: Dieses Problem kann auftreten, wenn Sie eine CodeDeploy Komplettbereitstellung durchgeführt haben und Ihr Ersatz-Task-Set (grün) fehlerhaften Code enthält, der dazu führt, dass die Elastic Load Balancing-Zustandsprüfungen fehlschlagen. Bei der All-at-Once-Bereitstellungskonfiguration werden die Zustandsprüfungen des Load Balancers für den Ersatz-Tasksatz ausgeführt, nachdem der Datenverkehr dorthin verlagert wurde (d. h., wenn das Lifecycle-Ereignis danach CodeDeploy eingetreten ist). AllowTraffic Aus diesem Grund werden Sie feststellen, dass die Systemdiagnosen für den Ersatz-Tasksatz nach einer Verlagerung des Datenverkehrs fehlschlagen, aber nicht davor. Informationen zu den CodeDeploy generierten Lebenszyklusereignissen finden Sie unterWas passiert während einer Amazon ECS-Bereitstellung.
Mögliche Lösungen:
-
Ändern Sie Ihre Bereitstellungskonfiguration von All-at-Once auf Canary oder Linear. In einer kanarischen oder linearen Konfiguration beginnen die Zustandsprüfungen des Load Balancers für die Ersatzaufgabe, während Ihre Anwendung in der Ersatzumgebung CodeDeploy installiert wird und bevor der Datenverkehr verschoben wird (d. h. während des
InstallLebenszyklusereignisses und vor dem Ereignis).AllowTrafficWenn Sie zulassen, dass die Prüfungen während der Anwendungsinstallation, aber bevor der Datenverkehr verlagert wird, ausgeführt werden, wird fehlerhafter Anwendungscode erkannt, der zu Bereitstellungsfehlern führt, bevor die Anwendung öffentlich verfügbar ist.Hinweise zur Konfiguration von Canary- oder Linear-Bereitstellungen finden Sie unterÄndern Sie die Einstellungen der Bereitstellungsgruppe mit CodeDeploy.
Informationen zu CodeDeploy Lebenszyklusereignissen, die während einer Amazon ECS-Bereitstellung auftreten, finden Sie unterWas passiert während einer Amazon ECS-Bereitstellung.
AnmerkungKanarische und lineare Bereitstellungskonfigurationen werden nur mit Application Load Balancers unterstützt.
-
Wenn Sie Ihre All-at-Once-Bereitstellungskonfiguration beibehalten möchten, richten Sie einen Test-Listener ein und überprüfen Sie den Status des Ersatz-Task-Sets mit dem Lifecycle-Hook.
BeforeAllowTrafficWeitere Informationen finden Sie unter Liste der Lifecycle-Event-Hooks für eine Amazon ECS-Bereitstellung.
Kann ich einer Bereitstellungsgruppe mehrere Load Balancer zuordnen?
Nein. Wenn Sie mehrere Application Load Balancer oder Network Load Balancer verwenden möchten, verwenden Sie Amazon ECS Rolling Updates statt CodeDeploy blue/green Bereitstellungen. Weitere Informationen zu fortlaufenden Updates finden Sie unter Rolling Update im Amazon Elastic Container Service Developer Guide. Weitere Informationen zur Verwendung mehrerer Load Balancer mit Amazon ECS finden Sie unter Registrieren mehrerer Zielgruppen bei einem Service im Amazon Elastic Container Service Developer Guide.
Kann ich CodeDeploy blue/green Bereitstellungen ohne einen Load Balancer durchführen?
Nein, ohne einen Load Balancer können Sie keine CodeDeploy blue/green Bereitstellungen durchführen. Wenn Sie keinen Load Balancer verwenden können, verwenden Sie stattdessen die Funktion für fortlaufende Updates von Amazon ECS. Weitere Informationen zu fortlaufenden Amazon ECS-Updates finden Sie unter Rolling Update im Amazon Elastic Container Service Developer Guide.
Wie kann ich meinen Amazon ECS-Service während einer Bereitstellung mit neuen Informationen aktualisieren?
Damit Ihr Amazon ECS-Service während der Bereitstellung mit einem neuen Parameter CodeDeploy aktualisiert wird, geben Sie den Parameter im resources Abschnitt der AppSpec Datei an. Nur wenige Amazon ECS-Parameter werden von unterstützt CodeDeploy, z. B. die Aufgabendefinitionsdatei und die Parameter für den Containernamen. Eine vollständige Liste der Amazon ECS-Parameter, die aktualisiert CodeDeploy werden können, finden Sie unterAppSpec Abschnitt „Ressourcen“ für Amazon ECS-Bereitstellungen.
Wenn Sie Ihren Amazon ECS-Service mit einem Parameter aktualisieren müssen, der von nicht unterstützt wird CodeDeploy, gehen Sie wie folgt vor:
-
Rufen Sie die Amazon
UpdateServiceECS-API mit dem Parameter auf, den Sie aktualisieren möchten. Eine vollständige Liste der Parameter, die aktualisiert werden können, finden Sie UpdateService in der Amazon Elastic Container Service API-Referenz. -
Um die Änderung auf die Aufgaben anzuwenden, erstellen Sie eine neue Amazon blue/green ECS-Bereitstellung. Weitere Informationen finden Sie unter Erstellen Sie eine Amazon ECS Compute Platform-Bereitstellung (Konsole).