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

ecs-cli compose service

在 ECS 集群上利用 docker-compose 式命令管理 Amazon ECS 服务。有关 Docker 复合文件语法如何与 ECS CLI 结合使用的更多信息,请参阅使用 Docker 复合文件语法

注意

要使用 Amazon ECS CLI 运行任务而不是创建服务,请参阅 ecs-cli compose

ecs-cli compose service 命令将项目名称与其创建的任务定义和服务结合使用。当 Amazon ECS CLI 从复合文件创建任务定义和服务时,任务定义和服务称为 project-name。默认情况下,项目名称是包含 Docker 复合文件的目录的名称。但是,您也可以使用 --project-name 选项指定自己的项目名称。

注意

Amazon ECS CLI 只能管理使用 CLI 创建的任务、服务和容器实例。要管理并非使用 Amazon ECS CLI 创建的任务、服务和容器实例,请使用 AWS Command Line Interface 或 AWS 管理控制台。

重要

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 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]

选项

名称 描述

--verbose, --debug

提高命令输出的详细程度以帮助诊断。

必需:否

--file, -f compose-file

指定要使用的 Docker 复合文件。此时,最新版本的 Amazon ECS CLI 支持 Docker 复合文件语法版本 1 和 2。 如果在 ecs-cli compose 运行时设置 COMPOSE_FILE 环境变量,则 Docker 复合文件将设置为该环境变量的值。

类型:字符串

默认值:./docker-compose.yml

必需:否

--project-name, -p project-name

指定要使用的项目名称。如果在运行 ecs-cli compose 时设置 COMPOSE_PROJECT_NAME 环境变量,则项目名称将设置为该环境变量的值。

类型:字符串

默认值:当前目录名。

必需:否

--task-role-arn role_value

指定该任务中的容器可以代入的 IAM 角色的短名称或完整的 Amazon 资源名称 (ARN)。该任务中的所有容器都将被授予在该角色中指定的权限。

类型:字符串

必需:否

--region, -r region

Specifies the AWS Region to use. Defaults to the cluster configured using the configure command.

Type: String

Required: No

--cluster-config cluster_config_name

Specifies the name of the Amazon ECS cluster configuration to use. Defaults to the cluster configuration set as the default.

Type: String

Required: No

--ecs-profile ecs_profile

Specifies the name of the Amazon ECS profile configuration to use. Defaults to the profile configured using the configure profile command.

Type: String

Required: No

--aws-profile aws_profile

Specifies the AWS profile to use. Enables you to use the AWS credentials from an existing named profile in ~/.aws/credentials.

Type: String

Required: No

--cluster, -c cluster_name

Specifies the Amazon ECS cluster name to use. Defaults to the cluster configured using the configure command.

Type: String

Required: No

--help, -h

Shows the help text for the specified command.

Required: No

可用子命令

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 服务(如果该服务不存在)并在集群上运行该任务的一个实例(createstart 的组合)。此命令将服务的预期数量更新为 1。有关更多信息,请参阅ecs-cli compose service up

pslist

列出集群中属于使用复合项目创建的服务的所有容器。有关更多信息,请参阅 ecs-cli compose service ps, list

scale

将服务的预期数量扩展至指定计数。有关更多信息,请参阅 ecs-cli compose service scale

stop

停止属于使用复合项目创建的服务的正在运行的任务。此命令将服务的预期数量更新为 0。有关更多信息,请参阅 ecs-cli compose service stop

rmdeletedown

将服务的预期数量更新为 0,然后删除服务。有关更多信息,请参阅ecs-cli compose service rm, delete, down

本页内容: