AWS 工具組 中的 Amazon Elastic Container Service (Amazon ECS) Exec - AWS Toolkit for JetBrains
Amazon ECS Exec 的先決條件 使用 Amazon ECS Exec

AWS 工具組 中的 Amazon Elastic Container Service (Amazon ECS) Exec

您可以使用 Amazon ECS Exec 功能，或透過 AWS 工具組 直接在 Amazon Elastic Container Service (Amazon ECS) 容器中執行 Shell。

重要

啟用和停用 Amazon ECS Exec 會變更您 AWS 帳戶中的 ECS 資源狀態。包括停止和重新啟動服務。若在啟用 Amazon ECS Exec 時變更資源狀態，可能會導致無法預期的結果。如需 Amazon ECS Exec 的詳細資訊，請參閱開發人員指南中的使用 Amazon ECS Exec 進行偵錯。

Amazon ECS Exec 的先決條件

您必須符合先決條件，才能使用 Amazon ECS Exec 功能。

重要

若要針對特定服務啟用 Amazon ECS Exec，必須停用該服務的 Amazon ECS 雲端偵錯功能。

Amazon ECS 要求

Amazon ECS Exec 的版本要求取決於您的任務是託管於 Amazon EC2 或 AWS Fargate (Fargate)：

  • 如果您使用的是 Amazon EC2，則必須使用在 2021 年 1 月 20 日之後發行的 Amazon ECS 最佳化 AMI，且代理程式版本為 1.50.2 或更高版本。您可以在開發人員指南《Amazon ECS 最佳化 AMI》中取得其他資訊。

  • 如果您使用的是 AWS Fargate，則必須使用平台版本 1.4.0 或更新版本。您可以在開發人員指南《AWS Fargate 平台版本》中獲得有關 Fargate 要求的其他資訊。

AWS 帳戶組態和 IAM 許可

若要使用 Amazon ECS Exec 功能，您必須擁有與您的 AWS 帳戶 關聯的 Amazon ECS 叢集。Amazon ECS Exec 使用 Systems Manager 來與叢集中的容器建立連線，且需要特定的任務 IAM 角色許可才能與 SSM 服務通訊。

如需 Amazon ECS Exec 專屬的 IAM 角色和政策資訊，請參閱《ECS Exec 所需的 IAM 許可》開發人員指南。

使用 Amazon ECS Exec

您可以直接從 AWS 中的 AWS Toolkit for JetBrains Explorer 啟用或停用 Amazon ECS Exec。啟用 Amazon ECS Exec 後，您可以從 Amazon ECS 選單中選擇容器，然後對它們執行命令。

啟用 Amazon ECS Exec

  1. 在 AWS Explorer 中，展開 Amazon ECS 選單。

  2. 展開叢集區段，然後選擇要修改的叢集。

  3. 開啟要修改的服務之內容選單 (按一下滑鼠右鍵)，然後選擇啟用命令執行。

    注意

    如果已對服務啟用 Amazon ECS Cloud Debugging，就無法使用啟用命令執行選項。停用 Cloud Debugging 後選項就會恢復，但是會停止您的服務並重新啟動。

重要

此操作會啟動服務的新部署，可能需要幾分鐘的時間。如需詳細資訊，請參閱本節開頭的附註。)

停用 Amazon ECS Exec

  1. 在 AWS Explorer 中，展開 Amazon ECS 選單。

  2. 展開叢集區段，然後選擇要修改的叢集。

  3. 開啟要修改的服務之內容選單 (按一下滑鼠右鍵)，然後選擇停用命令執行。

重要

此操作會啟動服務的新部署，可能需要幾分鐘的時間。如需詳細資訊，請參閱本節開頭的附註。

針對容器執行命令

若要使用 AWS Explorer 對容器執行命令，必須啟用 Amazon ECS Exec。如果未啟用，請參閱本節中的啟用 Amazon ECS Exec 程序。

  1. 在 AWS Explorer 中，展開 Amazon ECS 選單。

  2. 展開叢集區段，然後選擇要修改的叢集。

  3. 展開服務以列出其容器。

  4. 開啟 (按一下滑鼠右鍵) 要修改的容器之內容選單，然後選擇在容器中執行命令。

  5. 於在容器中執行命令對話方塊中，選擇需要的任務 ARN。

  6. 您可以輸入要執行的命令，或從相同工作階段期間執行的命令清單中選取。

  7. 選擇 Execute (執行)。

從 Shell 中執行命令

若要從 Shell 中使用 AWS Explorer 對容器執行命令，必須啟用 Amazon ECS Exec。如果未啟用，請參閱本節中的啟用 Amazon ECS Exec 程序。

  1. 在 AWS Explorer 中，展開 Amazon ECS 選單。

  2. 展開叢集區段，然後選擇要修改的叢集。

  3. 展開服務以列出其容器。

  4. 開啟 (按一下滑鼠右鍵) 要修改的容器之內容選單，然後選擇開啟互動式 Shell。

  5. 在互動式 Shell 對話方塊中，選擇需要的任務 ARN。

  6. 從對應的下拉式清單中選擇一個 Shell，或輸入您互動的 Shell 名稱。

  7. 當您對這些設定感到滿意時，選擇執行。

  8. 當 Shell 在終端中打開時，您可以輸入與容器進行互動的命令。