Amazon ECS CLI の設定 - Amazon Elastic Container Service
プロファイルクラスター設定優先順位

Amazon ECS CLI の設定

Amazon ECS は、コマンドラインインターフェイス (CLI) ツールである、AWS Copilot をリリースしました。これにより、ローカル開発環境から、Amazon ECS での本番稼働対応のコンテナ化されたアプリケーションの構築、リリース、および運用を簡素化します。詳細については、「AWS Copilot コマンドラインインターフェイスの使用」を参照してください。

Amazon ECS CLI を使用するには、AWS 認証情報、クラスターを作成する AWS リージョン、および Amazon ECS クラスターで使用する名前などの基本設定情報がいくつか必要です。設定情報は macOS および Linux システムでは ~/.ecs ディレクトリに、Windows システムでは C:\Users\<username>\AppData\local\ecs に保存されます。

ステップ 1: Amazon ECS CLI を設定する

  1. 次のコマンドを使用して CLI プロファイルを設定し、profile_name を希望のプロファイル名に、$AWS_ACCESS_KEY_ID および $AWS_SECRET_ACCESS_KEY 環境変数を AWS 認証情報に置き換えます。

    ecs-cli configure profile --profile-name profile_name --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY

  2. 次のコマンドで設定を完了させて、launch_type をデフォルトで使用するタスク起動タイプに、region_name を目的の AWS リージョンに、cluster_name を使用する既存の Amazon ECS クラスターまたは新しいクラスターの名前に、configuration_name をこの設定に付ける名前に置き換えます。

    ecs-cli configure --cluster cluster_name --default-launch-type launch_type --region region_name --config-name configuration_name

CLI をインストールして設定すると、「チュートリアル: Amazon ECS CLI を使用して Fargate タスクのクラスターを作成する」を実行できます。詳細については、Amazon Elastic Container Service 開発者ガイドのAmazon ECS コマンドラインリファレンスを参照してください。

プロファイル

Amazon ECS CLI は、ecs-cli configure profileコマンドを使用して、プロファイルという名前の複数のAWS認証情報のセットの設定をサポートします。デフォルトのプロファイルは、ecs-cli configure profile default コマンドを使用して設定できます。これらのプロファイルは、--ecs-profile フラグを使用する認証情報を必要とする Amazon ECS CLI コマンドを実行するときに参照できます。それ以外の場合、デフォルトのプロファイルが使用されます。

詳細については、Amazon Elastic Container Service 開発者ガイドのAmazon ECS コマンドラインリファレンスを参照してください。

クラスター設定

クラスター設定は、クラスターの名前とリージョンを含む、Amazon ECS クラスターを説明する一連のフィールドです。デフォルトのクラスタープロファイルは、ecs-cli configure default コマンドを使用して設定できます。Amazon ECS CLI は、--config-name オプションを使用した複数の名前付きクラスター設定の指定をサポートしています。

詳細については、Amazon Elastic Container Service 開発者ガイドのAmazon ECS コマンドラインリファレンスを参照してください。

優先順位

認証情報とリージョンの両方を Amazon ECS CLI コマンドで渡すには、複数の方法があります。以下に示しているのは、それぞれの優先順位です。

認証情報の優先順位は次のとおりです。

  1. Amazon ECS CLI プロファイルフラグ:

    1. Amazon ECS プロファイル (--ecs-profile)

    2. AWSプロファイル--aws-profile

  2. 環境変数:

    1. ECS_PROFILE

    2. AWS_PROFILE

    3. AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、および AWS_SESSION_TOKEN

  3. ECS config‐デフォルトの ECS プロファイルから認証情報の取得を試みます.

  4. デフォルトの AWS プロファイル ‐ AWS プロファイル名から認証情報 (aws_access_key_id、aws_secret_access_key) または assume_role (role_arn、source_profile) の使用を試みます

    1. AWS_DEFAULT_PROFILE 環境変数 (デフォルトは default).

  5. EC2 インスタンスロール

リージョンの優先順位は次のとおりです。

  1. Amazon ECS CLI フラグ:

    1. リージョンフラグ (--region)

    2. クラスター config フラグ (--cluster-config)

  2. ECS config‐デフォルトの ECS プロファイルからリージョンの取得を試みます.

  3. 環境変数—次の環境変数からリージョンの取得を試みます

    1. AWS_REGION

    2. AWS_DEFAULT_REGION

  4. AWS プロファイル ‐ AWS プロファイル名からリージョンの使用を試みます:

    1. AWS_PROFILE 環境変数

    2. AWS_DEFAULT_PROFILE 環境変数 (デフォルトは default)