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.

Problembehandlung in Ihrer Elastic Beanstalk-Umgebung

Dieses Kapitel enthält Anleitungen zur Behebung von Problemen mit Ihrer Elastic-Beanstalk-Umgebung. Diese umfasst das Folgende:

Wenn der Zustand Ihrer Umgebung rot wird, empfehlen wir Ihnen, zuerst das AWS Systems Manager Tool zu verwenden, das vordefinierte Runbooks enthält, um Probleme mit Elastic Beanstalk zu beheben. Weitere Informationen finden Sie unter Verwenden des Systems-Manager-Tools.

Mithilfe der Umgebungsanalyse AI-powered

Elastic Beanstalk bietet AI-powered Analysen, um die Ursachen zu identifizieren und Lösungen für Umweltprobleme zu empfehlen. Sie können auf diese Funktion über die Schaltfläche „KI-Analyse“ der Konsole zugreifen, indem Sie die Elastic Beanstalk-API über die verwenden oder indem Sie sie eb logs --analyze mit der AWS CLI EB-CLI ausführen. Bei der Analyse werden die Protokolle, Ereignisse und der Instance-Zustand Ihrer Umgebung untersucht, um kritische Probleme zu identifizieren und schrittweise Empfehlungen zur Fehlerbehebung zu geben.

Weitere Informationen finden Sie unter AI-powered Umweltanalyse.

Verwenden AWS Systems Manager Elastic Beanstalk-Runbooks

Sie können Systems Manager verwenden, um Probleme in Ihren Elastic-Beanstalk-Umgebungen zu beheben. Um Ihnen den Einstieg zu erleichtern, stellt Systems Manager vordefinierte Automatisierungs-Runbooks für Elastic Beanstalk bereit. Ein Automatisierungs-Runbook ist eine Art von Systems-Manager-Dokument, das Aktionen definiert, die auf den Instances und anderen AWS -Ressourcen Ihrer Umgebung ausgeführt werden sollen.

Bei dem Dokument AWSSupport-TroubleshootElasticBeanstalk handelt es sich um ein Automatisierungs-Runbook, mit dem Sie eine Reihe gängiger Probleme identifizieren können, die Ihre Elastic-Beanstalk-Umgebung beeinträchtigen können. Zu diesem Zweck werden die Komponenten Ihrer Umgebung überprüft, darunter die folgenden: EC2 Instances, die VPC,  CloudFormation -Stack, Load Balancer, Auto-Scaling-Gruppen und die Netzwerkkonfiguration in Verbindung mit Sicherheitsgruppenregeln, Routing-Tabellen und ACLs.

Es gibt auch die Möglichkeit, gebündelte Protokolldateien aus Ihrer Umgebung zu  AWS -Support hochzuladen.

Weitere Informationen finden Sie unter AWSSupport-TroubleshootElasticBeanstalk in der Referenz zum AWS Systems Manager -Automation-Runbook.

Nachdem alle Schritte erfolgreich abgeschlossen wurden, enthält die Ausgabe Schritte zur Fehlerbehebung und Empfehlungen, mit denen Sie Ihre Umgebung wieder in einen einwandfreien Zustand versetzen können.

Allgemeine Hinweise zur Fehlerbehebung in Ihrer Elastic Beanstalk-Umgebung

Fehlermeldungen können auf der Seite Ereignisse in der Konsole, in Protokollen oder auf der Seite Zustand erscheinen. Sie können auch Maßnahmen ergreifen, um eine beeinträchtigte Umgebung wiederherzustellen, die durch eine kürzlich erfolgte Änderung verursacht wurde. Ändert sich der Zustand der Umgebung zu Rot, führen Sie die folgenden Schritte aus:

Umgebungen, die mit Umgebungsvariablen auf Geheimnisse und Parameter zugreifen

Ereignis: Bei der Instanzbereitstellung konnten ein oder mehrere Geheimnisse nicht abgerufen werden

Diese Meldung weist darauf hin, dass Elastic Beanstalk eines oder mehrere der während Ihrer Anwendungsbereitstellung angegebenen Geheimnisse nicht abrufen konnte.

Beispiele für diese Befehle finden Sie unter AWS CLI Beispiele für Elastic Beanstalk. Weitere Informationen zu den API-Aktionen für diese Operationen finden Sie in der AWS Elastic Beanstalk API-Referenz.

Ereignis: Bei der Instanzbereitstellung wurden ein oder mehrere mehrzeilige Umgebungswerte erkannt, die für diese Plattform nicht unterstützt werden

Mehrzeilige Variablen werden für Amazon Linux 2-Plattformen nicht unterstützt, mit Ausnahme von Docker und von ECS verwalteten Docker-Plattformen. Die verfügbaren Optionen, um fortzufahren, finden Sie unter. Mehrzeilige Werte

Ereignis: CreateEnvironment schlägt fehl, wenn ein Geheimnis angegeben wird

Wenn CreateEnvironment dies fehlschlägt und Sie Geheimnisse als Umgebungsvariablen haben, müssen Sie das zugrunde liegende Problem beheben und dann verwendenUpdateEnvironment, um die Umgebungseinrichtung abzuschließen. Verwenden Sie es nichtRestartAppServer, da es in dieser Situation nicht ausreicht, die Umgebung hochzufahren. Beispiele für diese Befehle finden Sie unter AWS CLI Beispiele für Elastic Beanstalk . Weitere Informationen zu den API-Aktionen für diese Operationen finden Sie in der AWS Elastic Beanstalk API-Referenz.

Umgebungserstellung und Instance-Starts

Ereignis: Umgebung konnte nicht gestartet werden

Dieses Ereignis tritt auf, wenn Elastic Beanstalk versucht, eine Umgebung zu starten und es dabei zu Fehlern kommt. Die vorherigen Ereignisse auf der Seite Events (Ereignisse) weisen auf die Ursache des Problems hin.

Ereignis: Die Erstellung der Umgebung wurde mit Befehls-Timeouts abgeschlossen. Versuchen Sie, die Timeout-Zeit zu erhöhen.

Falls Sie Konfigurationsdateien einsetzen, mit denen Befehle auf der Instance ausgeführt, große Dateien heruntergeladen oder Pakete installiert werden, kann die Anwendungsbereitstellung langwierig sein. Erhöhen Sie den Timeout-Wert für Befehle, damit die Anwendung im Rahmen der Bereitstellungen mehr Zeit zum Ausführen hat.

Ereignis: Die folgenden Ressourcen konnten nicht erstellt werden: [AWSEBInstanceLaunchWaitCondition]

Diese Nachricht gibt an, dass die Amazon EC2-Instances der Umgebung Elastic Beanstalk nicht über den erfolgreichen Start informiert haben. Das kann passieren, wenn die Instances keine Verbindung zum Internet haben. Wenn die Umgebungskonfiguration das Starten der Instances in einem privaten VPC-Subnetz vorsieht, stellen Sie sicher, dass das Subnetz über NAT verfügt, damit die Instances eine Verbindung zu Elastic Beanstalk herstellen können.

Ereignis: In dieser Region ist eine Servicerolle erforderlich. Bitte fügen Sie der Umgebung eine Servicerolle-Option hinzu.

Elastic Beanstalk nutzt eine Servicerolle zur Überwachung der Ressourcen in Ihrer Umgebung und zur Unterstützung von verwalteten Plattformaktualisierungen. Weitere Informationen finden Sie unter Rollen von Elastic Beanstalk Service verwalten.

Bereitstellungen

Problem: Anwendung steht während Bereitstellungen nicht zur Verfügung

Da Elastic Beanstalk ein Drop-in-Upgrade ausführt, kann es zu einer Ausfallzeit von einigen Sekunden kommen. Setzen Sie fortlaufende Bereitstellungen ein, um die Beeinträchtigung der Produktionsumgebungen aufgrund von Bereitstellungen zu minimieren.

Ereignis: Die AWS Elastic Beanstalk-Anwendungsversion konnte nicht erstellt werden

