AWS ECS・Fargateでコンテナアプリを本番運用するための設計手順｜タスク定義・ALB連携・マルチAZ配置の構成パターン入門

この記事のポイント

・FargateはサーバーレスでEC2管理が不要。本番用途では最初の選択肢になる
・タスク定義でCPU・メモリ・コンテナ定義・ログ設定を一元管理する
・ECSサービス＋ALBでマルチAZに分散配置してヘルスチェックを自動化する
・Auto ScalingはCPU使用率70%をトリガーにするターゲットトラッキングが基本

# タスク定義のJSON（コンテナ定義部分の抜粋）
{
  "family": "myapp-task",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "cpu": "512",
  "memory": "1024",
  "containerDefinitions": [
    {
      "name": "myapp",
      "image": "123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:latest",
      "portMappings": [
        {
          "containerPort": 8080,
          "protocol": "tcp"
        }
      ],
      "environment": [
        {"name": "APP_ENV", "value": "production"},
        {"name": "LOG_LEVEL", "value": "info"}
      ],
      "secrets": [
        {
          "name": "DB_PASSWORD",
          "valueFrom": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:myapp/db-password"
        }
      ],
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "/ecs/myapp",
          "awslogs-region": "ap-northeast-1",
          "awslogs-stream-prefix": "ecs"
        }
      }
    }
  ]
}

# CloudWatch Logsのロググループを作成する
aws logs create-log-group   --log-group-name /ecs/myapp   --region ap-northeast-1

# ロググループの保持期間を30日に設定する
aws logs put-retention-policy   --log-group-name /ecs/myapp   --retention-in-days 30

# ターゲットグループを作成する（FargateはIPターゲット）
aws elbv2 create-target-group   --name myapp-tg   --protocol HTTP   --port 8080   --vpc-id vpc-0123456789abcdef0   --target-type ip   --health-check-path /health   --health-check-interval-seconds 30   --healthy-threshold-count 2   --unhealthy-threshold-count 3

# 出力例
{
    "TargetGroups": [
        {
            "TargetGroupArn": "arn:aws:elasticloadbalancing:ap-northeast-1:123456789012:targetgroup/myapp-tg/abc123def456",
            "TargetGroupName": "myapp-tg",
            "Protocol": "HTTP",
            "Port": 8080,
            "HealthCheckPath": "/health",
            ...
        }
    ]
}

# ECSサービスを作成する（ALBと連携・マルチAZ）
aws ecs create-service   --cluster myapp-cluster   --service-name myapp-service   --task-definition myapp-task:1   --desired-count 2   --launch-type FARGATE   --network-configuration "awsvpcConfiguration={
    subnets=[subnet-0a1b2c3d4e,subnet-0f1e2d3c4b],
    securityGroups=[sg-0123456789abcdef0],
    assignPublicIp=DISABLED
  }"   --load-balancers "targetGroupArn=arn:aws:elasticloadbalancing:ap-northeast-1:123456789012:targetgroup/myapp-tg/abc123,containerName=myapp,containerPort=8080"

# タスク配置戦略を確認する
aws ecs describe-services   --cluster myapp-cluster   --services myapp-service   --query 'services[0].placementStrategy'

# AZ均等分散の配置戦略を設定する（update-service）
aws ecs update-service   --cluster myapp-cluster   --service myapp-service   --placement-strategy "[{"type":"spread","field":"attribute:ecs.availability-zone"}]"

# ECSサービスをAuto Scalingのターゲットとして登録する
aws application-autoscaling register-scalable-target   --service-namespace ecs   --scalable-dimension ecs:service:DesiredCount   --resource-id service/myapp-cluster/myapp-service   --min-capacity 2   --max-capacity 10

# CPU使用率70%を目標にするターゲットトラッキングポリシーを設定する
aws application-autoscaling put-scaling-policy   --service-namespace ecs   --scalable-dimension ecs:service:DesiredCount   --resource-id service/myapp-cluster/myapp-service   --policy-name myapp-cpu-scaling   --policy-type TargetTrackingScaling   --target-tracking-scaling-policy-configuration '{
    "TargetValue": 70.0,
    "PredefinedMetricSpecification": {
      "PredefinedMetricType": "ECSServiceAverageCPUUtilization"
    },
    "ScaleOutCooldown": 60,
    "ScaleInCooldown": 300
  }'

# 実行ロールに必要な最低限のポリシー（AWSマネージドポリシー）
# AmazonECSTaskExecutionRolePolicy に以下が含まれる
# - ecr:GetAuthorizationToken
# - ecr:BatchGetImage
# - logs:CreateLogStream
# - logs:PutLogEvents

# SecretsManagerを使う場合は追加で以下が必要
# - secretsmanager:GetSecretValue
# - kms:Decrypt（KMSで暗号化している場合）

# タスクロールの例（S3とDynamoDBを使うアプリケーション用）
aws iam create-role   --role-name myapp-task-role   --assume-role-policy-document '{
    "Version": "2012-10-17",
    "Statement": [{
      "Effect": "Allow",
      "Principal": {"Service": "ecs-tasks.amazonaws.com"},
      "Action": "sts:AssumeRole"
    }]
  }'

# 停止したタスクの停止理由を確認する
aws ecs describe-tasks   --cluster myapp-cluster   --tasks arn:aws:ecs:ap-northeast-1:123456789012:task/myapp-cluster/a1b2c3d4   --query 'tasks[0].{status:lastStatus,stopCode:stopCode,reason:stoppedReason}'

# 出力例（実行ロールの権限不足の場合）
{
    "status": "STOPPED",
    "stopCode": "TaskFailedToStart",
    "reason": "CannotPullContainerError: pull image manifest has been retried 5 time(s): ..."
}

# CloudWatch Logsでコンテナのエラーログを確認する
aws logs get-log-events   --log-group-name /ecs/myapp   --log-stream-name ecs/myapp/a1b2c3d4   --limit 50

# ターゲットグループのヘルスチェック状態を確認する
aws elbv2 describe-target-health   --target-group-arn arn:aws:elasticloadbalancing:ap-northeast-1:123456789012:targetgroup/myapp-tg/abc123   --query 'TargetHealthDescriptions[*].{id:Target.Id,port:Target.Port,state:TargetHealth.State,reason:TargetHealth.Reason}'

# 出力例（unhealthyの場合）
[
    {
        "id": "10.0.1.45",
        "port": 8080,
        "state": "unhealthy",
        "reason": "Target.ResponseCodeMismatch"
    }
]