本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ecs-cli compose service
在 ECS 集群上利用 Amazon ECS 式命令管理 docker-compose 服务。有关 Docker 复合文件语法如何与 ECS CLI 结合使用的更多信息,请参阅使用 Docker 复合文件语法.
要使用 Amazon ECS CLI 运行任务而不是创建服务,请参阅 ecs-cli compose.
ecs-cli compose service 命令将项目名称与其创建的任务定义和服务结合使用。当 Amazon ECS CLI 从复合文件创建任务定义和服务时,任务定义和服务称为
. 默认情况下,项目名称是包含 Docker 复合文件的目录的名称。但是,您也可以使用 project-name
--project-name
选项指定自己的项目名称。
Amazon ECS CLI 只能管理使用 CLI 创建的任务、服务和容器实例。要管理并非使用 Amazon ECS CLI 创建的任务、服务和容器实例,请使用 AWS Command Line Interface 或 AWS 管理控制台。
所介绍的某些功能仅可用于最新版本的 ECS CLI。要获取最新版本,请参阅安装 Amazon ECS CLI。
Syntax
ecs-cli compose [--verbose] [--file
compose_file
] [--project-name project_name
] [--task-role-arn task_role_arn
] [--ecs-params ecs_params_file
] [--registry-creds value
] [--region region
] [--cluster-config cluster_config_name
] [--ecs-profile ecs_profile
] [--aws-profile aws_profile
] [--cluster cluster_name
] [--help] service [subcommand
]
[arguments
] [--help]
Options
名称 |
描述 |
---|---|
|
提高命令输出的详细程度以帮助诊断。 必需:否 |
|
指定要使用的 Docker 复合文件。此时,最新版本的 Amazon ECS CLI 支持 Docker 复合文件语法 类型:字符串 默认值: 必需:否 |
|
指定要使用的项目名称。如果在运行 ecs-cli compose 时设置 类型:字符串 默认值:当前目录名。 必需:否 |
|
指定该任务中的容器可以代入的 IAM 角色的短名称或完整的 Amazon 资源名称 (ARN)。该任务中的所有容器都将被授予在该角色中指定的权限。 类型:字符串 必需:否 |
|
指定非 Docker 复合文件固有的 ECS 参数。有关更多信息,请参阅 使用 Amazon ECS 参数。 默认值: 必需:否 |
|
指定要使用的 AWS 区域。默认为使用 configure 命令配置的集群。 类型:字符串 必需:否 |
|
指定要使用的 Amazon ECS 集群配置的名称。默认为作为默认值设置的集群设置。 类型:字符串 必需:否 |
|
指定要使用的 Amazon ECS 配置文件的名称。默认为使用 configure profile 命令配置的配置文件。 类型:字符串 必需:否 |
|
指定要使用的 AWS 配置文件。使您能够使用 类型:字符串 必需:否 |
|
指定要使用的 Amazon ECS 集群名称。默认为使用 configure 命令配置的集群。 类型:字符串 必需:否 |
|
显示指定命令的帮助文本。 必需:否 |
可用子命令
ecs-cli compose service 命令支持以下子命令。其中,每条子命令均具有关联的标记,这些标记可通过 --help
标记显示。
- create
-
从复合文件创建 Amazon ECS 服务。将使用预期计数
0
创建服务,因此该命令不会启动任何容器。有关更多信息,请参阅 ecs-cli compose service create. - start
-
在创建的 Amazon ECS 服务上启动每个容器的一个副本。此命令将服务的预期数量更新为
1
. 有关更多信息,请参阅 ecs-cli compose service start. - up
-
从复合文件创建 Amazon ECS 服务(如果该服务不存在)并在集群上运行该任务的一个实例(create 和 start). 的组合)。此命令将服务的预期数量更新为
1
. 有关更多信息,请参阅 ecs-cli compose service up. - ps, list
-
列出集群中属于使用复合项目创建的服务的所有容器。有关更多信息,请参阅 ecs-cli compose service ps, list.
- scale
-
将服务的预期数量扩展至指定计数。有关更多信息,请参阅 ecs-cli compose service scale.
- stop
-
停止属于使用复合项目创建的服务的正在运行的任务。此命令将服务的预期数量更新为
0
. 有关更多信息,请参阅 ecs-cli compose service stop. - rm, delete, down
-
将服务的预期数量更新为
0
,然后删除服务。有关更多信息,请参阅 ecs-cli compose service rm, delete, down.