Amazon ECS CLI の設定 - Amazon Elastic Container Service

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Amazon ECS CLI の設定

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

Amazon ECS CLI を構成するには

  1. 次のコマンドを使用して、CLI プロファイルをセットアップします。プロファイル名 希望するプロファイル名で $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. 次のコマンドを使用して、コンフィグレーションを完了します。起動_タイプ 初期設定で使用したいタスク起動タイプ 地域名 希望する AWS 地域、クラスタ名 既存の 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 ECS コマンドライン参照Amazon Elastic Container Service Developer Guide.

Profiles

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

詳細については、 Amazon ECS コマンドライン参照Amazon Elastic Container Service Developer Guide.

クラスター設定

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

詳細については、 Amazon ECS コマンドライン参照Amazon Elastic Container Service Developer Guide.

優先順位

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

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

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

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

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

  2. 環境変数。

    1. ECS_PROFILE

    2. AWS_PROFILE

    3. AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY、および AWS_SESSION_TOKEN

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

  4. デフォルトの AWS プロファイル — AWS プロファイル名から認証情報 (aws_access_key_idaws_secret_access_key) または assume_role (role_arnsource_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).