# 透過 AWS Toolkit for JetBrains 使用 Amazon Elastic Container Service
<a name="ecs"></a>

下列主題說明如何透過 AWS Toolkit for JetBrains 使用 AWS 帳戶中的 Amazon ECS 資源。

**Topics**
+ [Amazon ECS Exec](ecs-exec.md)

# AWS 工具組 中的 Amazon Elastic Container Service (Amazon ECS) Exec
<a name="ecs-exec"></a>

您可以使用 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 進行偵錯](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 Exec，必須停用該服務的 Amazon ECS 雲端偵錯功能。

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

Amazon ECS Exec 的版本要求取決於您的任務是託管於 Amazon EC2 或 AWS Fargate：
+ 如果您使用的是 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="w7aac13c27b8c11b9"></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="w7aac13c27b8c15"></a>

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

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

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

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

1. 開啟要修改的服務之內容選單 (按一下滑鼠右鍵)，然後選擇**啟用命令執行**。
**注意**  
如果已對服務啟用 Amazon ECS Cloud Debugging，就無法使用**啟用命令執行**選項。停用 Cloud Debugging 後選項就會恢復，但是會停止您的服務並重新啟動。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 選擇 **Execute** (執行)。

### 從 Shell 中執行命令
<a name="w7aac13c27b8c15c11"></a>

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

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

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

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

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

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

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

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

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