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

ecs-cli local up

从 Amazon ECS 任务定义本地运行容器。默认情况下,此命令会在当前目录中查找名为 task-definition.json 的任务定义 JSON 文件。如果该任务定义文件不存在,则必须使用某个 --task-def 选项指定一个任务定义文件,如下所述。此命令还会在运行容器之前创建 --output 选项中指定的本地 Docker Compose 文件。

重要

所介绍的某些功能仅可用于最新版本的 Amazon ECS CLI。有关获取最新版本的更多信息,请参阅 安装 Amazon ECS CLI

语法

ecs-cli local create up [--task-def-compose filename] [--task-def-file filename] [--task-def-remote value] [--force] [--output output_file] [--override filename]

选项

名称

描述

--task-def-compose filename

指定要本地运行的 Docker Compose 文件。

类型:字符串

必需:否

--task-def-file filename

指定要本地运行的任务定义 JSON 文件。如果未指定一个这样的文件,ECS CLI 将在当前目录中查找名为 task-definition.json 的文件。

类型:字符串

必需:否

--task-def-remote value

指定要转换为 Docker Compose 文件的任务定义的完整 Amazon 资源名称 (ARN) 或 family:revision。如果指定没有修订的任务定义系列,则使用最新修订。

类型:字符串

必需:否

--force

覆盖任何现有的 Docker Compose 输出文件,而不提示您进行确认。

--output output_file

指定要将 Docker Compose 文件写入的本地文件名。如果未指定一个这样的文件名,则默认为 docker-compose.local.yml。如果输出文件已存在,CLI 将提示一条覆盖请求。

类型:字符串

必需:否

--override filename

指定要使用的本地 Docker Compose 覆盖文件名。

类型:字符串

必需:否

示例

从本地任务定义 JSON 文件本地运行容器

此示例本地运行在名为 hello-world.json 的本地任务定义文件中定义的容器。

ecs-cli local create --task-def-file hello-world.json

输出:

INFO[0001] Successfully wrote docker-compose.ecs-local.yml INFO[0002] Successfully wrote docker-compose.ecs-local.override.yml INFO[0002] The network ecs-local-network already exists INFO[0002] The amazon-ecs-local-container-endpoints container already exists with ID 5976522f4cafb840e5f003a2285fc439ed1b2a89aa74634958c6a6105ca6edd1 INFO[0002] Started container with ID 5976522f4cafb840e5f003a2285fc439ed1b2a89aa74634958c6a6105ca6edd1 INFO[0002] Using docker-compose.ecs-local.yml, docker-compose.ecs-local.override.yml files to start containers Compose out: Found orphan containers (downloads_httpd_1) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up. Creating downloads_simple-app_1 ... done

从远程任务定义本地运行容器

此示例本地运行在名为 hello-world 的最新修订版的 Amazon ECS 任务定义中定义的容器。

ecs-cli local up --task-def-remote hello-world

输出:

INFO[0000] Reading task definition from hello-world INFO[0002] Successfully wrote docker-compose.ecs-local.yml INFO[0004] Successfully wrote docker-compose.ecs-local.override.yml INFO[0004] The network ecs-local-network already exists INFO[0005] The amazon-ecs-local-container-endpoints container already exists with ID 5976522f4cafb840e5f003a2285fc439ed1b2a89aa74634958c6a6105ca6edd1 INFO[0005] Started container with ID 5976522f4cafb840e5f003a2285fc439ed1b2a89aa74634958c6a6105ca6edd1 INFO[0005] Using docker-compose.ecs-local.yml, docker-compose.ecs-local.override.yml files to start containers Compose out: Found orphan containers (downloads_httpd_1) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up. Creating downloads_hello-world_1 ... done

本页内容: