翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# の 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 Exec の前提条件
<a name="ecs-exec-prereq"></a>

Amazon ECS の機能を使用する前に、いくつかの前提条件を満たす必要があります。

### 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 以降を使用する必要があります。Fargate の要件に関する補足情報は、デベロッパーガイド「[AWS Fargate プラットフォームバージョン](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html)」に記載されています。

### AWS アカウント設定と IAM アクセス許可
<a name="w2aac17c35c10c11b7"></a>

Amazon ECS Exec 機能を使用するには、 AWS アカウントに関連付けられた既存の Amazon ECS クラスターが必要です。Amazon ECS Exec は Systems Manager を使用してクラスター内のコンテナとの接続を確立します。SSM サービスと通信するには、特定のタスクの IAM ロールのアクセス許可が必要です。

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 Commance 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 つだけの場合、そのタスクは自動的に選択され、このステップはスキップされます。

1. プロンプトが表示されたら、実行するコマンドを入力し、**Enter** キーを押して処理します。