Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon 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 后,您可以尝试 教程:使用 ECS CLI 创建包含 Fargate 任务的群集。有关更多信息,请参见 Amazon ECS 命令行参考

配置文件

Amazon ECS CLI 支持使用 ecs-cli configure profile 命令将多组 AWS 凭据配置为命名配置文件。使用 ecs-cli configure profile default 命令可以设置默认配置文件。当您运行需要使用 --ecs-profile 标志的凭据的 Amazon ECS CLI 命令时,则可以引用这些配置文件,否则将使用默认配置文件。

有关更多信息,请参阅 ecs-cli configure profileecs-cli configure profile default

群集配置

群集配置是用于描述 Amazon ECS 群集的一组字段,包括群集名称和区域。使用 ecs-cli configure default 命令可以设置默认群集配置。Amazon ECS CLI 支持使用 --config-name 选项配置多个命名群集配置。

有关更多信息,请参阅 ecs-cli configureecs-cli configure default

优先顺序

在 Amazon ECS CLI 命令中传递凭据和区域有多种方法。以下是每项的优先顺序。

凭据的优先顺序是:

  1. 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. Default AWS profile ‐ 尝试从 AWS 配置文件名称中使用凭据 (aws_access_key_idaws_secret_access_key) 或 assume_role (role_arnsource_profile)

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

  5. EC2 实例角色

区域的优先顺序是:

  1. ECS CLI 标志

    1. 区域标志 (--region)

    2. 群集配置标志 (--cluster-config)

  2. ECS config ‐ 尝试从默认 ECS 配置文件中获取区域

  3. Environment variables ‐ 尝试从以下环境变量中获取区域:

    1. AWS_REGION

    2. AWS_DEFAULT_REGION

  4. AWS profile ‐ 尝试从 AWS 配置文件名称中使用区域

    1. AWS_PROFILE 环境变量

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