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

ecs-cli compose start

構成ファイルから作成したタスク定義から 1 つの Amazon ECS タスクを開始します。

重要

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

構文

ecs-cli compose start [--region region] [--cluster-config cluster_config_name] [--ecs-profile ecs_profile] [--aws-profile aws_profile] [--cluster cluster_name] [--launch-type launch_type] [--create-log-groups] [--help]

オプション

名前 説明

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

--launch-type launch_type 使用する起動タイプを指定します。使用できるオプションは、FARGATE または EC2 です。起動タイプの詳細については、「Amazon ECS 起動タイプ」を参照してください。

これにより、クラスタ設定に格納されているデフォルトの起動タイプが上書きされます。

型: 文字列

必須: いいえ

--create-log-groups

Creates the CloudWatch log groups specified in your compose files.

Required: No

--help, -h

Shows the help text for the specified command.

Required: No

タスクを実行する

この例では、hello-world.yml compose ファイルからタスク定義を作成します。追加の ECS パラメータは、Fargate 起動タイプを使用するタスクのネットワーキング設定で指定します。次に、そのタスク定義を使用して 1 つのタスクを実行します。

サンプル Docker Compose ファイル hello-world.yml:

version: '3' services: nginx: image: nginx:latest ports: - "80:80" logging: driver: awslogs options: awslogs-group: tutorial awslogs-region: us-east-1 awslogs-stream-prefix: nginx

サンプル ECS parameters ファイル ecs-params.yml:

version: 1 task_definition: task_execution_role: ecsTaskExecutionRole ecs_network_mode: awsvpc task_size: mem_limit: 0.5GB cpu_limit: 256 run_params: network_configuration: awsvpc_configuration: subnets: - subnet-abcd1234 - subnet-dbca4321 security_groups: - sg-abcd1234 assign_public_ip: ENABLED

コマンド:

ecs-cli compose --file hello-world.yml --ecs-params ecs-params.yml start --launch-type FARGATE --create-log-groups

出力:

INFO[0000] Using ECS task definition TaskDefinition=ecscompose-hello-world:5

このページの内容: