Menu
Amazon EC2 Container Service
Developer Guide (API Version 2014-11-13)

ecs-cli

Description

The Amazon EC2 Container Service (Amazon ECS) command line interface (CLI) provides high-level commands to simplify creating, updating, and monitoring clusters and tasks from a local development environment. The Amazon ECS CLI supports Docker Compose, a popular open-source tool for defining and running multi-container applications.

For a quick walkthrough of the ECS CLI, see the Amazon ECS CLI Tutorial.

Help text is available for each individual subcommand with ecs-cli subcommand --help.

Syntax

ecs-cli [--version] [subcommand] [--help]

Options

Name Description

--version, -v

Prints the version information for the Amazon ECS CLI.

Required: No

--help, -h

Show the help text for the specified command.

Required: No

Available Subcommands

The ecs-cli command supports the following subcommands:

configure

Configures your AWS credentials, the AWS region to use, and the Amazon ECS cluster name to use with the Amazon ECS CLI. For more information, see ecs-cli configure.

up

Creates the ECS cluster (if it does not already exist) and the AWS resources required to set up the cluster. For more information, see ecs-cli up.

down

Deletes the CloudFormation stack that was created by ecs-cli up and the associated resources. For more information, see ecs-cli down.

scale

Modifies the number of container instances in an ECS cluster. For more information, see ecs-cli scale.

ps

Lists all of the running containers in an ECS cluster. For more information, see ecs-cli ps.

license

Prints the LICENSE files for the ECS CLI and its dependencies. For more information, see ecs-cli license.

compose

Executes docker-compose–style commands on an ECS cluster. For more information, see ecs-cli compose.

help

Shows the help text for the specified command.