ECS

【VPC内リージョンサービス】

ECS（Elastic Container Service）は、AWSが提供するマネージド型のコンテナオーケストレーションサービスです。

シンプルなタスク／サービスモデルで構成されており、ALB（Application Load Balancer）、Service Auto Scaling（サービスオートスケーリング）、および Code 系サービス（CodePipeline／CodeBuild／CodeDeploy／CodeCommit） と統合して動作します。

ECSの起動タイプには EC2 と Fargate があり、用途に応じて柔軟に選択できます。コントロールプレーンはAWSがマネージドし、タスクのスケジューリングやサービス管理を自動化します。一方、データプレーンとしては、ユーザーが EC2 インスタンスまたはサーバーレスな Fargate を選択してコンテナを実行します。

ECSの構成は階層的になっており、最上位に サービスがあり、その中で複数の タスクが実行されます。各タスクは タスク定義に基づいて構成され、使用するコンテナイメージ、CPU／メモリ、環境変数、ボリューム設定などが定義されています。サービスはタスクの数や実行状態を管理し、負荷分散やスケーリングを自動的に制御します。

Service Discovery（サービスディスカバリ） を利用することで、マイクロサービス間の名前解決や通信を自動化できます。

Capacity Providers（キャパシティープロバイダー）によって、EC2およびFargateの両方を組み合わせた柔軟なリソース運用が可能です。

Circuit Breaker（サーキットブレーカー）機能を活用すれば、デプロイ時に異常が発生した場合でも自動的にロールバックされ、安全に更新を行うことができます。

App Mesh と連携することで、サービス間通信の可視化やトラフィック制御も容易になります。

重要用語

ユースケース

ベストプラクティス

高可用性・バックアップ・リトライ

セキュリティ

ECSが実行ロールを引き受ける典型的な連携パターン

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs-tasks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

ECS が使用する SLR の連携パターン

SLR名 : AWSServiceRoleForECS

ログ・監視

標準メトリクス

制限値（固定値／ハードリミット／ソフトリミット）

AWS CLIのサンプルコード

SG を作成する（VPC ID 指定）

aws ec2 create-security-group \
  --group-name sg-xxxxxxxx \
  --vpc-id vpc-xxxxxxxxx \
  --tag-specifications 'ResourceType=security-group,Tags=[{Key=Name,Value=sg-xxxxxxxx}]'

SG ID を表示する

aws ec2 describe-security-groups

アウトバウンドルールを追加する（SG ID 指定）

aws ec2 authorize-security-group-egress \
  --group-id sg-xxxxxxxxx \
  --protocol tcp \
  --port 80 \
  --cidr 0.0.0.0/0

SG を削除する（SG ID 指定）

aws ec2 delete-security-group \
  --group-id sg-xxxxxxxxx

タスク実行ロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs-tasks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
  --role-name ecsTaskExecutionRole \
  --assume-role-policy-document file://ecs-trust-policy.json

タスク実行ロールを表示する

aws iam list-roles

タスク実行ロールを削除する（ロール名 指定）

aws iam list-attached-role-policies \
  --role-name ecsTaskExecutionRole

タスク実行ロールにAWS管理ポリシーをアタッチする（ロール名、ポリシーのARN 指定）

aws iam attach-role-policy \
  --role-name ecsTaskExecutionRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

タスク実行ロールからAWS管理ポリシーをデタッチする（ロール名、ポリシーのARN 指定）

aws iam detach-role-policy \
  --role-name ecsTaskExecutionRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

タスクロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs-tasks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
  --role-name ECSTaskRole \
  --assume-role-policy-document file://ecs-task-trust-policy.json

タスクロールを表示する

aws iam list-roles

タスクロールを削除する（ロール名 指定）

aws iam list-attached-role-policies \
  --role-name ECSTaskRole

タスクロールにAWS管理ポリシーをアタッチする（ロール名 指定）

