新規のお客様への 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 の有効化
AWS Explorer から、Amazon ECS メニューを見つけて展開します。
変更するサービスを含むクラスターを拡張します。
サービスのコンテキストメニュー (右クリック) を開き、[Enable Command Execution] (コマンドの実行を有効にする) を選択します
重要
このステップにより、サービスの新規デプロイが開始されます。これには数分かかることがあります。詳細については、このセクションの冒頭にある注意事項を参照してください。
Amazon ECS Exec の無効化
AWS Explorer から、Amazon ECS メニューを見つけて展開します。
必要なサービスを含むクラスターを展開します。
サービスのコンテキストメニュー (右クリック) を開き、[Disable Commance Execution] (コマンド実行を無効にする) を選択します
重要
このステップにより、サービスの新規デプロイが開始されます。これには数分かかることがあります。詳細については、このセクションの冒頭にある注意事項を参照してください。
コンテナに対するコマンドの実行
AWS Explorer を使用してコンテナに対してコマンドを実行するには、Amazon ECS Exec を有効にする必要があります。有効になっていない場合は、このセクションの「 Amazon ECS Exec の有効化 」の手順を参照してください。
AWS Explorer から、Amazon ECS メニューを見つけて展開します。
必要なサービスを含むクラスターを展開します。
サービスを展開して、関連するコンテナを一覧表示します。
コンテナのコンテキストメニュー (右クリック) を開き、[Run Command in Container] (コンテナでコマンドを実行) を選択します
実行中のタスクのリストを含むプロンプトが開きます。必要なタスクの ARN を選択します。
注記
実行中のタスクが 1 つだけの場合、プロンプトは開きません。代わりに、タスクは自動選択されます。
プロンプトが表示されたら、実行するコマンドを入力し、Enter キーを押して続行します。