MENU

問い合わせ

    お問い合わせ


    【Laravel+Vue.jsで作る管理画面をECSで動かす 第9回】ECR・ECS on Fargate・ALB:管理画面をインターネットに公開する

    いよいよ、第6回で作ったコンテナイメージを AWS の ECS on Fargate(=サーバーを自分で管理せずにコンテナを動かせるサービス)で動かし、ALB(=ロードバランサー。利用者からのアクセスを受けて複数のコンテナに振り分ける装置)経由で HTTPS 公開します。

    「コンテナで動かすと聞いたけれど、ECS のタスク定義・サービス・ALB・IAM ロールと部品が多すぎて、どれが何をしているのか分からない…」

    結論から言うと、ECS で Laravel の管理画面を公開するときの部品は「イメージ置き場(ECR)」「コンテナの設計図(タスク定義)」「台数を保つ係(サービス)」「入口(ALB)」の4つで、権限は「ECS が使うロール」と「アプリが使うロール」に分けます。この回ではこれらを Terraform で定義し、あわせて ALB の裏で Laravel が HTTPS を正しく認識するための設定(信頼するプロキシ)を入れます。

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    前回(第8回:RDS for MySQL と秘密情報)では、RDS と秘密情報の置き場所、秘密情報を読むためのタスク実行ロールを作りました。今回はそれらをタスク定義から参照します。新しく作るファイルは全文を、すでにあるファイルは変更箇所を差分で載せています。

    これまでと同じく、執筆環境には AWS アカウントがないため、terraform apply は行っていません。terraform validate と、AWS に接続しない形での plan、ローカルの Docker での動作確認までを行っています。

    目次

    ECS で管理画面を公開するための部品

    今回追加・変更するファイルは次のとおりです。

    ファイル内容
    infra/terraform/ecr.tfイメージの置き場所(app = php-fpm、web = nginx)と古いイメージの自動削除
    infra/terraform/logs.tfコンテナのログの保存先(CloudWatch Logs)と保持期間
    infra/terraform/ecs_cluster.tfECS クラスターと、タスク定義で共通に使う環境変数・秘密情報の参照
    infra/terraform/ecs_web.tfweb のタスク定義(nginx + php-fpm)とサービス
    infra/terraform/alb.tfALB、ターゲットグループ(ヘルスチェック /up)、HTTP→HTTPS リダイレクト、HTTPS リスナー
    infra/terraform/iam.tfアプリ用のタスクロールを追加
    infra/terraform/security_groups.tfALB に接続できる IP 範囲を変数化
    config/trustedproxy.php、tests/Feature/TrustedProxyTest.phpALB を信頼するプロキシとして扱う設定とテスト

    リクエストの流れは次のようになります。

    • 利用者のブラウザ →(HTTPS)→ ALB(public サブネット)
    • ALB →(HTTP 8080)→ web タスクの nginx(private サブネット)
    • nginx →(127.0.0.1:9000)→ 同じタスクの php-fpm(Laravel)
    • php-fpm → RDS(3306)、ログは標準出力 → CloudWatch Logs

    ECR:イメージの置き場所を作る

    infra/terraform/ecr.tf を新しく作ります。

    # infra/terraform/ecr.tf
    # ECR:コンテナイメージの置き場所(第9回)
    #
    #   app : php-fpm(web タスクの php コンテナ・worker・scheduler・migrate で共通)
    #   web : nginx(web タスクの nginx コンテナ)
    #
    # タグは Git のコミット ID などを付け、同じタグの上書きを禁止する(IMMUTABLE)。
    # 「どのコードが動いているか」をタグから必ずたどれるようにするため。
    
    locals {
      ecr_repositories = toset(["app", "web"])
    }
    
    resource "aws_ecr_repository" "this" {
      for_each = local.ecr_repositories
    
      name                 = "${local.name_prefix}-${each.key}"
      image_tag_mutability = "IMMUTABLE"
    
      # push 時に既知の脆弱性をスキャンする(基本スキャン)
      image_scanning_configuration {
        scan_on_push = true
      }
    
      encryption_configuration {
        encryption_type = "AES256"
      }
    
      tags = { Name = "${local.name_prefix}-${each.key}" }
    }
    
    # 古いイメージを自動で削除する(保管費用を抑える)。切り戻し用に直近の数世代は残す
    resource "aws_ecr_lifecycle_policy" "this" {
      for_each = aws_ecr_repository.this
    
      repository = each.value.name
      policy = jsonencode({
        rules = [
          {
            rulePriority = 1
            description  = "Delete untagged images after 1 day"
            selection = {
              tagStatus   = "untagged"
              countType   = "sinceImagePushed"
              countUnit   = "days"
              countNumber = 1
            }
            action = { type = "expire" }
          },
          {
            rulePriority = 2
            description  = "Keep only the latest ${var.ecr_keep_images} images"
            selection = {
              tagStatus   = "any"
              countType   = "imageCountMoreThan"
              countNumber = var.ecr_keep_images
            }
            action = { type = "expire" }
          },
        ]
      })
    }

    ポイントは image_tag_mutability = "IMMUTABLE" です。同じタグでイメージを上書きできなくするので、latest のような使い回しのタグではなく、Git のコミット ID などをタグにします。「今どのコードが動いているか」をタグから必ずたどれるようにし、切り戻し(前の版に戻す)のときも迷わないようにするためです。

    ライフサイクルポリシーは、イメージを無制限にためないための設定です。ただし、残す世代数は「どこまで前の版に戻せるか」と同じ意味になるので、少なくしすぎないようにします。

    📰 出典:Amazon ECR のライフサイクルポリシー(Amazon ECR ユーザーガイド)

    コンテナのログの保存先も先に作っておきます。infra/terraform/logs.tf を新しく作ります。

    # infra/terraform/logs.tf
    # CloudWatch Logs:コンテナの標準出力・標準エラーの保存先(第9回)
    #
    # Fargate のコンテナ内のファイルはタスクが止まると消えるため、ログはすべて標準出力に出し
    # awslogs ドライバでここへ送る(Laravel は LOG_CHANNEL=stderr、nginx は /dev/stdout)。
    # 保持期間を決めておかないと無期限に保存され、保管費用が増え続ける。
    
    locals {
      # web(nginx+php-fpm)、worker、scheduler、migrate(第10回で使う)
      log_groups = toset(["web", "worker", "scheduler", "migrate"])
    }
    
    resource "aws_cloudwatch_log_group" "ecs" {
      for_each = local.log_groups
    
      name              = "/ecs/${local.name_prefix}/${each.key}"
      retention_in_days = var.log_retention_days
    
      tags = { Name = "${local.name_prefix}-${each.key}" }
    }

    タスク定義:nginx と php-fpm を1つのタスクにまとめる

    共通の環境変数と秘密情報

    web・worker・scheduler・migrate(第10回)の php コンテナには、同じ環境変数と秘密情報を渡します。そこで、ecs_cluster.tf の locals に一度だけ書いて使い回します。

    infra/terraform/ecs_cluster.tf を新しく作ります。

    # infra/terraform/ecs_cluster.tf
    # ECS クラスターと、タスク定義で共通に使う値(第9回)
    
    resource "aws_ecs_cluster" "main" {
      name = local.name_prefix
    
      # Container Insights(タスクごとの CPU・メモリなどの詳細メトリクス)は追加費用がかかるため変数で切り替える
      setting {
        name  = "containerInsights"
        value = var.enable_container_insights ? "enabled" : "disabled"
      }
    
      tags = { Name = local.name_prefix }
    }
    
    locals {
      # php コンテナ(web・worker・scheduler・migrate 共通)に渡す環境変数。秘密ではない値だけ
      app_environment = [
        { name = "APP_NAME", value = "Admin Console" },
        { name = "APP_URL", value = "https://${var.app_domain}" },
        { name = "APP_LOCALE", value = "ja" },
        { name = "APP_FALLBACK_LOCALE", value = "en" },
        { name = "DB_CONNECTION", value = "mysql" },
        { name = "DB_HOST", value = aws_db_instance.main.address },
        { name = "DB_PORT", value = tostring(aws_db_instance.main.port) },
        { name = "DB_DATABASE", value = aws_db_instance.main.db_name },
        { name = "SESSION_DRIVER", value = "database" },
        { name = "SESSION_SECURE_COOKIE", value = "true" },
        { name = "CACHE_STORE", value = "database" },
        { name = "QUEUE_CONNECTION", value = "database" },
        # ALB からの X-Forwarded-* を信用する範囲(config/trustedproxy.php)
        { name = "TRUSTED_PROXIES", value = var.vpc_cidr },
      ]
    
      # 秘密情報:値ではなく「どこにあるか(ARN)」だけを書く。取得はタスク実行ロールが行う(第8回)
      app_secrets = concat(
        [
          { name = "DB_USERNAME", valueFrom = "${aws_db_instance.main.master_user_secret[0].secret_arn}:username::" },
          { name = "DB_PASSWORD", valueFrom = "${aws_db_instance.main.master_user_secret[0].secret_arn}:password::" },
        ],
        [for name, p in aws_ssm_parameter.app_secret : { name = name, valueFrom = p.arn }],
      )
    
      app_image = "${aws_ecr_repository.this["app"].repository_url}:${var.image_tag}"
      web_image = "${aws_ecr_repository.this["web"].repository_url}:${var.image_tag}"
    }

    secrets に書くのは値ではなく ARN(=AWS 上の場所を表す識別子)です。RDS が管理するシークレットは username と password を持つ JSON なので、ARN の後ろに :password:: のようにキー名を付けて、その項目だけを環境変数に入れます。ECS がタスクの起動時にタスク実行ロールの権限で値を取り出し、コンテナの環境変数として渡します。

    📰 出典:Secrets Manager シークレットを環境変数として Amazon ECS に渡す(Amazon ECS デベロッパーガイド)

    第6回の本番イメージは .env を含まず、APP_ENV=production・APP_DEBUG=false・LOG_CHANNEL=stderr だけをイメージの既定値にしています。それ以外の設定は、すべてこのタスク定義から渡すことになります。

    web のタスク定義

    infra/terraform/ecs_web.tf を新しく作ります。全文は次のとおりです(クリックで開きます)。タスク定義とサービスの部分を、以下で抜き出して説明します。

    infra/terraform/ecs_web.tf の全文(98行)
    # infra/terraform/ecs_web.tf
    # web サービス:nginx + php-fpm を1つのタスクで動かし、ALB から受ける(第9回)
    #
    #   ALB ──8080──▶ [nginx] ──127.0.0.1:9000──▶ [php]
    #   awsvpc モードでは同じタスクのコンテナは localhost を共有する(compose.prod.yaml の network_mode: service:app と同じ)
    
    resource "aws_ecs_task_definition" "web" {
      family                   = "${local.name_prefix}-web"
      requires_compatibilities = ["FARGATE"]
      network_mode             = "awsvpc"
      cpu                      = var.web_cpu
      memory                   = var.web_memory
    
      # タスク実行ロール:ECS がイメージ取得・ログ送信・secrets の取得に使う(第8回)
      execution_role_arn = aws_iam_role.ecs_task_execution.arn
      # タスクロール:アプリ(Laravel)が AWS のサービスを使うときの権限(第10回で SQS を追加)
      task_role_arn = aws_iam_role.ecs_task.arn
    
      runtime_platform {
        operating_system_family = "LINUX"
        cpu_architecture        = "X86_64" # イメージをビルドする環境に合わせる
      }
    
      container_definitions = jsonencode([
        {
          name      = "php"
          image     = local.app_image
          essential = true
          # CMD の既定(php-fpm)のまま。ENTRYPOINT が起動時に php artisan optimize を実行する(第6回)
          environment = local.app_environment
          secrets     = local.app_secrets
          logConfiguration = {
            logDriver = "awslogs"
            options = {
              awslogs-group         = aws_cloudwatch_log_group.ecs["web"].name
              awslogs-region        = var.region
              awslogs-stream-prefix = "php"
            }
          }
        },
        {
          name      = "nginx"
          image     = local.web_image
          essential = true
          portMappings = [
            { containerPort = 8080, protocol = "tcp" }
          ]
          # php コンテナが起動してから nginx を起動する
          dependsOn = [
            { containerName = "php", condition = "START" }
          ]
          logConfiguration = {
            logDriver = "awslogs"
            options = {
              awslogs-group         = aws_cloudwatch_log_group.ecs["web"].name
              awslogs-region        = var.region
              awslogs-stream-prefix = "nginx"
            }
          }
        },
      ])
    
      tags = { Name = "${local.name_prefix}-web" }
    }
    
    resource "aws_ecs_service" "web" {
      name            = "web"
      cluster         = aws_ecs_cluster.main.id
      task_definition = aws_ecs_task_definition.web.arn
      desired_count   = var.web_desired_count
    
      launch_type = "FARGATE"
    
      # private サブネット(2AZ)に置き、パブリック IP は付けない。外向きは NAT Gateway 経由(第7回)
      network_configuration {
        subnets          = aws_subnet.private[*].id
        security_groups  = [aws_security_group.web.id]
        assign_public_ip = false
      }
    
      load_balancer {
        target_group_arn = aws_lb_target_group.web.arn
        container_name   = "nginx"
        container_port   = 8080
      }
    
      # 起動直後(php artisan optimize の実行中など)にヘルスチェック失敗で入れ替えられないよう、猶予を置く
      health_check_grace_period_seconds = 60
    
      # デプロイ時:新しいタスクが healthy になってから古いタスクを止める(台数が一時的に最大2倍になる)
      deployment_minimum_healthy_percent = 100
      deployment_maximum_percent         = 200
    
      # ALB のリスナーができる前にサービスを作るとエラーになるため、順序を明示する
      depends_on = [aws_lb_listener.https]
    
      tags = { Name = "${local.name_prefix}-web" }
    }

    infra/terraform/ecs_web.tf(全文のうちタスク定義の部分)

    resource "aws_ecs_task_definition" "web" {
      family                   = "${local.name_prefix}-web"
      requires_compatibilities = ["FARGATE"]
      network_mode             = "awsvpc"
      cpu                      = var.web_cpu
      memory                   = var.web_memory
    
      # タスク実行ロール:ECS がイメージ取得・ログ送信・secrets の取得に使う(第8回)
      execution_role_arn = aws_iam_role.ecs_task_execution.arn
      # タスクロール:アプリ(Laravel)が AWS のサービスを使うときの権限(第10回で SQS を追加)
      task_role_arn = aws_iam_role.ecs_task.arn
    
      container_definitions = jsonencode([
        {
          name      = "php"
          image     = local.app_image
          essential = true
          # CMD の既定(php-fpm)のまま。ENTRYPOINT が起動時に php artisan optimize を実行する(第6回)
          environment = local.app_environment
          secrets     = local.app_secrets
          logConfiguration = {
            logDriver = "awslogs"
            options = {
              awslogs-group         = aws_cloudwatch_log_group.ecs["web"].name
              awslogs-region        = var.region
              awslogs-stream-prefix = "php"
            }
          }
        },
        {
          name      = "nginx"
          image     = local.web_image
          essential = true
          portMappings = [
            { containerPort = 8080, protocol = "tcp" }
          ]
          # php コンテナが起動してから nginx を起動する
          dependsOn = [
            { containerName = "php", condition = "START" }
          ]
          # (logConfiguration は php と同じ。awslogs-stream-prefix = "nginx")
        },
      ])
    
      # (runtime_platform と tags は省略)
    }

    network_mode = "awsvpc" では、同じタスクのコンテナは localhost を共有します。第6回で nginx の転送先を 127.0.0.1:9000 にし、compose.prod.yaml で network_mode: service:app を使って確認したのは、この動きをローカルで再現するためでした。

    CPU とメモリはタスク全体(nginx と php-fpm の合計)の値で、Fargate では決まった組み合わせから選びます。0.5 vCPU(512)なら、メモリは 1GB〜4GB の範囲です。

    📰 出典:Fargate の Amazon ECS タスク定義の CPU とメモリ(Amazon ECS デベロッパーガイド)

    タスク実行ロールとタスクロールを分ける

    task_role_arn に指定したタスクロールは、今回新しく作ったロールです。

    infra/terraform/iam.tf に次の変更を加えます(+ が追加、- が削除)。

    --- a/infra/terraform/iam.tf
    +++ b/infra/terraform/iam.tf
    @@ -2,7 +2,7 @@
     # ECS のタスク実行ロール:ECS エージェントがタスクを起動するときに使う権限
     #   - ECR からイメージを取得する、CloudWatch Logs にログを送る(AWS 管理ポリシー)
     #   - タスク定義の secrets に書いた値を取得する(下のインラインポリシー。対象の ARN だけに絞る)
    -# アプリ自身が AWS を使うための「タスクロール」は別に作る(第9回)
    +# アプリ自身が AWS を使うための「タスクロール」は別に作る(このファイルの下部。第9回)
     
     data "aws_iam_policy_document" "ecs_tasks_assume" {
       statement {
    @@ -46,3 +46,11 @@ resource "aws_iam_role_policy" "ecs_task_execution_secrets" {
       role   = aws_iam_role.ecs_task_execution.id
       policy = data.aws_iam_policy_document.ecs_task_execution_secrets.json
     }
    +
    +# ---------- タスクロール(第9回):アプリ(Laravel)自身が AWS のサービスを使うときの権限 ----------
    +# 第9回の時点では権限を付けない(DB へは SG と DB ユーザーで接続し、IAM 権限は使わない)。
    +# 第10回で SQS の送受信の権限をここに追加する。
    +resource "aws_iam_role" "ecs_task" {
    +  name               = "${local.name_prefix}-ecs-task"
    +  assume_role_policy = data.aws_iam_policy_document.ecs_tasks_assume.json
    +}

    2つのロールの違いは次のとおりです。

    ロール使う主体主な権限
    タスク実行ロール(第8回)ECS(タスクを起動する側)ECR からのイメージ取得、ログ送信、secrets の取得
    タスクロール(今回)コンテナ内のアプリ(Laravel)アプリが呼ぶ AWS サービス(第10回で SQS)

    分けておくと、アプリに脆弱性があって AWS の認証情報を悪用されたとしても、秘密情報の取得権限までは渡りません。今の時点でタスクロールに権限は何もありません。

    📰 出典:Amazon ECS タスクの IAM ロール(Amazon ECS デベロッパーガイド)

    サービスと ALB:2つの AZ で動かし、/up で見張る

    infra/terraform/ecs_web.tf(全文のうちサービスの部分)

    resource "aws_ecs_service" "web" {
      name            = "web"
      cluster         = aws_ecs_cluster.main.id
      task_definition = aws_ecs_task_definition.web.arn
      desired_count   = var.web_desired_count
      launch_type     = "FARGATE"
    
      # private サブネット(2AZ)に置き、パブリック IP は付けない。外向きは NAT Gateway 経由(第7回)
      network_configuration {
        subnets          = aws_subnet.private[*].id
        security_groups  = [aws_security_group.web.id]
        assign_public_ip = false
      }
    
      load_balancer {
        target_group_arn = aws_lb_target_group.web.arn
        container_name   = "nginx"
        container_port   = 8080
      }
    
      # 起動直後(php artisan optimize の実行中など)にヘルスチェック失敗で入れ替えられないよう、猶予を置く
      health_check_grace_period_seconds = 60
    
      # デプロイ時:新しいタスクが healthy になってから古いタスクを止める(台数が一時的に最大2倍になる)
      deployment_minimum_healthy_percent = 100
      deployment_maximum_percent         = 200
    
      # (depends_on と tags は省略)
    }

    サービスは「指定した台数(desired_count)のタスクを動かし続ける係」です。タスクが落ちれば新しく起動し直し、ALB のターゲットにも自動で登録します。既定の2台は、2つの AZ(=データセンターのまとまり)に分かれて置かれるので、片方の AZ に障害が起きても画面は使えます。

    infra/terraform/alb.tf を新しく作ります。

    # infra/terraform/alb.tf
    # ALB:インターネットからの HTTPS を受けて、web タスク(nginx:8080)に振り分ける(第9回)
    #
    #   :80  → :443 へリダイレクト
    #   :443 → ターゲットグループ(ECS の web タスク。ヘルスチェック GET /up)
    #   証明書は ACM で発行したものの ARN を変数で渡す(ドメインの DNS 検証は別途行う)
    
    resource "aws_lb" "main" {
      name               = "${local.name_prefix}-alb"
      load_balancer_type = "application"
      internal           = false
      subnets            = aws_subnet.public[*].id
      security_groups    = [aws_security_group.alb.id]
    
      # 不正な形式のヘッダーを持つリクエストを ALB で落とす
      drop_invalid_header_fields = true
      # 誤って削除しないように(本番は true を推奨)
      enable_deletion_protection = var.alb_deletion_protection
    
      tags = { Name = "${local.name_prefix}-alb" }
    }
    
    resource "aws_lb_target_group" "web" {
      name        = "${local.name_prefix}-web"
      target_type = "ip" # Fargate(awsvpc)はタスクの IP アドレスを登録する
      port        = 8080
      protocol    = "HTTP"
      vpc_id      = aws_vpc.main.id
    
      health_check {
        path                = "/up" # Laravel のヘルスチェック用ルート(bootstrap/app.php の health: '/up')
        matcher             = "200"
        interval            = 15
        timeout             = 5
        healthy_threshold   = 2
        unhealthy_threshold = 3
      }
    
      # デプロイ時、古いタスクへの処理中リクエストを待つ時間(既定 300 秒は長いので短くする)
      deregistration_delay = 30
    
      tags = { Name = "${local.name_prefix}-web" }
    }
    
    resource "aws_lb_listener" "http" {
      load_balancer_arn = aws_lb.main.arn
      port              = 80
      protocol          = "HTTP"
    
      default_action {
        type = "redirect"
    
        redirect {
          protocol    = "HTTPS"
          port        = "443"
          status_code = "HTTP_301"
        }
      }
    }
    
    resource "aws_lb_listener" "https" {
      load_balancer_arn = aws_lb.main.arn
      port              = 443
      protocol          = "HTTPS"
      ssl_policy        = "ELBSecurityPolicy-TLS13-1-2-2021-06" # TLS 1.2 以上
      certificate_arn   = var.acm_certificate_arn
    
      default_action {
        type             = "forward"
        target_group_arn = aws_lb_target_group.web.arn
      }
    }

    80番(HTTP)のリスナーは、443番(HTTPS)へ 301 リダイレクトするだけにしています。証明書は、ドメインの DNS で検証して ACM(=AWS の無料の証明書発行サービス)に発行したものの ARN を変数で渡します。ドメインの取得や DNS の設定は、会社ごとに管理の仕方が違うため Terraform の外に出しました。

    ALB は /up に定期的にアクセスし、200 が返るタスクだけにリクエストを流します。

    📰 出典:ターゲットグループのヘルスチェック(Application Load Balancer ユーザーガイド)

    接続できる IP を絞る

    infra/terraform/security_groups.tf に次の変更を加えます(+ が追加、- が削除)。

    --- a/infra/terraform/security_groups.tf
    +++ b/infra/terraform/security_groups.tf
    @@ -14,19 +14,25 @@ resource "aws_security_group" "alb" {
       tags = { Name = "${local.name_prefix}-alb" }
     }
     
    +# 接続を許可する元の IP 範囲は変数で指定する(第9回)。既定はインターネット全体、
    +# 検証環境や社内専用の管理画面なら、社内・VPN の IP だけに絞る
     resource "aws_vpc_security_group_ingress_rule" "alb_http" {
    +  for_each = toset(var.alb_ingress_cidrs)
    +
       security_group_id = aws_security_group.alb.id
       description       = "HTTP (redirect to HTTPS)"
    -  cidr_ipv4         = "0.0.0.0/0"
    +  cidr_ipv4         = each.value
       ip_protocol       = "tcp"
       from_port         = 80
       to_port           = 80
     }
     
     resource "aws_vpc_security_group_ingress_rule" "alb_https" {
    +  for_each = toset(var.alb_ingress_cidrs)
    +
       security_group_id = aws_security_group.alb.id
       description       = "HTTPS"
    -  cidr_ipv4         = "0.0.0.0/0"
    +  cidr_ipv4         = each.value
       ip_protocol       = "tcp"
       from_port         = 443
       to_port           = 443

    社内向けの管理画面なら、インターネット全体に公開する理由はあまりありません。terraform.tfvars の alb_ingress_cidrs に社内や VPN の IP 範囲を書けば、それ以外からは ALB に届かなくなります。特にこの連載のサンプルは、スターターキットの会員登録画面を残したままです(第3回で触れたとおり)。誰でもアカウントを作れる状態でインターネット全体に公開しないよう、最初は IP で絞っておくことをおすすめします。

    ALB の裏で HTTPS を正しく認識させる(TrustProxies)

    ALB で HTTPS を終端すると、Laravel から見た通信は「ALB から来た HTTP」です。そのままだと、リダイレクト先やフォームの送信先の URL が http:// で作られ、画面が正しく動きません。

    Laravel には、リバースプロキシ(=利用者とアプリの間に立って中継するサーバー。ここでは ALB)が付ける X-Forwarded-Proto などのヘッダーを信用する仕組み(TrustProxies ミドルウェア)が最初から入っています。信用する接続元を設定ファイルで指定しました。

    config/trustedproxy.php を新しく作ります。

    <?php
    
    // config/trustedproxy.php
    
    declare(strict_types=1);
    
    /*
    | 信頼するリバースプロキシ(ALB)の IP アドレス範囲(第9回)
    |
    | ECS では、ブラウザ → ALB(HTTPS)→ nginx(HTTP 8080)→ php-fpm の順に届く。
    | Laravel から見ると接続元は ALB で、通信は HTTP に見えるため、そのままでは
    | 生成される URL が http:// になったり、アクセス元 IP が ALB の IP になったりする。
    |
    | ここに書いた範囲からの接続に限り、ALB が付ける X-Forwarded-For / X-Forwarded-Proto などを信用する。
    | フレームワークの TrustProxies ミドルウェア(既定で有効)が、bootstrap/app.php で
    | trustProxies(at: ...) を指定していないときにこの設定を読む。
    |
    | 例:TRUSTED_PROXIES=10.0.0.0/16(VPC の範囲。ECS のタスク定義で渡す)
    | 未設定(ローカル開発)の場合はどのプロキシも信用しない。
    */
    
    return [
        'proxies' => env('TRUSTED_PROXIES'),
    ];

    公式ドキュメントでは bootstrap/app.php で trustProxies(at: '*') のように指定する方法が紹介されています。今回は、設定キャッシュ(php artisan optimize)と環境変数で切り替えやすいように設定ファイルにし、値には VPC の IP 範囲を渡しました。web タスクには ALB からしか届かないようにセキュリティグループで絞っていますが、ヘッダーを信用する範囲も VPC 内に限定しておけば、万一ほかの経路から届いた偽のヘッダーは無視されます。

    📰 出典:信頼できるプロキシの設定(Laravel 12.x ドキュメント)

    tests/Feature/TrustedProxyTest.php を新しく作ります。

    <?php
    
    // tests/Feature/TrustedProxyTest.php
    
    declare(strict_types=1);
    
    namespace Tests\Feature;
    
    use Tests\TestCase;
    
    /**
     * ALB 経由のアクセスで、HTTPS として扱われるか(第9回)
     * 未ログインで /dashboard にアクセスしたときのリダイレクト先 URL のスキームで確認する。
     */
    class TrustedProxyTest extends TestCase
    {
        /** @var array<string, string> ALB が付けるヘッダー */
        private array $albHeaders = [
            'X-Forwarded-Proto' => 'https',
            'X-Forwarded-Port' => '443',
            'X-Forwarded-For' => '203.0.113.10',
        ];
    
        public function test_requests_from_trusted_proxy_are_treated_as_https(): void
        {
            config(['trustedproxy.proxies' => '10.0.0.0/16']);
    
            $response = $this->withServerVariables(['REMOTE_ADDR' => '10.0.1.25'])
                ->withHeaders($this->albHeaders)
                ->get('/dashboard');
    
            $response->assertRedirect();
            $this->assertStringStartsWith('https://', (string) $response->headers->get('Location'));
        }
    
        public function test_forwarded_headers_from_untrusted_address_are_ignored(): void
        {
            config(['trustedproxy.proxies' => '10.0.0.0/16']);
    
            // VPC の外から直接ヘッダーを偽装しても、HTTPS 扱いにはならない
            $response = $this->withServerVariables(['REMOTE_ADDR' => '198.51.100.7'])
                ->withHeaders($this->albHeaders)
                ->get('/dashboard');
    
            $response->assertRedirect();
            $this->assertStringStartsWith('http://', (string) $response->headers->get('Location'));
        }
    
        public function test_no_proxy_is_trusted_by_default(): void
        {
            config(['trustedproxy.proxies' => null]);
    
            $response = $this->withServerVariables(['REMOTE_ADDR' => '10.0.1.25'])
                ->withHeaders($this->albHeaders)
                ->get('/dashboard');
    
            $response->assertRedirect();
            $this->assertStringStartsWith('http://', (string) $response->headers->get('Location'));
        }
    
        public function test_client_ip_is_taken_from_forwarded_header_behind_trusted_proxy(): void
        {
            config(['trustedproxy.proxies' => '10.0.0.0/16']);
    
            $this->withServerVariables(['REMOTE_ADDR' => '10.0.1.25'])
                ->withHeaders($this->albHeaders)
                ->get('/up')
                ->assertOk();
    
            $this->assertSame('203.0.113.10', request()->ip());
        }
    }

    未ログインで /dashboard を開いたときのログイン画面へのリダイレクト先で、HTTPS として扱われているかを確かめています。このほか、設定がない場合は信用しないこと、信用した場合はアクセス元 IP が X-Forwarded-For の値になることもテストしています。あわせて、タスク定義で SESSION_SECURE_COOKIE=true を渡し、セッションの Cookie が HTTPS のときだけ送られるようにしました。

    変数・出力・変数の例を追加する

    今回のファイルが使う変数(ドメイン名・証明書・イメージのタグ・タスクの CPU とメモリなど)と、デプロイで使う出力を追加します。第8回までの3つのファイルに、次の変更を加えます(+ が追加、- が削除)。terraform.tfvars を作っている場合は、同じ項目を自分の環境の値で足してください。

    --- a/infra/terraform/variables.tf
    +++ b/infra/terraform/variables.tf
    @@ -98,3 +98,67 @@ variable "app_secret_names" {
       type        = set(string)
       default     = ["APP_KEY"]
     }
    +
    +# ---------- ECR・ECS・ALB(第9回) ----------
    +variable "app_domain" {
    +  description = "管理画面のドメイン名(例:admin-stg.example.com)。APP_URL に使う"
    +  type        = string
    +}
    +
    +variable "acm_certificate_arn" {
    +  description = "ALB の HTTPS リスナーに使う ACM 証明書の ARN(app_domain を含む証明書を事前に発行しておく)"
    +  type        = string
    +}
    +
    +variable "alb_ingress_cidrs" {
    +  description = "ALB への接続を許可する IP 範囲。社内専用なら社内・VPN の IP に絞る"
    +  type        = list(string)
    +  default     = ["0.0.0.0/0"]
    +}
    +
    +variable "alb_deletion_protection" {
    +  description = "ALB の削除保護(本番は true を推奨)"
    +  type        = bool
    +  default     = false
    +}
    +
    +variable "image_tag" {
    +  description = "デプロイするイメージのタグ(Git のコミット ID など。app / web で同じタグを使う)"
    +  type        = string
    +}
    +
    +variable "ecr_keep_images" {
    +  description = "ECR に残すイメージの数(切り戻しに使える世代数)"
    +  type        = number
    +  default     = 30
    +}
    +
    +variable "web_cpu" {
    +  description = "web タスクの CPU(1024 = 1 vCPU)。nginx と php-fpm の合計"
    +  type        = number
    +  default     = 512
    +}
    +
    +variable "web_memory" {
    +  description = "web タスクのメモリ(MiB)。CPU との組み合わせは Fargate の決まった範囲から選ぶ"
    +  type        = number
    +  default     = 1024
    +}
    +
    +variable "web_desired_count" {
    +  description = "web タスクの台数。2 以上にすると2つの AZ に分かれて置かれる"
    +  type        = number
    +  default     = 2
    +}
    +
    +variable "log_retention_days" {
    +  description = "CloudWatch Logs の保持日数"
    +  type        = number
    +  default     = 30
    +}
    +
    +variable "enable_container_insights" {
    +  description = "ECS の Container Insights(詳細メトリクス。追加費用あり)を有効にするか"
    +  type        = bool
    +  default     = false
    +}
    --- a/infra/terraform/outputs.tf
    +++ b/infra/terraform/outputs.tf
    @@ -49,3 +49,23 @@ output "ecs_task_execution_role_arn" {
       description = "ECS タスク実行ロールの ARN(第9回のタスク定義で使う)"
       value       = aws_iam_role.ecs_task_execution.arn
     }
    +
    +output "ecr_repository_urls" {
    +  description = "イメージの push 先(第9回)"
    +  value       = { for k, r in aws_ecr_repository.this : k => r.repository_url }
    +}
    +
    +output "alb_dns_name" {
    +  description = "ALB の DNS 名。app_domain の DNS レコード(CNAME / エイリアス)をここに向ける"
    +  value       = aws_lb.main.dns_name
    +}
    +
    +output "ecs_cluster_name" {
    +  description = "ECS クラスター名"
    +  value       = aws_ecs_cluster.main.name
    +}
    +
    +output "ecs_task_role_arn" {
    +  description = "ECS タスクロール(アプリ用)の ARN"
    +  value       = aws_iam_role.ecs_task.arn
    +}
    --- a/infra/terraform/terraform.tfvars.example
    +++ b/infra/terraform/terraform.tfvars.example
    @@ -24,3 +24,21 @@ db_deletion_protection   = true
     
     # SSM Parameter Store に「入れ物」だけを作る秘密情報の名前(値は aws ssm put-parameter で登録)
     app_secret_names = ["APP_KEY"]
    +
    +# ---------- ECR・ECS・ALB(第9回) ----------
    +# 値はすべて例。証明書の ARN は自分のアカウントで ACM に発行したものに置き換える
    +app_domain          = "admin-stg.example.com"
    +acm_certificate_arn = "arn:aws:acm:ap-northeast-1:111122223333:certificate/00000000-0000-0000-0000-000000000000"
    +# 検証環境は社内・VPN の IP だけに絞る例(203.0.113.0/24 はドキュメント用のアドレス)
    +alb_ingress_cidrs       = ["203.0.113.0/24"]
    +alb_deletion_protection = false
    +
    +# docker build / push したイメージのタグ(第11回以降は GitHub Actions がデプロイする)
    +image_tag       = "replace-with-git-sha"
    +ecr_keep_images = 30
    +
    +web_cpu                   = 512
    +web_memory                = 1024
    +web_desired_count         = 2
    +log_retention_days        = 30
    +enable_container_insights = false

    初回のデプロイ手順

    ECR が無いとイメージを push できず、イメージが無いとサービスのタスクが起動できません。初回だけは次の順に進めます(<...> は自分の環境の値。どのフォルダで実行するかはコメントに書いています。Terraform は第7回と同じく Docker で動かし、AWS の認証情報を渡します)。

    # 0. イメージのタグにコミット ID を使うため、ここまでの変更を Git にコミットしておく(プロジェクトのフォルダで実行)
    git add -A
    git commit -m "第9回まで"
    TAG=$(git rev-parse --short HEAD)
    
    # 1. ECR と、APP_KEY の入れ物(SSM パラメータ)だけを先に作る(infra/terraform で実行)
    #    terraform.tfvars の image_tag には、$TAG の値を書いておく
    cd infra/terraform
    TF="docker run --rm -it -v $PWD:/w -w /w -v $HOME/.aws:/root/.aws:ro -e AWS_PROFILE=<プロファイル名> hashicorp/terraform:1.11.4"
    $TF init -backend-config=backend.hcl
    $TF apply -target='aws_ecr_repository.this' -target='aws_ssm_parameter.app_secret'
    $TF output ecr_repository_urls
    cd ../..
    
    # 2. イメージを build して push する(プロジェクトのフォルダで実行。app と web は同じタグにする)
    aws ecr get-login-password --region ap-northeast-1 \
      | docker login --username AWS --password-stdin <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com
    docker build --target app -t <app のリポジトリ URL>:$TAG .
    docker build --target web -t <web のリポジトリ URL>:$TAG .
    docker push <app のリポジトリ URL>:$TAG
    docker push <web のリポジトリ URL>:$TAG
    
    # 3. SSM に APP_KEY の値を登録する(第8回の key:generate --show と aws ssm put-parameter)
    
    # 4. 残りをすべて作る(infra/terraform で実行)
    cd infra/terraform
    $TF plan
    $TF apply
    $TF output alb_dns_name

    APP_KEY の入れ物(SSM パラメータ)は、手順1で Terraform に作らせてから値を登録します。先に aws ssm put-parameter で作ってしまうと、手順4の apply で同じ名前のパラメータを作ろうとしてエラーになるためです。

    リポジトリの URL は手順1の output ecr_repository_urls で確認できます。最後に、app_domain の DNS レコード(CNAME やエイリアス)を 手順4の output alb_dns_name の ALB に向ければ、https://<ドメイン>/up にアクセスできるようになります。

    ただし、この時点ではまだデータベースにテーブルがありません。/up は DB を使わないので 200 を返しますが、ログイン画面はセッションを DB に保存するため表示できません。テーブルを作るマイグレーションは、次回、専用のタスクで実行します(アプリの起動時に自動で流さない理由も次回説明します)。

    動作確認の方法

    # Laravel のテスト(ローカル、Docker)
    docker compose run --rm --no-deps app php artisan test
    
    # Terraform(infra/terraform で実行)
    docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 fmt -check -recursive
    docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 init -backend=false
    docker run --rm -v $PWD:/w -w /w hashicorp/terraform:1.11.4 validate

    筆者の環境で確認したことは次のとおりです。

    • php artisan test は 66件すべて成功(今回追加した TrustedProxyTest の4件を含む)
    • terraform fmt -check・validate が成功。AWS に接続しない形での plan は Plan: 58 to add(第8回の42件に、ECR・ライフサイクルポリシー・ロググループ・クラスター・タスク定義・サービス・タスクロール・ALB・ターゲットグループ・リスナーの16件が追加)
    • 本番イメージを compose.prod.yaml で起動し、TRUSTED_PROXIES に Docker のネットワーク範囲を指定したうえで、X-Forwarded-Proto: https を付けて /dashboard にアクセスすると、リダイレクト先が https:// になり、Cookie に secure が付く。ヘッダーなしでは http:// のまま

    AWS 上での確認(ALB の DNS 名への curl -I https://<ドメイン>/up が 200、ECS コンソールでターゲットが healthy、CloudWatch Logs の /ecs/admin-stg/web に nginx のアクセスログが出ること)は、AWS アカウントがないため行っていません。ヘルスチェックの猶予時間(60秒)が十分かどうかも、実際の起動時間を見て調整が必要です。

    つまずきやすい点・セキュリティ上の注意

    • /up は DB の状態を見ない:Laravel の /up はアプリが起動していれば 200 を返し、DB に接続できなくても healthy になります。DB の異常は、第12回のアラームで検知します。
    • 第7回の構成を apply 済みの場合:ALB のセキュリティグループのルールを for_each に変えたため、plan では作り直し(削除と作成)になります。作り直しの間、ALB への通信が一瞬止まる点に注意してください。
    • イメージの CPU アーキテクチャ:タスク定義は X86_64 にしています。Apple Silicon の Mac などでビルドしたイメージは ARM64 になり、そのままでは起動できません。第11回で CI からビルドするようにして、ビルド環境をそろえます。
    • 会員登録画面が開いている:前述のとおり、IP の制限か、会員登録のルートを外す対応が必要です(第12回で本番前の残作業として整理します)。
    • ドメインと証明書:証明書の発行・更新の DNS 検証レコードを誰が管理しているか(社内か開発会社か)を確認しておかないと、更新時に止まることがあります。

    発注者向けメモ:月額の土台は「常に動く台数」で決まる

    Fargate の料金は、タスクに割り当てた CPU とメモリ × 動いている時間で決まります。つまり、画面にアクセスが無い夜間も、desired_count の台数分の費用が発生します。ALB も時間単位の料金がかかる部品です。

    決めること費用・リスクへの影響決めるための問い
    web の台数(最小2台か1台か)2台なら AZ 障害やデプロイ中も止まりにくいが、常に2台分の費用数分止まってよい検証環境か、業務時間中は止められない本番か
    タスクの CPU・メモリ大きいほど費用が増える。小さすぎると遅くなる同時に使う人数、重い画面(一覧・帳票)があるか
    公開範囲(IP 制限)社内・VPN に絞ると攻撃を受ける面が小さくなる社外から使う人(在宅・取引先)はいるか
    ログの保持期間長いほど保管費用が増える障害や不正の調査で何日前まで見返したいか

    開発会社には、次のように確認してみてください。

    • 「検証環境と本番で、タスクの台数と CPU・メモリはどう違いますか?夜間も同じ台数で動かす必要がありますか?」
    • 「管理画面に接続できる IP は制限していますか?社外から使う場合はどうしますか?」
    • 「ドメインと SSL 証明書は誰のアカウントで管理し、更新はどう行いますか?」
    • 「今動いているのがどのバージョンのコードか、どこで確認できますか?前の版に戻すにはどうしますか?」

    まとめと次回予告

    第9回では、管理画面をインターネットに公開するための部品を定義しました。

    • ECR はタグの上書きを禁止し、ライフサイクルポリシーで古いイメージを整理する
    • タスク定義は nginx と php-fpm を1つのタスクにまとめ、秘密情報は ARN で参照して起動時に注入する
    • ECS が使うタスク実行ロールと、アプリが使うタスクロールを分ける
    • サービスで2つの AZ に2台を保ち、ALB は /up で見張り、HTTP は HTTPS にリダイレクトする
    • ALB の裏で HTTPS を正しく扱うため、VPC の範囲だけを信頼するプロキシとして設定する

    次回は「キューワーカーとスケジューラを ECS で動かす」です。SQS のキューとデッドレターキュー、worker・scheduler のサービス、そして今回見送ったマイグレーションを実行する専用タスクを作ります。

    この連載の記事一覧

    この記事は連載「Laravel+Vue.jsで作る管理画面をECSで動かす」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      コメント

      コメント一覧 (1件)

      目次