Amazon 彈性容器服務執行 AWS Toolkit for Visual Studio Code

您可以使用 Amazon ECS Exec 功能在 Amazon 彈性容器服務（亞馬遜 ECS）容器中發出單個命令。AWS Toolkit for Visual Studio Code

重要

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

Amazon ECS Exec 的先決條件

在您可以使用 Amazon ECS Exec 功能之前，需要滿足一些先決條件。

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 功能，您必須有一個現有的 Amazon ECS 叢集與您的帳戶相關聯。AWSAmazon ECS Exec 使用 Systems Manager 來與叢集中的容器建立連線，且需要特定的任務 IAM 角色許可才能與 SSM 服務通訊。

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

使用 Amazon ECS Exec

您可以直接從 Toolkit for VS Code 中的AWS資源管理器啟用或停用 Amazon ECS Exec。啟用 Amazon ECS Exec 後，您可以從 Amazon ECS 功能表中選擇容器，然後對它們執行命令。

啟用 Amazon ECS Exec

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

2. 使用您要修改的服務展開叢集。

3. 開啟服務的內容功能表 (按一下滑鼠右鍵)，然後選擇 Enable Command Execution (啟用命令執行)。

重要

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

停用 Amazon ECS Exec

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

2. 展開容納所需服務的叢集。

3. 開啟服務的內容功能表 (按一下滑鼠右鍵)，然後選擇 Disable Command Execution (停用命令執行)。

重要

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

針對容器執行命令

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

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

2. 展開容納所需服務的叢集。

3. 展開服務以列出關聯的容器。

4. 開啟 (按一下滑鼠右鍵) 容器的內容選單，然後選擇 Run Command in Container (在容器中執行命令)。

5. 將打開一個提示，其中包含正在運行的任務列表，選擇所需的任務 ARN。

   注意

   如果該服務只有一個工作正在執行，則會自動選取該工作，並略過此步驟。

6. 出現提示時，鍵入要運行的命令，然後按 Enter 進行處理。