タスク定義の作成
Docker コンテナを Amazon ECS で実行するには、タスク定義を作成する必要があります。1 つのタスク定義に複数のコンテナとデータボリュームを定義できます。タスク定義で使用できるパラメータの詳細については、「タスク定義パラメータ」を参照してください。
新しいタスク定義を作成するには
Amazon ECS コンソール (https://console.aws.amazon.com/ecs/
) を開きます。 -
ナビゲーションペインで [Task Definitions (タスク定義)]、[Create new Task Definition (新しいタスク定義の作成)] の順に選択します。
-
[Select launch type compatibilities (起動タイプの互換性の選択)] ページで、[FARGATE]、[Next step (次のステップ)] の順に選択します。
注記 Fargate 起動タイプは Windows コンテナと互換性がありません。
-
(オプション) JSON 形式のタスク定義の場合は、以下の手順を実行します。
-
[Configure task and container definitions] ページで、ページの下部までスクロールし、[Configure via JSON] を選択します。
-
JSON 形式のタスク定義をテキスト領域に貼り付け、[Save] を選択します。
-
情報を確認し、[Create] を選択します。
ページの末尾までスクロールし、[Configure via JSON] を選択します。
-
-
[Task Definition Name (タスク定義名)] に、タスク定義の名前を入力します。最大 255 文字の英字 (大文字と小文字)、数字、ハイフン、アンダースコアを使用できます。
-
[Task execution IAM role] で、タスク実行ロールを選択するか、[Create new role (新しいロールの作成)] を選択してコンソールで自動的に作成します。詳細については、「Amazon ECS タスク実行IAM ロール」を参照してください。
-
[Task size] で、[Task memory (GB)] および [Task CPU (vCPU)] の値を選択します。次の表では、有効な組み合わせを示しています。
CPU の値 メモリの値 256 (.25 vCPU) 512 MB、1 GB、2 GB 512 (.5 vCPU) 1 GB、2 GB、3 GB、4 GB 1024 (1 vCPU) 2 GB、3 GB、4 GB、5 GB、6 GB、7 GB、8 GB 2048 (2 vCPU) 4 GB ～ 16 GB (1 GB のインクリメント) 4096 (4 vCPU) 8 GB ～ 30 GB (1 GB のインクリメント) -
タスク定義内のコンテナごとに、以下の手順を実行します：
-
[Add container] を選択します。
-
コンテナの定義で使用するために、必須のフィールドとオプションのフィールドに入力します。その他のコンテナの定義パラメータは、[詳細コンテナ設定] メニューより設定できます。詳細については、「タスク定義パラメータ」を参照してください。
-
[追加] を選択して、タスク定義にコンテナを追加します。
-
-
(オプション) [Service Integration (サービス統合)] で、 App Mesh 統合のパラメータを設定するには、[Enable App Mesh integration (Enable App Mesh 統合を有効にする)] を選択し、次の手順を実行します。
-
メッシュ名には、使用する既存の App Mesh Service メッシュを選択します。メッシュがリストに表示されない場合は、最初にメッシュを作成する必要があります。詳細については、AWS App Meshユーザーガイドの「サービスメッシュ」を参照してください。
-
[App Mesh endpoints (App Mesh エンドポイント)] に、以下のいずれかのオプションを入力します。
[Virtual node (仮想ノード)] — 次の情報を入力または選択します。
[Application container name (アプリケーションコンテナ名)] で、 App Mesh 統合に使用するコンテナ名を選択します。このコンテナは、タスク定義内ですでに定義されている必要があります。
[Virtual node name (仮想ノード名)] で 既存のApp Mesh 仮想ノードの名前を選択します。仮想ノードがリストに表示されていない場合は、最初に作成する必要があります。詳細については、AWS App Meshユーザーガイドの仮想仮想ノードを参照してください。
[Virtual node port (仮想ノードポート)] には、App Meshの仮想ノードで設定されたリスナーポートが事前に入力されます。
[Virtual gateway (仮想ゲートウェイ)] — 次の情報を入力または選択します。
仮想ゲートウェイ名には、使用する既存の App Mesh 仮想ゲートウェイを選択します。仮想ゲートウェイがリストに表示されていない場合は、最初に作成する必要があります。詳細については、AWS App Mesh ユーザーガイドの「仮想 ゲートウェイ」を参照してください。
[Virtual gateway port (仮想ゲートウェイポート)] — App Mesh の仮想ゲートウェイで設定されたリスナーポートが事前に入力されます。
-
Envoyイメージには、
me-south-1およびap-east-1を除くすべてのリージョンに840364872350dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy: v1.15.1.0-prodと入力します。us-west-2はme-south-1およびap-east-1を除く任意のリージョンに置き換えることができます。アプリケーションがこれらのリージョンのいずれかにある場合は、840364872350をお住まいのリージョンに適した値に変更する必要があります。詳細については、AWS App Mesh ユーザーガイドの「Envoy イメージ を参照してください。 -
[適用]、[確認] の順に選択します。これにより、タスク定義に対する新しい Envoy プロキシコンテナと、それをサポートする設定が追加されます。仮想ノードを選択した場合、次のステップのためにApp Meshプロキシ設定も自動入力されます。[Virtual gateway (仮想ゲートウェイ)] を選択すると、プロキシ設定は無効になります。これは、仮想ゲートウェイには使用されないためです。
-
-
（オプション）サービス統合の仮想ノードを選択すると、プロキシ設定で、事前に入力されたすべての値を確認します。これらのフィールドの詳細については、サービスの更新の JSONタブを参照してください。
-
（オプション） [Log Router Integration (ログルーターの統合)] では、カスタムログルーティング設定を追加できます。FireLens 統合を有効にするを選択して、以下の操作を実行します。
-
[Type (タイプ)] で、使用するログルーターのタイプを選択します。
-
イメージには、ログルーターコンテナーのイメージ URI を入力します。
fluentbitログルータータイプを選択した場合、イメージフィールドには、AWSFluent Bit イメージが事前入力されます。詳細については、「AWSfor Fluent Bit イメージの使用」を参照してください。 -
[Apply (適用)] を選択します。これにより、
log_routerという名前のタスク定義に新しいログルーターコンテナが作成され、サポートする設定を適用します。ログルーター統合フィールドを変更する場合は、適用を選択し、もう一度 FireLens コンテナを更新します。
-
-
(オプション) タスクのデータボリュームを定義するには、[Add volume] を選択します。詳細については、「タスクでのデータボリュームの使用」を参照してください。
-
[Name (名前)] に、ボリュームの名前を入力します。最大 255 文字の英字 (大文字と小文字)、数字、ハイフン、アンダースコアを使用できます。
-
-
[Tags (タグ)] セクションで、タスク定義に関連付ける各タグのキーと値を指定します。詳細については、「Amazon ECS リソースにタグを付ける」を参照してください。
-
[Create] を選択します。
タスク定義テンプレート
以下に示しているのは、空のタスク定義テンプレートです。このテンプレートを使用してタスク定義を作成します。これにより、コンソールの JSON 入力領域に貼り付けるか、ファイルに保存して AWS CLI の --cli-input-json オプションで使用できるようになります。詳細については、「タスク定義パラメータ」を参照してください。
{ "family": "", "taskRoleArn": "", "executionRoleArn": "", "networkMode": "awsvpc", "containerDefinitions": [ { "name": "", "image": "", "repositoryCredentials": {"credentialsParameter": ""}, "cpu": 0, "memory": 0, "memoryReservation": 0, "links": [""], "portMappings": [ { "containerPort": 0, "hostPort": 0, "protocol": "tcp" } ], "essential": true, "entryPoint": [""], "command": [""], "environment": [ { "name": "", "value": "" } ], "environmentFiles": [ { "value": "", "type": "s3" } ], "mountPoints": [ { "sourceVolume": "", "containerPath": "", "readOnly": true } ], "volumesFrom": [ { "sourceContainer": "", "readOnly": true } ], "linuxParameters": { "capabilities": { "add": [""], "drop": [""] }, "devices": [ { "hostPath": "", "containerPath": "", "permissions": ["read"] } ], "initProcessEnabled": true, "sharedMemorySize": 0, "tmpfs": [ { "containerPath": "", "size": 0, "mountOptions": [""] } ], "maxSwap": 0, "swappiness": 0 }, "secrets": [ { "name": "", "valueFrom": "" } ], "dependsOn": [ { "containerName": "", "condition": "HEALTHY" } ], "startTimeout": 0, "stopTimeout": 0, "hostname": "", "user": "", "workingDirectory": "", "disableNetworking": true, "privileged": true, "readonlyRootFilesystem": true, "dnsServers": [""], "dnsSearchDomains": [""], "extraHosts": [ { "hostname": "", "ipAddress": "" } ], "dockerSecurityOptions": [""], "interactive": true, "pseudoTerminal": true, "dockerLabels": {"KeyName": ""}, "ulimits": [ { "name": "msgqueue", "softLimit": 0, "hardLimit": 0 } ], "logConfiguration": { "logDriver": "awslogs", "options": {"KeyName": ""}, "secretOptions": [ { "name": "", "valueFrom": "" } ] }, "healthCheck": { "command": [""], "interval": 0, "timeout": 0, "retries": 0, "startPeriod": 0 }, "systemControls": [ { "namespace": "", "value": "" } ], "resourceRequirements": [ { "value": "", "type": "GPU" } ], "firelensConfiguration": { "type": "fluentd", "options": {"KeyName": ""} } } ], "volumes": [ { "name": "", "host": {"sourcePath": ""}, "dockerVolumeConfiguration": { "scope": "task", "autoprovision": true, "driver": "", "driverOpts": {"KeyName": ""}, "labels": {"KeyName": ""} }, "efsVolumeConfiguration": { "fileSystemId": "", "rootDirectory": "", "transitEncryption": "ENABLED", "transitEncryptionPort": 0, "authorizationConfig": { "accessPointId": "", "iam": "ENABLED" } } } ], "placementConstraints": [ { "type": "memberOf", "expression": "" } ], "requiresCompatibilities": ["EC2"], "cpu": "", "memory": "", "tags": [ { "key": "", "value": "" } ], "ephemeralStorage": { "sizeInGiB": 0 }, "pidMode": "task", "ipcMode": "none", "proxyConfiguration": { "type": "APPMESH", "containerName": "", "properties": [ { "name": "", "value": "" } ] }, "inferenceAccelerators": [ { "deviceName": "", "deviceType": "" } ] }
このタスク定義テンプレートは、以下の AWS CLI コマンドを使用して生成できます。
aws ecs register-task-definition --generate-cli-skeleton
