Amazon EC2 Container Service
开发人员指南 (API Version 2014-11-13)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

ecs-cli up

说明

创建 ECS 集群(如果该集群不存在)和设置该集群所需的 AWS 资源。

此命令创建名为 amazon-ecs-cli-setup-cluster_name 的新 AWS CloudFormation 堆栈。您可以在 AWS 管理控制台中查看堆栈创建的进度。

语法

ecs-cli up [--verbose] --keypair keypair_name --capability-iam [--size n] [--azs availability_zone_1,availability_zone_2] [--security-group security_group_id[,security_group_id[,...]]] [--cidr ip_range] [--port port_number] [--subnets subnet_1,subnet_2] [--vpc vpc_id] [--instance-type instance_type] [--image-id ami_id] [--no-associate-public-ip-address] [--force] [--cluster cluster_name] [--region region] [--help]

选项

名称 描述

--verbose, --debug

提供更详细的输出以进行调试。

必需:否

--keypair keypair_name

指定用于支持对群集中的 EC2 实例进行 SSH 访问的现有 Amazon EC2 密钥对的名称。

有关创建密钥对的更多信息,请参阅 Amazon EC2 用户指南(适用于 Linux 实例) 中的使用 Amazon EC2 进行设置

类型:字符串

必需:是

--capability-iam

确认此命令可创建 IAM 资源。

必需:是

--size n

指定要启动并注册到集群的实例的数量。

类型:整数

默认值:1

必需:否

--azs availability_zone_1,availability_zone_2

指定要在其中创建子网的两个 VPC 可用区的逗号分隔的列表 (这两个区域必须具有 available 状态)。如果您未使用 --vpc 选项指定 VPC ID,我们建议使用此选项。

警告

如果随机选择了一个不可用区域,则将此选项保留为空可能导致无法启动容器实例。

类型:字符串

必需:否

--security-group security_group_id[,security_group_id[,...]]

指定要与容器实例关联的现有安全组的逗号分隔列表。如果您在此处未指定安全组,请创建一个新的安全组。

有关更多信息,请参阅 Amazon EC2 用户指南(适用于 Linux 实例) 中的安全组

必需:否

--cidr ip_range

指定要用于集群中的容器实例的安全组的 CIDR/IP 范围。

注意

如果已使用 --security-group 选项指定现有安全组,则忽略此参数。

类型:CIDR/IP 范围

默认值:0.0.0.0/0

必需:否

--port port_number

指定要在安全组上打开以用于集群中的容器实例的端口。

注意

如果已使用 --security-group 选项指定现有安全组,则忽略此参数。

类型:整数

默认值:80

必需:否

--subnets subnet_1,subnet_2

指定要在其中启动容器实例的现有 VPC 子网 ID 的逗号分隔的列表。

类型:字符串

必需:如果已使用 --vpc 选项指定 VPC,则需要此选项。

--vpc vpc_id

指定要在其中启动容器实例的现有 VPC 的 ID。如果指定了一个 VPC ID,则必须使用 --subnets 选项指定该 VPC 中的现有子网的列表。如果未指定 VPC ID,请使用两个子网创建一个新的 VPC。

类型:字符串

必需:否

--instance-type instance_type

指定容器实例的 EC2 实例类型。

有关 EC2 实例类型的更多信息,请参阅 Amazon EC2 实例

类型:字符串

默认值:t2.micro

必需:否

--image-id ami_id

指定要用于容器实例的 Amazon EC2 AMI ID。

类型:字符串

默认值:指定区域的最新的经 Amazon ECS 优化的 AMI。

必需:否

--no-associate-public-ip-address

不向该 VPC 中的新实例分配公有 IP 地址。除非指定此选项,否则该 VPC 中的新实例会收到自动分配的公有 IP 地址。

必需:否

--force, -f

强制重新创建与您的当前配置匹配的所有现有资源。此选项对于从先前失败的尝试中清除过期资源非常有用。

必需:否

--cluster, -c cluster_name

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

类型:字符串

必需:否

--region, -r region

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

类型:字符串

必需:否

--help, -h

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

必需:否

示例

示例

此示例将启动一个包含 4 个 c4.large 实例的群集并将它们配置为使用名为 id_rsa 的 EC2 密钥对。

Copy
ecs-cli up --keypair id_rsa --capability-iam --size 4 --instance-type c4.large

输出:

INFO[0000] Created cluster                               cluster=ecs-cli
INFO[0000] Waiting for your cluster resources to be created
INFO[0001] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0061] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0121] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS
INFO[0181] Cloudformation stack status                   stackStatus=CREATE_IN_PROGRESS

本页内容: