Ausführen von Befehlen mit ECS Exec

Sie können Amazon ECS Exec verwenden, um Diagnoseinformationen zu Ihren Containern zu sammeln und Fehler zu beheben, die während des gesamten Lebenszyklus Ihrer Container auftreten.

Voraussetzungen

Bevor Sie mit der Verwendung von ECS Exec beginnen, stellen Sie sicher, dass Sie die folgenden Aktionen abgeschlossen haben:

• Lesen Sie sich die Überlegungen durch. Weitere Informationen finden Sie unter Überlegungen .

• Konfigurieren Sie ECS Exec für Ihre Aufgaben und Dienste. Weitere Informationen finden Sie unter Konfiguration von ECS Exec.

• Installieren und konfigurieren Sie die AWS CLI. Weitere Informationen finden Sie unter Erste Schritte mit dem AWS CLI.

• Installieren Sie das Session Manager-Plug-In für AWS CLI. Weitere Informationen finden Sie unter Installieren des Session Manager-Plugins für AWS CLI.

• Konfigurieren Sie eine Aufgabenrolle mit den entsprechenden Berechtigungen. Sie müssen eine Aufgabenrolle mit den entsprechenden Berechtigungen für ECS Exec verwenden. Weitere Informationen finden Sie unter Aufgaben-IAM-Rollen.

• Überprüfen Sie die Versionsanforderungen. Für ECS Exec gelten Versionsanforderungen, die davon abhängen, ob Ihre Aufgaben bei Amazon gehostet werden EC2 oder AWS Fargate:

  • Wenn Sie Amazon verwenden EC2, müssen Sie ein für Amazon ECS optimiertes AMI verwenden, das nach dem 20. Januar 2021 veröffentlicht wurde, mit einer Agentenversion von 1.50.2 oder höher. Weitere Informationen finden Sie unter Amazon ECS-optimiert AMIs.

  • Wenn Sie verwenden AWS Fargate, müssen Sie die Plattformversion 1.4.0 oder höher (Linux) oder 1.0.0 (Windows) verwenden. Weitere Informationen finden Sie unter AWS Fargate -Plattformversionen.

Verwenden der Konsole für Serviceaufgaben

Sie können die Konsole verwenden, um Befehle mit ECS Exec auszuführen.

1. Öffnen Sie die Konsole auf https://console.aws.amazon.com/ecs/Version 2.

2. Wählen Sie auf der Cluster-Seite den Cluster aus.

3. Wählen Sie auf der Seite mit den Cluster-Details im Abschnitt Dienste den Dienst aus.

   Die Seite mit den Dienstdetails wird angezeigt.

4. Wählen Sie auf der Seite mit den Servicedetails die Option Aufgaben aus. Wählen Sie dann die Aufgabe aus.

5. Wählen Sie unter Container den Container aus, in dem Sie ECS Exec verwenden möchten.

6. Um Befehle auszuführen:, führen Sie einen der folgenden Schritte aus:

   • Wählen Sie Connect aus.

     Es wird eine CloudShell Sitzung angezeigt, in der Sie Ihre Befehle ausführen können.

   • Wählen Sie den Pfeil und dann den AWS CLI Befehl Kopieren.

     Sie können die Befehle dann lokal ausführen.

Erwartete Ergebnisse

Wenn die Verbindung erfolgreich ist, sollten Sie in Ihrem Container eine interaktive Shell-Eingabeaufforderung sehen. Sie können Befehle jetzt direkt in der Container-Umgebung ausführen. Um die Sitzung zu beenden, wählen Sie Sitzung beenden.

Verwenden der Konsole für eigenständige Aufgaben

Sie können die Konsole verwenden, um Befehle mit ECS Exec auszuführen.

1. Öffnen Sie die Konsole auf https://console.aws.amazon.com/ecs/Version 2.

2. Wählen Sie auf der Cluster-Seite den Cluster aus.

3. Wählen Sie auf der Seite mit den Cluster-Details im Abschnitt Aufgaben die Aufgabe aus.

   Die Seite mit den Aufgabendetails wird angezeigt.

4. Wählen Sie unter Container den Container aus, in dem Sie ECS Exec verwenden möchten.

5. Um Befehle auszuführen:, führen Sie einen der folgenden Schritte aus:

   • Wählen Sie Connect aus.

     Es wird eine CloudShell Sitzung angezeigt, in der Sie Ihre Befehle ausführen können.

   • Wählen Sie den Pfeil und dann den AWS CLI Befehl Kopieren.

     Sie können die Befehle dann lokal ausführen.

Erwartete Ergebnisse

Wenn die Verbindung erfolgreich ist, sollten Sie in Ihrem Container eine interaktive Shell-Eingabeaufforderung sehen. Sie können Befehle jetzt direkt in der Container-Umgebung ausführen. Um die Sitzung zu beenden, wählen Sie Sitzung beenden.

Verwenden Sie die Befehlsshell

Sie können die Befehlsshell verwenden, um Befehle mit ECS Exec auszuführen.

Nachdem Sie bestätigt haben, dass ExecuteCommandAgent ausgeführt wird, können Sie eine interaktive Shell in Ihrem Container mit dem folgenden Befehl öffnen. Wenn Ihre Aufgabe mehrere Container enthält, müssen Sie den Containernamen mithilfe des --container-Flag angeben. Amazon ECS unterstützt nur das Initiieren interaktiver Sitzungen. Daher müssen Sie das --interactive-Flag verwenden.

Mit dem folgenden Befehl wird ein interaktiver /bin/sh Befehl container-name für einen Container ausgeführt, der nach einer Aufgabe mit der task-id ID benannt ist.

Das task-id ist der Amazon-Ressourcenname (ARN) der Aufgabe.

aws ecs execute-command --cluster cluster-name \
    --task task-id \
    --container container-name \
    --interactive \
    --command "/bin/sh"

Erwartete Ergebnisse

Wenn der Befehl erfolgreich ist, sollten Sie in Ihrem Container eine interaktive Shell-Eingabeaufforderung sehen. Sie können Befehle jetzt direkt in der Container-Umgebung ausführen. Um die Sitzung zu beenden, geben Sie ein exit oder drücken SieCtrl+D.