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

ecs-cli down

説明

ecs-cli up によって作成された AWS CloudFormation スタックおよび関連するリソースを削除します。

注記

Amazon ECS CLI は、CLI で作成されたタスク、サービス、およびコンテナインスタンスのみを管理できます。Amazon ECS CLI で作成されていないタスク、サービス、およびコンテナインスタンスを管理するには、AWS Command Line Interface または AWS マネジメントコンソールを使用します。

ecs-cli down コマンドは、~/.ecs/config で指定したクラスターを削除しようとします。ただし、ecs-cli up によって作成されなかったクラスター内に、アクティブなサービスがある場合 (必要数が 0 であっても)、または登録済みのコンテナインスタンスがある場合、クラスターは削除されず、サービスと既存のコンテナインスタンスはアクティブなままです。これはたとえば、登録済みのコンテナインスタンスで、デフォルトのクラスターなど、既存の ECS クラスターを使用した場合に発生します。

削除するクラスター内にサービスまたはコンテナインスタンスが残っている場合は、「Amazon ECS リソースのクリーンアップ」の手順に従ってそれらを削除してから、クラスターを削除します。

重要

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

構文

ecs-cli down [--force] [--cluster cluster_name] [--region region] [--help]

オプション

名前 説明

--force, -f

このコマンドによりリソースが完全に削除され、確認のプロンプトをバイパスすることを確認します。

必須: いいえ

--cluster, -c cluster_name

使用する ECS クラスター名を指定します。デフォルトは、configure コマンドを使用して設定したクラスターになります。

型: 文字列

必須: いいえ

--region, -r region

使用する AWS リージョンを指定します。デフォルトは、configure コマンドを使用して設定したクラスターになります。

型: 文字列

必須: いいえ

--cluster-config cluster_config_name

使用する ECS クラスター設定の名前が指定されます。デフォルトでは、デフォルトとして設定するクラスター設定が指定されます。

型: 文字列

必須: いいえ

--ecs-profile ecs_profile

使用する ECS プロファイル設定の名前が指定されます。デフォルトは、configure profile コマンドを使用して設定したプロファイルになります。

型: 文字列

必須: いいえ

--aws-profile aws_profile

使用する AWS プロファイルが指定されます。~/.aws/credentials という名前の既存のプロファイルから、AWS 認証情報を使用することができます。

型: 文字列

必須: いいえ

--help, -h

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

必須: いいえ

例 1

この例では、リソースが含まれているクラスターを削除します。

ecs-cli down --cluster ecs-cli-fargate-demo --force

出力:

INFO[0001] Waiting for your cluster resources to be deleted INFO[0001] Cloudformation stack status stackStatus=DELETE_IN_PROGRESS INFO[0062] Cloudformation stack status stackStatus=DELETE_IN_PROGRESS INFO[0123] Cloudformation stack status stackStatus=DELETE_IN_PROGRESS INFO[0154] Deleted cluster

例 2

この例では、空のクラスターを削除します。

ecs-cli down --cluster ecs-cli-empty-demo --force

出力:

INFO[0002] No CloudFormation stack found for cluster 'ecs-cli-empty-demo'. INFO[0003] Deleted cluster cluster=ecs-cli-empty-demo

このページの内容: