infra(terraform): Phase 1 Sprint 1 — ECS Cluster(Fargate)(S1Infra-2)

[win2cot]

Phase 1 Sprint 1 Infra-2: (tasks) ECS Cluster(Fargate)

概要

dev 環境向け ECS Cluster(Fargate)を Terraform で構築。tasks-webapi + Keycloak Custom Image の 2 Service が乗る前提のクラスタ。tasks stack 所有(ADR-0004)。

詳細仕様: infra/docs/adr/0004-platform-project-infra-separation.md / docs/architecture/infrastructure-plan.md §6.3。

stack / 配置(ADR-0004)

• tasks stack: root infra/environments/dev/(key tasks/dev/terraform.tfstate)、module infra/modules/ecs_cluster/
• 命名 tasks-dev-* / タグ Project=tasks
• ECS Cluster 自体は VPC 非依存(Service が private subnet を SSM 参照、ADR-0004 §4: ECS は専用)

背景

• Fargate 採用(EC2 不採用)
• Cluster は 1 つ、Service は tasks-webapi / keycloak-custom の 2 つ(S2Infra-2 / infra(terraform): Phase 1 Sprint 1 — Keycloak (Custom) ECS Service + Listener Rule(S1Infra-5) #322)
• ECS Service は private subnet 配置、共有 ALB(infra(terraform): Phase 1 Sprint 0 — (platform) alb: ALB+Listener+SG-ALB+base cert+SSM publish(S0Infra-6) #242)経由でアクセス

やること

• module infra/modules/ecs_cluster/ 作成(Cluster + capacity provider FARGATE / FARGATE_SPOT)
• infra/environments/dev/ で呼び出し
• CloudWatch Logs Log Group(/ecs/tasks-dev/webapi / /ecs/tasks-dev/keycloak)雛形(本格運用は S3Infra-3)
• terraform plan(tasks)確認 + dev apply(tasks-apply role infra(ci-cd): Phase 1 Sprint 0 — (platform/tasks) OIDC + plan/apply×platform/tasks = 4 IAM Role(Environment 分離)(S0Infra-3) #246)

受入条件

• dev ECS Cluster が確認可能
• FARGATE capacity provider 設定済
• CloudWatch Log Group 存在
• terraform apply 成功

関連

• 親 tracker Issue: [Phase 1 Infra] Setup 0-2 + Sprint 0-5 Infra ストリーム横断 tracker #206
• ADR: ADR-0004
• Milestone: Phase 1 / Iteration: Phase 1 Sprint 1
• 依存: S0Infra-1(infra(terraform): Phase 1 Sprint 0 — Terraform プロジェクト構造 ADR(S0Infra-1) #238)/ S0Infra-3(infra(ci-cd): Phase 1 Sprint 0 — (platform/tasks) OIDC + plan/apply×platform/tasks = 4 IAM Role(Environment 分離)(S0Infra-3) #246、tasks-apply role)
• 隣接: S1Infra-5(infra(terraform): Phase 1 Sprint 1 — Keycloak (Custom) ECS Service + Listener Rule(S1Infra-5) #322 Keycloak Service)/ S2Infra-2(tasks-webapi Service)

備考

• task-type: task-type:impl / 優先度: priority/p0 / area: area/infra
• claude-automation: 適用

[claude-automation-impl]

着手宣言

Issue #319(ECS Cluster Fargate)の実装を開始します。

実装方針

作成ファイル

1. module infra/modules/ecs_cluster/ (新規 4 ファイル)

   • versions.tf — Terraform / AWS provider バージョン制約(既存モジュールと同一)
   • variables.tf — env 変数のみ(ECS Cluster は VPC 非依存)
   • main.tf — ECS Cluster + capacity providers(FARGATE / FARGATE_SPOT) + CloudWatch Log Groups 2 本
   • outputs.tf — cluster_name / cluster_arn

2. infra/environments/dev/ecs_cluster.tf (新規) — module 呼び出し

命名・設計

• Cluster: tasks-<env>-cluster
• Capacity providers: FARGATE + FARGATE_SPOT(ADR-0004 §1 仕分け「ECS は専用」)
• Log Groups: /ecs/tasks-<env>/webapi / /ecs/tasks-<env>/keycloak
• Log retention: 7 日(dev 雛形、S3Infra-3 で本格運用へ)
• Container Insights: 有効化(設定は後続 Issue でオーバーライド可)
• ECS Cluster は VPC 非依存のため SSM 参照なし

検証

terraform validate でチェック後 PR を上げます(apply は tasks-apply role #246 が必要なため CI/CD 経由で確認)。

[claude-automation-impl]

対応完了レポート

PR #442 を作成しました。

実装サマリ

ファイル	内容
infra/modules/ecs_cluster/main.tf	ECS Cluster(tasks-dev-cluster)+ FARGATE/FARGATE_SPOT capacity providers + CloudWatch Log Groups(/ecs/tasks-dev/webapi, /ecs/tasks-dev/keycloak)
infra/modules/ecs_cluster/variables.tf	env 変数
infra/modules/ecs_cluster/outputs.tf	cluster_name / cluster_arn / Log Group 名
infra/modules/ecs_cluster/versions.tf	Terraform >= 1.11 / AWS ~> 5.0
infra/environments/dev/ecs_cluster.tf	tasks/dev で module 呼び出し

検証状況

• infra/** に対応するローカル検証コマンドは CLAUDE.md 自己検証ゲートに規定なし
• CI の terraform-lint ワークフロー(terraform fmt -check -recursive infra/ + terraform validate)で検証予定
• terraform apply は tasks-apply role(infra(ci-cd): Phase 1 Sprint 0 — (platform/tasks) OIDC + plan/apply×platform/tasks = 4 IAM Role(Environment 分離)(S0Infra-3) #246)が必要なため CI/CD 経由で実施

_{signal: claude-impl-done}