Möglicherweise ist das Quell-Bundle der Anwendung zu umfangreich oder das Anwendungsversionskontingent wurde erreicht.

Ereignis: Umgebungsaktualisierung wurde mit Befehls-Timeouts abgeschlossen. Versuchen Sie, die Timeout-Zeit zu erhöhen.

Falls Sie Konfigurationsdateien einsetzen, mit denen Befehle auf der Instance ausgeführt, große Dateien heruntergeladen oder Pakete installiert werden, kann die Anwendungsbereitstellung langwierig sein. Erhöhen Sie den Timeout-Wert für Befehle, damit die Anwendung im Rahmen der Bereitstellungen mehr Zeit zum Ausführen hat.

Gesundheit

Ereignis: CPU-Auslastung Über 95 %

Versuchen Sie, mehr Instances auszuführen, oder wählen Sie einen anderen Instance-Typ aus.

Ereignis: Elastic Load Balancer awseb — myapp Hat keine fehlerfreien Instances, ELB-Prozesse funktionieren nicht korrekt, wenn keine Instances vorhanden sind. X Y , ELB-Prozesse sind nicht auf allen Instances fehlerfrei.

Diese Meldungen weisen darauf hin, dass Ihre Load Balancer-Integritätsprüfungen bei einer oder mehreren Instances fehlschlagen. Wenn Ihre Anwendung zu funktionieren scheint, stellen Sie sicher, dass die URL für die Integritätsprüfung Ihrer Anwendung korrekt konfiguriert ist. Wenn nicht, versuchen Sie Folgendes:

Weitere Informationen erhalten Sie, wenn Sie die vollständigen Paketprotokolle abrufen oder das CloudWatch Protokollstreaming aktivieren. Sie können auch das AWSSupport-TroubleshootElasticBeanstalk Automatisierungs-Runbook ausführen, um das Problem zu diagnostizieren.

Ereignis: Elastic Load Balancer awseb — kann nicht gefunden werden myapp

Der Load Balancer der Umgebung ist möglicherweise außerplanmäßig entfernt worden. Nehmen Sie Änderungen an den Umgebungsressourcen nur mit den von Elastic Beanstalk bereitgestellten Konfigurationsoptionen und Erweiterungen vor. Erstellen Sie Ihre Umgebung erneut oder starten Sie eine neue Umgebung.

Ereignis: EC2-Instance konnte nicht gestartet werden. Warten auf den Start einer neuen EC2 Instance ...

Möglicherweise sind derzeit keine Instance-Typen für die Umgebung verfügbar oder das Instance-Kontingent für Ihr Konto wurde erreicht. Überprüfen Sie in der Übersicht zum Servicestatus-, ob der Elastic Compute Cloud (Amazon EC2)-Service den Status "Grün" aufweist, oder fordern Sie eine Kontingenterhöhung an.

Ereignis: Keine der Instanzen sendet Daten.

Elastic Beanstalk empfängt von keiner Ihrer Instances Gesundheitsdaten. Dies kann durch Probleme mit der Netzwerkkonnektivität, Probleme mit dem Health Agent oder Ausfälle auf Systemebene verursacht werden.

Weitere Informationen erhalten Sie, wenn Sie die vollständigen Paketprotokolle abrufen oder das CloudWatch Protokollstreaming aktivieren. Sie können auch das AWSSupport-TroubleshootElasticBeanstalk Automatisierungs-Runbook ausführen, um das Problem zu diagnostizieren.

Umgebungen mit Dual-Stack-konfigurierten Load Balancern

Ereignis: Für VPC sind vpc_id keine IPv6-CIDR-Blöcke konfiguriert. IPv6-CIDR-Blöcke sind für den DualStack-Load Balancer erforderlich. Bitte ordnen Sie Ihrer VPC einen IPv6-CIDR-Block zu, bevor Sie den Dualstack-Modus verwenden.

Ihrer VPC und allen Subnetzen müssen IPv6-CIDR-Blöcke zugeordnet sein. Dies ist eine der VPC-Voraussetzungen, die Sie erfüllen müssen, bevor Sie Ihren Load Balancer für die Dualstack-Unterstützung konfigurieren. Weitere Informationen zum Ausführen dieser Aufgabe finden Sie weiter Voraussetzungen für Amazon VPC oben in diesem Thema.

Ereignis: In einem oder mehreren Subnetzen für VPC sind vpc_id keine IPv6-CIDR-Blöcke konfiguriert. IPv6-CIDR-Blöcke sind für die Subnetze erforderlich, die mit dem DualStack-Load Balancer verwendet werden. Bitte ordnen Sie IPv6-CIDR-Blöcke allen erforderlichen Subnetzen zu, bevor Sie den Dualstack-Modus verwenden.

Allen Subnetzen für Ihre VPC müssen IPv6-CIDR-Blöcke zugeordnet sein. Dies ist eine der VPC-Voraussetzungen, die Sie erfüllen müssen, bevor Sie Ihren Load Balancer für die Dualstack-Unterstützung konfigurieren. Weitere Informationen zum Ausführen dieser Aufgabe finden Sie weiter Voraussetzungen für Amazon VPC oben in diesem Thema.

Fehler: Die IpAddressType Option kann nur auf Elastic Beanstalk-Umgebungen angewendet werden, die mit einem Application Load Balancer oder Network Load Balancer konfiguriert sind.

Diese Meldung weist darauf hin, dass es sich bei Ihrer Elastic Beanstalk-Umgebung möglicherweise um eine Einzelinstanzumgebung handelt oder dass sie möglicherweise einen Classic Load Balancer verwendet. Nur Umgebungen, die mit einem Application Load Balancer oder Network Load Balancer konfiguriert wurden, können konfiguriert werden. IpAddressType

Konfiguration

Ereignis: Der der Umgebung stack_id zugeordnete Stack environment-ID befindet sich im Status stack-status

Der zugrunde liegende CloudFormation Stack Ihrer Umgebung befindet sich möglicherweise im Status *_FAILED. Dieser Status muss behoben werden, damit der Elastic Beanstalk-Betrieb in Ihrer Umgebung fortgesetzt werden kann. Weitere Informationen finden Sie unter Wiederherstellung Ihrer Elastic Beanstalk Beanstalk-Umgebung aus einem ungültigen Zustand.

Ereignis: Es kann keine Elastic Beanstalk-Umgebung konfiguriert werden, die Werte für die Optionen "Elastic Load Balancing Target (Elastic Load Balancing-Ziel)" und "Application Healthcheck URL (URL für die Zustandsprüfung der Anwendung)" enthält.

Die Option Target im Namespace aws:elb:healthcheck ist veraltet. Entfernen Sie die Namespace-Option Target aus der Umgebung und führen Sie die Aktualisierung erneut aus.

Ereignis: ELB kann nicht mit mehreren Subnetzen in derselben AZ verbunden werden

Diese Meldung wird angezeigt, wenn Sie einen Load Balancer zwischen Subnetzen in derselben Availability Zone verschieben möchten. Sollen die Subnetze des Load Balancers geändert werden, muss dieser aus den ursprünglichen Availability Zones entfernt und mit den gewünschten Subnetzen wieder in diese eingefügt werden. Bei diesem Prozess werden alle Instances zwischen den Availability Zones migriert, was zu erheblichen Ausfallzeiten führt. Ziehen Sie stattdessen in Betracht, eine neue Umgebung zu erstellen und einen CNAME-Austausch durchzuführen.

Fehlerbehebung bei Docker-Containern

Ereignis: Docker-Image :latest: konnte nicht abgerufen werden. Ungültiger Repository-Name (), nur [a-z0-9-] sind zulässig. Weitere Details finden Sie in den Protokollfragmenten.

Prüfen Sie die Syntax der dockerrun.aws.json-Datei mit einer JSON-Validierung. Verifizieren Sie außerdem den dockerfile-Inhalt hinsichtlich der Anforderungen in Bereiten Sie Ihr Docker-Image für die Bereitstellung auf Elastic Beanstalk vor.

