Amazon Elastic Container Service
開発者ガイド (API バージョン 2014-11-13)

ecs-cli

説明

Amazon ECS コマンドラインインターフェース (CLI) には、ローカル開発環境からのクラスターおよびタスクの作成、更新、モニタリングを簡素化する高レベルコマンドが用意されています。Amazon ECS CLI では、マルチコンテナアプリケーションの定義と実行によく使用されるオープンソースツール、Docker Compose がサポートされています。

Amazon ECS CLI の簡単なチュートリアルについては、「チュートリアル: ECS CLI を使用して Fargate タスクのクラスターを作成する」を参照してください。

各サブコマンドのヘルプテキストは、ecs-cli subcommand --help により使用できます。

重要

記載されている機能の一部は、ECS CLI の最新バージョンでのみ使用可能です。最新バージョンを取得するには、「Amazon ECS CLI のインストール」を参照してください。

構文

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

オプション

名前 説明

--version, -v

Amazon ECS CLI のバージョン情報を出力します。

必須: いいえ

--help, -h

指定したコマンドのヘルプテキストを表示します。

必須: いいえ

使用できるサブコマンド

ecs-cli コマンドでは、以下のサブコマンドを使用できます。

configure

AWS 認証情報、使用するリージョン、Amazon ECS CLI で使用する ECS クラスター名を設定します。詳細については、「ecs-cli configure」を参照してください。

migrate

従来の設定ファイル (ECS CLI v0.6.6 以前) を新しい設定ファイル形式 (ECS CLI v1.0.0 以降) に移行します。このコマンドは、変更される内容の要約を出力し、続行するかどうかの確認を求めます。詳細については、「ecs-cli configure migrate」を参照してください。

up

クラスターのセットアップに必要な ECS クラスター (まだない場合) と AWS リソースを作成します。詳細については、「ecs-cli up」を参照してください。

down

ecs-cli up によって作成された AWS CloudFormation スタックおよび関連するリソースを削除します。詳細については、「ecs-cli down」を参照してください。

scale

ECS クラスター内のコンテナインスタンスの数を変更します。詳細については、「ecs-cli scale」を参照してください。

ログ

CloudWatch Logs からコンテナログを取得します。awslogs ドライバーを使用するタスクで、ログストリームのプレフィックスを指定している場合にのみ有効です。詳細については、「ecs-cli logs」を参照してください。

ps

ECS クラスター内の実行中のすべてのコンテナを一覧表示します。詳細については、「ecs-cli ps」を参照してください。

push

イメージを Amazon ECR リポジトリにプッシュします。詳細については、「ecs-cli push」を参照してください。

pull

イメージを ECR リポジトリからプルします。詳細については、「ecs-cli pull」を参照してください。

images

ECS クラスター内の実行中のすべてのコンテナを一覧表示します。詳細については、「ecs-cli images」を参照してください。

license

Amazon ECS CLI とその依存関係の LICENSE ファイルを出力します。詳細については、「ecs-cli license」を参照してください。

compose

ECS クラスターで docker-compose スタイルのコマンドを実行します。詳細については、「ecs-cli compose」を参照してください。

help

指定したコマンドのヘルプテキストを表示します。