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 ECS Exec verwenden, stellen Sie sicher, dass Sie die folgenden Aktionen ausgeführt haben:

• Überlegungen überprüfen Weitere Informationen finden Sie unter Überlegungen .

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

• Installieren und Konfigurieren der AWS CLI. Weitere Informationen finden Sie unter Erste Schritte mit der 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 Befehle mit ECS Exec mithilfe der Konsole ausfü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 Services den Service aus.

   Die Seite mit den Service-Details wird angezeigt.

4. Wählen Sie auf der Servie-Detailseite 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. Gehen Sie folgendermaßen vor, um Befehle auszuführen:

   • 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 Befehl AWS CLI -Kopieren aus.

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

Erwartete Ergebnisse

Wenn die Verbindung erfolgreich ist, sollten Sie in Ihrem Container ein interaktives Shell-Prompt 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 Befehle mit ECS Exec mithilfe der Konsole ausfü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. Gehen Sie folgendermaßen vor, um Befehle auszuführen:

   • 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 Befehl AWS CLI -Kopieren aus.

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

Erwartete Ergebnisse

Wenn die Verbindung erfolgreich ist, sollten Sie in Ihrem Container ein interaktives Shell-Prompt 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 Command Shell

Sie können Befehle mit ECS Exec mithilfe der Command Shell ausfü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 ID benannt isttask-id.

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 ausgeführt wurde, sollte ein interaktives Shell-Prompt von Ihrem Container aus angezeigt werden. Sie können Befehle jetzt direkt in der Container-Umgebung ausführen. Um die Sitzung zu beenden, geben Sie exit ein oder wählen Sie Ctrl+D.