Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

配置 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 配置文件,将 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 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 命令中传递凭证和区域有多种方法。以下是每项的优先顺序。

凭证的优先顺序是:

  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_KEYAWS_SESSION_TOKEN

  3. ECS config ‐‐ 尝试从默认 ECS 配置文件中获取凭证。

  4. 默认 AWS 配置文件 ‐ 尝试从 AWS 配置文件名称中使用凭证(aws_access_key_idaws_secret_access_key)或 assume_rolerole_arnsource_profile)。

    1. AWS_DEFAULT_PROFILE 环境变量 (默认为 default).

  5. EC2 实例角色

区域的优先顺序是:

  1. Amazon ECS CLI 标志:

    1. 区域标志 (--region)

    2. 集群配置标志 (--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)