aws iam attach-role-policy \
  --role-name MyECSTaskRole \
  --policy-arn arn:aws:iam::aws:policy/AmazonDynamoDBFullAccess

タスクロールからAWS管理ポリシーをデタッチする（ロール名 指定）

aws iam detach-role-policy \
  --role-name MyECSTaskRole \
  --policy-arn arn:aws:iam::aws:policy/AmazonDynamoDBFullAccess

ECSクラスターを作成する

aws ecs create-cluster \
  --cluster-name MyCluster \
  --tags key=Name,value=MyCluster

ECSクラスターの一覧を表示する

aws ecs list-clusters

クラスターを表示する（クラスター名 指定）

aws ecs describe-clusters \
  --clusters MyCluster

ECSクラスターを削除する（クラスター名 指定）

aws ecs delete-cluster \
  --cluster MyCluster

タスク定義を作成する（タスク定義ファイル名 指定）

{
  "family": "my-task",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "cpu": "256",
  "memory": "512",
  "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole",
  "taskRoleArn": "arn:aws:iam::123456789012:role/ecsTaskRole",
  "containerDefinitions": [
    {
      "name": "my-container",
      "image": "nginx:latest",
      "portMappings": [
        {
          "containerPort": 80,
          "protocol": "tcp"
        }
      ],
      "essential": true,
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "/ecs/my-task",
          "awslogs-region": "ap-northeast-1",
          "awslogs-stream-prefix": "ecs"
        }
      }
    }
  ]
}

aws ecs register-task-definition \
  --cli-input-json file://task-definition.json \
  --tags key=Name,value=my-task

タスク定義の一覧を表示する

aws ecs list-task-definitions

タスク定義を表示する（タスク定義のファミリー名：リビジョン番号 指定）

aws ecs describe-task-definition \
  --task-definition my-task:1

タスク定義を削除する（タスク定義のファミリー名：リビジョン番号 指定）

aws ecs deregister-task-definition \
  --task-definition my-task:1

ECSサービスを作成する（マルチＡＺのSubnet、SG ID、ALB連携関連 指定）

aws ecs create-service \
  --cluster MyCluster \
  --service-name my-service \
  --task-definition my-task:1 \
  --desired-count 2 \
  --launch-type FARGATE \
  --network-configuration "awsvpcConfiguration={
    subnets=[subnet-xxxxxxxx,subnet-yyyyyyyy],
    securityGroups=[sg-xxxxxxxx]
  }" \
  --load-balancers \
    targetGroupArn=arn:aws:elasticloadbalancing:ap-northeast-1:123456789012:targetgroup/my-targets/50dc6c495c0c9188,\
    containerName=my-container,\
    containerPort=80 \
  --tags key=Name,value=my-service

ECSサービスを手動起動する（クラスタ名 指定）

aws ecs run-task \
  --cluster MyCluster \
  --task-definition my-task:1 \
  --count 2 \
  --launch-type FARGATE \
  --network-configuration "awsvpcConfiguration={
    subnets=[subnet-xxxxxxxx,subnet-yyyyyyyy],
    securityGroups=[sg-xxxxxxxx]
  }" \
  --tags key=Name,value=my-task-manual

ECSサービスの一覧を表示する（クラスタ名 指定）

aws ecs list-services \
  --cluster MyCluster

ECSサービスを表示する（クラスタ名、サービス名 指定）

aws ecs describe-services \
  --cluster MyCluster \
  --services my-service

ECSサービスを削除する（クラスタ名、サービス名 指定）

aws ecs delete-service \
  --cluster MyCluster \
  --service my-service

ECSタスクの一覧を表示する（クラスタ名 指定）

aws ecs list-tasks \
  --cluster MyCluster

ECSタスクを停止する（タスク ID 指定）

aaws ecs stop-task \
  --cluster MyCluster \
  --task arn:aws:ecs:ap-northeast-1:123456789012:task/MyCluster/abc123def456

CloudFormationのサンプルコード

Terraformのサンプルコード

料金計算

公式ページ