Amazon Elastic Container Service (Amazon ECS) Exec in AWS Toolkit
Sie können die Amazon-ECS-Exec-Funktion verwenden, um einzelne Befehle oder eine Shell in einem Amazon Elastic Container Service (Amazon ECS)-Container direkt über das AWS Toolkit auszuführen.
Wichtig
Durch Aktivieren und Deaktivieren von Amazon ECS Exec ändert sich der Zustand von Ressourcen in Ihrem AWS-Konto. Dies beinhaltet das Beenden und Neustarten des Service. Das Ändern des Ressourcenzustands bei aktiviertem Amazon ECS Exec kann zu unvorhersehbaren Ergebnissen führen. Weitere Informationen zu Amazon ECS Exec finden Sie im Entwicklerhandbuch unter Verwenden von Amazon ECS Exec zum Debuggen.
Voraussetzungen für Amazon ECS Exec
Um die Amazon-ECS-Exec-Funktion verwenden zu können, müssen bestimmte Voraussetzungen erfüllt sein.
Wichtig
Wenn Sie Amazon ECS Exec für einen bestimmten Service aktivieren möchten, muss das Cloud-Debugging von Amazon ECS für diesen Service deaktiviert werden.
Amazon-ECS-Anforderungen
Die Versionsanforderungen von Amazon ECS Exec sind abhängig davon, ob Ihre Aufgaben in Amazon EC2 oder in AWS Fargate (Fargate) gehostet werden.
-
Wenn Sie Amazon EC2 verwenden, müssen Sie ein für Amazon ECS optimiertes AMI verwenden, das nach dem 20. Januar 2021 mit einer Agent-Version von 1.50.2 oder höher veröffentlicht wurde. Weitere Informationen finden Sie im Entwicklerhandbuch unter Für Amazon ECS optimierte AMIs.
-
Verwenden Sie AWS Fargate, müssen Sie die Plattformversion 1.4.0 oder höher verwenden. Weitere Informationen zu Fargate-Anforderungen finden Sie im Entwicklerhandbuch unter AWS Fargate-Plattformversionen.
AWS-Kontokonfiguration und IAM-Berechtigungen
Für die Verwendung der Amazon-ECS-Exec-Funktion benötigen Sie einen Amazon-ECS-Cluster, der Ihrem AWS-Konto zugeordnet ist. Amazon ECS Exec verwendet Systems Manager, um eine Verbindung mit den Containern in Ihrem Cluster herzustellen, und benötigt spezifische Berechtigungen vom Typ „IAM-Rolle für Aufgabe“, um mit dem SSM-Service zu kommunizieren.
Spezifische Informationen zu IAM-Rollen und Richtlinien für Amazon ECS Exec finden Sie im Entwicklerhandbuch unter Erforderliche IAM-Berechtigungen für ECS Exec.
Arbeiten mit Amazon ECS Exec
Sie können Amazon ECS Exec direkt über den AWS Explorer im AWS Toolkit for JetBrains aktivieren oder deaktivieren. Wenn Amazon ECS Exec aktiviert ist, können Sie Container über das Menü „Amazon ECS“ auswählen und dann Befehle für sie ausführen.
Aktivieren von Amazon ECS Exec
-
Erweitern Sie im AWS Explorer das Menü „Amazon ECS“.
-
Erweitern Sie den Abschnitt Cluster und wählen Sie den Cluster aus, den Sie ändern möchten.
-
Öffnen Sie per Rechtsklick das Kontextmenü für den Service, den Sie ändern möchten, und wählen Sie Befehlsausführung aktivieren aus.
Anmerkung
Wenn für diesen Service das Cloud-Debugging von Amazon ECS aktiviert ist, ist die Option Befehlsausführung aktivieren nicht verfügbar. Wenn Sie das Cloud-Debugging deaktivieren, ist die Option wieder verfügbar. Der Service wird allerdings beendet und neu gestartet.
Wichtig
Dadurch wird eine neue Bereitstellung Ihres Service gestartet, was einige Minuten dauern kann. Weitere Informationen finden Sie im Hinweis am Anfang dieses Abschnitts.
Deaktivieren von Amazon ECS Exec
-
Erweitern Sie im AWS Explorer das Menü „Amazon ECS“.
-
Erweitern Sie den Abschnitt Cluster und wählen Sie den Cluster aus, den Sie ändern möchten.
-
Öffnen Sie per Rechtsklick das Kontextmenü für den Service, den Sie ändern möchten, und wählen Sie Befehlsausführung deaktivieren aus.
Wichtig
Dadurch wird eine neue Bereitstellung Ihres Service gestartet, was einige Minuten dauern kann. Weitere Informationen finden Sie im Hinweis am Anfang dieses Abschnitts.
Ausführen von Befehlen für einen Container
Wenn Sie Befehle für einen Container mithilfe des AWS Explorers ausführen möchten, muss Amazon ECS Exec aktiviert sein. Wenn es nicht aktiviert ist, lesen Sie die Vorgehensweise Aktivieren von Amazon ECS Exec in diesem Abschnitt.
-
Erweitern Sie im AWS Explorer das Menü „Amazon ECS“.
-
Erweitern Sie den Abschnitt Cluster und wählen Sie den Cluster aus, den Sie ändern möchten.
-
Erweitern Sie einen Service, um die zugehörigen Container aufzulisten.
-
Öffnen Sie per Rechtsklick das Kontextmenü für den Container, den Sie ändern möchten, und wählen Sie Befehl im Container ausführen aus.
-
Wählen Sie im Dialogfeld Befehl im Container ausführen den gewünschten Aufgaben-ARN aus.
-
Sie können den auszuführenden Befehl entweder eingeben oder ihn aus einer Liste von Befehlen auswählen, die während der gleichen Sitzung ausgeführt wurden.
-
Auswählen von Execute (Ausführen)
Ausführen von Befehlen über eine Shell
Wenn Sie Befehle für einen Container über eine Shell ausführen und dabei den AWS Explorer verwenden möchten, muss Amazon ECS Exec aktiviert sein. Wenn es nicht aktiviert ist, lesen Sie die Vorgehensweise Aktivieren von Amazon ECS Exec in diesem Abschnitt.
-
Erweitern Sie im AWS Explorer das Menü „Amazon ECS“.
-
Erweitern Sie den Abschnitt Cluster und wählen Sie den Cluster aus, den Sie ändern möchten.
-
Erweitern Sie den Service, um die zugehörigen Container aufzulisten.
-
Öffnen Sie per Rechtsklick das Kontextmenü für den Container, den Sie ändern möchten, und wählen Sie Interaktive Shell öffnen aus.
-
Wählen Sie im Dialogfeld Interaktive Shell den gewünschten Aufgaben-ARN aus.
-
Wählen Sie eine Shell aus dem entsprechenden Dropdown-Menü aus, oder geben Sie den Namen der Shell ein, mit der Sie interagieren möchten.
-
Wählen Sie Ausführen aus, wenn Sie mit Ihren Einstellungen zufrieden sind.
-
Wenn die Shell in einem Terminal geöffnet wird, können Sie Befehle eingeben, um mit dem Container zu interagieren.