Ereignis: Keine EXPOSE-Anweisung in Dockerfile gefunden, Bereitstellung abbrechen

Die Dockerfile oder dockerrun.aws.json-Datei deklariert den Container-Port nicht. Verwenden Sie die EXPOSE-Anweisung (Dockerfile) oder den Ports-Block (dockerrun.aws.json-Datei), um einen Port für eingehenden Datenverkehr verfügbar zu machen.

Ereignis: Fehler beim Herunterladen der Anmeldeinformationen repository von bucket name

Der dockerrun.aws.json stellt ein ungültiges EC2-Schlüsselpaar and/or S3-Bucket für die .dockercfg Datei bereit. Oder das Instanzprofil ist nicht für den S3-Bucket GetObject autorisiert. Überprüfen Sie, ob die .dockercfg-Datei einen gültigen S3-Bucket und ein gültiges EC2-Schlüsselpaar enthält. Erteilen Sie Berechtigungen für die Aktion s3:GetObject für die IAM-Rolle im Instance-Profil. Details finden Sie unter Elastic Beanstalk Instance-Profile verwalten.

Ereignis: Aktivitätsausführung wegen Warnmeldung zur ungültigen "auth"-Konfigurationsdatei fehlgeschlagen

Die Authentifizierungsdatei (config.json) ist nicht ordnungsgemäß formatiert. Siehe Authentifizierung mit Image-Repositorys

Häufig gestellte Fragen

Frage: Wie kann ich meine Anwendungs-URL von myapp.us-west-2.elasticbeanstalk.com in www.myapp.com ändern?

Registrieren Sie bei einem DNS-Server einen CNAME-Datensatz, wie z. B. www.mydomain.com CNAME mydomain.elasticbeanstalk.com.

Frage: Wie gebe ich eine bestimmte Availability Zone für meine Elastic Beanstalk-Anwendung an?

Sie können eine bestimmte Availability Zone mithilfe der APIs, CLI, des Eclipse-Plug-In oder des Visual Studio-Plug-In auswählen. Für Anweisungen zum Angeben einer Availability Zone mit der Elastic Beanstalk-Konsole siehe Auto Scaling Ihrer Elastic Beanstalk Beanstalk-Umgebungsinstanzen.

Frage: Wie kann ich den Instance-Typ meiner Umgebung ändern?

Um den Instance-Typ Ihrer Umgebung zu ändern, rufen Sie die Seite Bearbeiten in der Konfigurationskategorie Instances auf. Wählen Sie dann einen neuen Instance-Typ aus und wählen Sie Anwenden, um Ihre Umgebung zu aktualisieren. Danach beendet Elastic Beanstalk alle laufenden Instances und ersetzt sie durch neue.

Frage: Wie stelle ich fest, ob jemand Konfigurationsänderungen an einer Umgebung vorgenommen hat?

Um diese Informationen anzuzeigen, wählen Sie im Navigationsbereich der Elastic-Beanstalk-Konsole den Änderungsverlauf, um eine Liste der Konfigurationsänderungen für alle Umgebungen anzuzeigen. Diese Liste enthält das Datum und die Uhrzeit der Änderung, den Konfigurationsparameter und den Wert, in den sie geändert wurde, sowie den IAM-Benutzer, der die Änderung vorgenommen hat. Weitere Informationen finden Sie unter Änderungsverlauf.

Frage: Kann ich verhindern, dass Amazon EBS-Volumes gelöscht werden, wenn Instances beendet werden?

Instances in Ihrer Umgebung verwenden Amazon EBS zur Speicherung. Das Stamm-Volume wird jedoch gelöscht, wenn eine Instance durch Auto Scaling beendet wird. Wir empfehlen nicht, dass Sie Status- oder andere Daten auf Ihren Instances speichern. Bei Bedarf können Sie das Löschen von Volumes mit dem AWS CLI: verhindern, dass Volumes gelöscht werden, $ aws ec2 modify-instance-attribute -b '/dev/sdc=<vol-id>:false wie in der AWS CLI Referenz beschrieben.

