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

ecs-cli configure

配置要使用的 AWS 区域、资源创建前缀以及要与 Amazon ECS CLI 结合使用的 Amazon ECS 集群名称。将单一命名集群配置存储在 ~/.ecs/config 文件中。创建的第一个集群配置将设置为默认配置。

重要

Some features described may only be available with the latest version of the Amazon ECS CLI. For more information about obtaining the latest version, see 安装 Amazon ECS CLI.

使用多个集群配置

使用多个集群配置时应注意以下事项:

  • 可以存储多个集群配置,但始终有一个配置为默认配置。

  • 存储的第一个集群配置将设置为默认配置。

  • 使用 ecs-cli configure default 命令可更改要设置为默认配置的集群配置。有关更多信息,请参阅 ecs-cli configure default

  • 可使用 --cluster-config 标记在命令中引用非默认集群配置。

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

注意

确保您使用的是最新版本的 Amazon ECS CLI 才能使用所有配置选项。

语法

ecs-cli configure --cluster cluster_name --region region [--config-name config_name] [--cfn-stack-name stack_name] [--default-launch-type launch_type] [--help]

选项

名称 说明

--cluster, -c cluster_name

指定要使用的 Amazon ECS 集群名称。默认为使用 configure 命令配置的集群。

类型:字符串

必需:是

--region, -r region

指定要使用的 AWS 区域。默认为使用 configure 命令配置的集群。

类型:字符串

必需:是

--config-name config_name

指定此集群配置的名称。这是可使用 --cluster-config 标记在命令中引用的名称。如果忽略此选项,此名称将设置为 default

类型:字符串

必需:否

--cfn-stack-name stack_name

指定要添加到在 ecs-cli up 中创建的 AWS CloudFormation 堆栈的堆栈名称。

重要

建议不要使用此参数。包含此参数是为了确保与 ECS CLI 的早期版本的向后兼容性。

类型:字符串

默认值:amazon-ecs-cli-setup-<cluster_name>

必需:否

--default-launch-type launch_type 指定要使用的默认启动类型。有效值为 FARGATEEC2。如果未指定,则不使用默认启动类型。有关启动类型的更多信息,请参阅 Amazon ECS 启动类型

类型:字符串

必需:否

--help, -h

显示指定命令的帮助文本。

必需:否

示例

示例

此示例将 Amazon ECS CLI 配置为创建名为 ecs-cli-demo 的集群配置,该配置使用 FARGATE 作为集群 ecs-cli-demous-east-1 区域中的默认启动类型。

ecs-cli configure --region us-east-1 --cluster ecs-cli-demo --default-launch-type FARGATE --config-name ecs-cli-demo

输出:

INFO[0000] Saved ECS CLI cluster configuration ecs-cli-demo.

运行以下命令后的 ~/.ecs/config 文件内容:

version: v1 default: fargate clusters: ecs-cli-demo: cluster: ecs-cli-demo region: us-east-1 default_launch_type: "FARGATE"