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

ecs-cli compose up

Amazon ECS タスク定義が存在しない場合は、構成ファイルから作成し、そのタスクの 1 つのインスタンスをクラスターで実行します。

重要

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

構文

ecs-cli compose up [--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] [--force-update] [--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

作成ファイルで指定された CloudWatch ロググループを作成します。

必須: いいえ

--force-update

タスクの再起動を強制します。

必須: いいえ

--help, -h

Shows the help text for the specified command.

Required: No

AWS Fargate 起動タイプを使用するタスクでタスクネットワーキングを使用する場合のタスク定義を登録する

この例では、hello-world 構成ファイルからプロジェクト名 hello-world.yml でタスク定義を作成します。追加の ECS パラメータは、Fargate 起動タイプを使用するタスクとネットワーク設定用に指定されます。これにより、タスクの 1 つのインスタンスが Fargate 起動タイプを使用して実行されます。

サンプル 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: ecs_network_mode: awsvpc task_execution_role: ecsTaskExecutionRole task_size: cpu_limit: 512 mem_limit: 2GB services: nginx: essential: true run_params: network_configuration: awsvpc_configuration: subnets: - subnet-abcd1234 - subnet-dcba4321 security_groups: - sg-abcd1234 - sg-dcba4321 assign_public_ip: ENABLED

コマンド:

ecs-cli compose --project-name hello-world --file hello-world.yml --ecs-params ecs-params.yml up --launch-type FARGATE

出力:

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

このページの内容: