本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 中的 Amazon Elastic Container Service Exec AWS Toolkit for Visual Studio Code
<a name="ecs-exec"></a>

您可以使用 Amazon ECS Exec 功能 AWS Toolkit for Visual Studio Code，透過 在 Amazon Elastic Container Service (Amazon ECS) 容器中發出單一命令。

**重要**  
啟用和停用 Amazon ECS Exec 會變更您 AWS 帳戶中資源的狀態。包括停止和重新啟動服務。若在啟用 Amazon ECS Exec 時變更資源狀態，可能會導致無法預期的結果。如需 Amazon ECS 的詳細資訊，請參閱開發人員指南[使用 Amazon ECS Exec 進行偵錯](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html#ecs-exec-considerations)。

## Amazon ECS Exec 的先決條件
<a name="ecs-exec-prereq"></a>

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

### Amazon ECS 要求
<a name="w2aac17c35c10c11b5"></a>

視您的任務是託管在 Amazon EC2 還是 而定 AWS Fargate，Amazon ECS Exec 有不同的版本需求。
+ 如果您使用的是 Amazon EC2，則必須使用在 2021 年 1 月 20 日之後發行的 Amazon ECS 最佳化 AMI，且代理程式版本為 1.50.2 或更高版本。您可以在開發人員指南[《Amazon ECS 最佳化 AMI》](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html)中取得其他資訊。
+ 如果您使用的是 AWS Fargate，則必須使用平台版本 1.4.0 或更新版本。您可以在開發人員指南[《AWS Fargate 平台版本》](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html)中獲得有關 Fargate 要求的其他資訊。

### AWS 帳戶組態和 IAM 許可
<a name="w2aac17c35c10c11b7"></a>

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

如需 Amazon ECS Exec 專屬的 IAM 角色和政策資訊，請參閱[《ECS Exec 所需的 IAM 許可》](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html#ecs-exec-enabling-and-using)開發人員指南。

## 使用 Amazon ECS Exec
<a name="w2aac17c35c10c15"></a>

您可以在 Toolkit for VS Code 中直接從 AWS Explorer 啟用或停用 Amazon ECS Exec。啟用 Amazon ECS Exec 後，您可以從 Amazon ECS 功能表中選擇容器，然後對其執行命令。

### 啟用 Amazon ECS Exec
<a name="w2aac17c35c10c15b5"></a>

1. 從 AWS Explorer 找到並展開 Amazon ECS 功能表。

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

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

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

### 停用 Amazon ECS Exec
<a name="w2aac17c35c10c15b7"></a>

1. 從 AWS Explorer 找到並展開 Amazon ECS 功能表。

1. 展開存放所需服務的叢集。

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

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

### 針對容器執行命令
<a name="w2aac17c35c10c15b9"></a>

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

1. 從 AWS Explorer 找到並展開 Amazon ECS 功能表。

1. 展開存放所需服務的叢集。

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

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

1. 將開啟一個**提示**，其中包含執行中的任務清單，選擇您想要**的任務 ARN**。
**注意**  
如果該服務只執行一個任務，則會自動選取該任務，並略過此步驟。

1. 出現提示時，輸入您要執行的命令，然後按 **Enter** 來處理。