Frage: Wie lösche ich persönliche Informationen aus meiner Elastic Beanstalk-Anwendung?

AWS Ressourcen, die Ihre Elastic Beanstalk-Anwendung verwendet, speichern möglicherweise persönliche Informationen. Wenn Sie eine Umgebung beenden, beendet Elastic Beanstalk die erstellten Ressourcen. Die Ressourcen, die Sie mithilfe von Konfigurationsdateien hinzugefügt haben, werden ebenfalls beendet. Wenn Sie jedoch AWS Ressourcen außerhalb Ihrer Elastic Beanstalk-Umgebung erstellt und mit Ihrer Anwendung verknüpft haben, müssen Sie möglicherweise manuell überprüfen, ob personenbezogene Daten, die Ihre Anwendung möglicherweise gespeichert hat, nicht gespeichert werden. In diesem Entwicklerhandbuch erwähnen wir, wann immer wir über die Erstellung zusätzlicher Ressourcen sprechen, auch, wann Sie darüber nachdenken sollten, diese zu löschen.

Häufige Fehler

In diesem Thema werden häufig auftretende Fehlermeldungen im Zusammenhang mit der EB CLI-Verwendung sowie mögliche Lösungen aufgeführt. Falls Ihnen eine Fehlermeldung angezeigt wird, die hier nicht enthalten ist, teilen Sie uns dies bitte über die Feedback-Links mit.

FEHLER: Bei der Verarbeitung des Git-Befehls ist ein Fehler aufgetreten. Fehlercode: 128 Fehler: fatal: Kein gültiger Objektname HEAD

Ursache: Diese Fehlermeldung wird angezeigt, wenn Sie ein Git-Repository initialisiert, aber noch nicht übergeben haben. Wenn der Projektordner ein Git-Repository enthält, sucht die EB CLI nach einer HEAD-Revision.

Lösung: Fügen Sie die Dateien in Ihrem Projektordner zum Staging-Bereich hinzu und führen Sie den Commit aus:

~/my-app$ git add .
~/my-app$ git commit -m "First commit"

FEHLER: Dieser Zweig hat keine Standardumgebung. Sie müssen entweder eine Umgebung angeben, indem Sie „eb status my-env-name“ eingeben, oder eine Standardumgebung festlegen, indem Sie „eb use my-env-name“ eingeben.

Ursache: Wenn Sie in Git eine neue Verzweigung erstellen, wird dieser nicht standardmäßig einer Elastic Beanstalk-Umgebung zugewiesen.

Lösung: Führen Sie eb list aus, um eine Liste der verfügbaren Umgebungen aufzurufen. Führen Sie anschließend eb use env-name aus, um eine der verfügbaren Umgebungen zu verwenden.

FEHLER: Plattformen ab Version 2.0 erfordern eine Servicerolle. Sie können eine mit der Option --service-role angeben

Ursache: Wenn Sie einen Umgebungsnamen mit eb create angeben (z. B. eb create my-env), erstellt die EB CLI keine Servicerolle für Sie. Ist die standardmäßige Servicerolle nicht vorhanden, wird die obige Fehlermeldung angezeigt.

Lösung: Führen Sie eb create ohne den Umgebungsnamen aus und folgen Sie den Anweisungen, um die standardmäßige Servicerolle zu erstellen.

Fehler bei der Bereitstellung

Ihre Elastic Beanstalk-Bereitstellung reagiert möglicherweise mit einer 404-Antwort (wenn Ihre Anwendung nicht gestartet werden konnte) oder 500-Antwort (wenn Ihre Anwendung während der Laufzeit ausfällt). Um viele häufig auftretende Probleme zu beheben, können Sie die EB-CLI verwenden, um den Status Ihrer Bereitstellung zu überprüfen, die zugehörigen Protokolle einzusehen, mit SSH auf Ihre EC2-Instance zuzugreifen oder die AWS Management-Konsolenseite für Ihre Anwendungsumgebung zu öffnen.