Amazon ECS CLI の設定
Amazon ECS CLI を使用するには、AWS 認証情報、クラスターを作成する AWS リージョン、および Amazon ECS クラスターで使用する名前などの基本設定情報がいくつか必要です。設定情報は
macOS および Linux システムでは ~/.ecs
ディレクトリに、Windows システムでは C:\Users\
に保存されます。
<username>
\AppData\local\ecs
Amazon ECS CLI を構成するには
-
次のコマンドを使用して CLI プロファイルを設定し、
を希望のプロファイル名に、profile_name
および$AWS_ACCESS_KEY_ID
環境変数を AWS 認証情報に置き換えます。$AWS_SECRET_ACCESS_KEY
ecs-cli configure profile --profile-name
profile_name
--access-key$AWS_ACCESS_KEY_ID
--secret-key$AWS_SECRET_ACCESS_KEY
-
次のコマンドで設定を完了し、
をデフォルトで使用するタスク起動タイプに、launch_type
を希望の AWS リージョンに、region_name
を使用する既存の Amazon ECS クラスターまたは新しいクラスターの名前に、cluster_name
をこの設定に付ける名前に置き換えます。configuration_name
ecs-cli configure --cluster
--config-namecluster_name
--default-launch-typelaunch_type
--regionregion_name
configuration_name
CLI をインストールして設定すると、「チュートリアル: Amazon ECS CLI を使用して Fargate タスクのクラスターを作成する」を実行できます。詳細については、Amazon Elastic Container Service Developer Guide の「Amazon ECS コマンドラインリファレンス」を参照してください。
プロファイル
Amazon ECS CLI は、ecs-cli
configure profile コマンドを使用して、プロファイルという名前の複数の AWS 認証情報のセットの設定をサポートします。デフォルトのプロファイルは、ecs-cli configure profile default コマンドを使用して設定できます。これらのプロファイルは、--ecs-profile
フラグを使用する認証情報を必要とする Amazon ECS CLI コマンドを実行するときに参照できます。それ以外の場合、デフォルトのプロファイルが使用されます。
詳細については、Amazon Elastic Container Service Developer Guide の「Amazon ECS コマンドラインリファレンス」を参照してください。
クラスター設定
クラスター設定は、クラスターの名前とリージョンを含む、Amazon ECS クラスターを説明する一連のフィールドです。デフォルトのクラスタープロファイルは、ecs-cli configure default コマンドを使用して設定できます。Amazon ECS CLI は、--config-name
オプションを使用した複数の名前付きクラスター設定の指定をサポートしています。
詳細については、Amazon Elastic Container Service Developer Guide の「Amazon ECS コマンドラインリファレンス」を参照してください。
優先順位
認証情報とリージョンの両方を Amazon ECS CLI コマンドで渡すには、複数の方法があります。以下に示しているのは、それぞれの優先順位です。
認証情報の優先順位は次のとおりです。
-
Amazon ECS CLI プロファイルフラグ:
-
ECS プロファイル (
--ecs-profile
) -
AWS プロファイル (
--aws-profile
)
-
-
環境変数:
-
ECS_PROFILE
-
AWS_PROFILE
-
AWS_ACCESS_KEY_ID
、AWS_SECRET_ACCESS_KEY
、およびAWS_SESSION_TOKEN
-
-
ECS config ‐ デフォルトの ECS プロファイルから認証情報の取得を試みます。
-
デフォルトの AWS プロファイル — AWS プロファイル名から認証情報 (
aws_access_key_id
、aws_secret_access_key
) またはassume_role
(role_arn
、source_profile
) の使用を試みます。-
AWS_DEFAULT_PROFILE
環境変数 (デフォルトはdefault
).
-
-
EC2 インスタンスロール
リージョンの優先順位は次のとおりです。
-
Amazon ECS CLI フラグ:
-
リージョンフラグ (
--region
) -
クラスター config フラグ (
--cluster-config
)
-
-
ECS config ‐ デフォルトの ECS プロファイルからリージョンの取得を試みます。
-
環境変数—以下の環境変数からリージョンの取得を試みます。
-
AWS_REGION
-
AWS_DEFAULT_REGION
-
-
AWS プロファイル ‐ AWS プロファイル名からリージョンの使用を試みます。
-
AWS_PROFILE
環境変数 -
AWS_DEFAULT_PROFILE
環境変数 (デフォルトはdefault
)
-