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

ecs-cli configure

说明

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

使用多个群集配置

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

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

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

  • 使用 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 [--default-launch-type launch_type] [--config-name config_name] [--cfn-stack-name stack_name] [--help]

选项

名称 描述

--cluster, -c cluster_name

指定要使用的 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"

本页内容: