AWS Toolkit for AWS Cloud9 の Amazon ECS Exec - AWS Cloud9

新規のお客様への AWS Cloud9 の提供は終了しました。AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

AWS Toolkit for AWS Cloud9 の Amazon ECS Exec

Amazon Elastic Container Service (Amazon ECS) コンテナで、AWS Toolkit for AWS Cloud9 により 1 つのコマンドを実行できます。この操作は、Amazon Exec の機能を使用して行うことができます。

重要

Amazon ECS Exec を有効または無効にすると、AWS アカウントでの ECS リソースの状態が変わります。変更には、サービスの停止と再起動が含まれます。さらに、Amazon ECS Exec が有効になっている間にリソースの状態を変更すると、予期しない結果が生じる可能性があります。Amazon ECS の詳細については、Amazon ECS デベロッパーガイドの「Amazon ECS Exec を使用してデバッグする」を参照してください。

Amazon Exec の前提条件

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

Amazon ECS の要件

Amazon ECS Exec には、タスクが Amazon EC2 でホストされているか AWS Fargate でホストされているかに応じて、異なるバージョン要件があります。

  • Amazon EC2 を使用する場合は、2021 年 1 月 20 日以降にリリースされた Amazon ECS 最適化 AMI を、エージェントバージョン 1.50.2 以降で使用する必要があります。詳細については、Amazon ECS デベロッパーガイドの「Amazon ECS に最適化された AMI」を参照してください。

  • AWS Fargate を使用する場合は、プラットフォームバージョン 1.4.0 以降を使用する必要があります。詳細については、Amazon ECS デベロッパーガイドの「AWS Fargate プラットフォームのバージョン」を参照してください。

AWS アカウントの設定と IAM のアクセス許可

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

Amazon ECS Exec に固有の IAM ロールとポリシーについては、Amazon ECS デベロッパーガイドの「ECS Exec に必要な IAM アクセス許可」を参照してください。

Amazon ECS Exec の操作

Amazon ECS Exec は、AWS Toolkit for AWS Cloud9 の AWS Explorer から直接有効または無効にできます。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 Commance Execution] (コマンド実行を無効にする) を選択します

重要

このステップにより、サービスの新規デプロイが開始されます。これには数分かかることがあります。詳細については、このセクションの冒頭にある注意事項を参照してください。

コンテナに対するコマンドの実行

AWS Explorer を使用してコンテナに対してコマンドを実行するには、Amazon ECS Exec を有効にする必要があります。有効になっていない場合は、このセクションの「 Amazon ECS Exec の有効化 」の手順を参照してください。

  1. AWS Explorer から、Amazon ECS メニューを見つけて展開します。

  2. 必要なサービスを含むクラスターを展開します。

  3. サービスを展開して、関連するコンテナを一覧表示します。

  4. コンテナのコンテキストメニュー (右クリック) を開き、[Run Command in Container] (コンテナでコマンドを実行) を選択します

  5. 実行中のタスクのリストを含むプロンプトが開きます。必要なタスクの ARN を選択します。

    注記

    実行中のタスクが 1 つだけの場合、プロンプトは開きません。代わりに、タスクは自動選択されます。

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