配置 Amazon ECS CLI - Amazon ECS
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置 Amazon ECS CLI

Amazon ECS已发布Amazon Copilot,这是用于的命令行界面 (CLI),可以简化构建、发布和操作生产就绪型容器化应用程序Amazon ECS来自于当地开发环境。有关更多信息,请参阅 使用Amazon Copilot命令行界面

Amazon ECS CLI 需要一些基本配置信息(例如,您的 Amazon 凭证、要在其中创建集群的 Amazon 区域以及要使用的 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 环境变量替换为您的 Amazon 凭证。

    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与您想要的Amazon区域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 后,您可以尝试 教程:使用 Fargate CLI 创建包含 Amazon ECS 任务的集群。有关更多信息,请参阅 。Amazon ECS命令行参考中的Amazon Elastic Container Service Developer Guide

Profiles

Amazon ECS CLI 支持使用 Amazon 命令将多组 凭据配置为命名配置文件ecs-cli configure profile。使用 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. Amazon ECS配置文件 (--ecs-profile

    2. Amazon配置文件 (--aws-profile

  2. 环境变量:

    1. ECS_PROFILE

    2. AWS_PROFILE

    3. AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_SESSION_TOKEN

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

  4. 默认值Amazon配置文件—尝试使用凭据 (aws_access_key_idaws_secret_access_key)或assume_role(role_arnsource_profile) 来自Amazon配置文件名称。

    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. Amazon配置文件‐尝试从Amazon配置文件名称:

    1. AWS_PROFILE 环境变量

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