infra(keycloak): Phase 1 Sprint 1 — Keycloak Custom Docker Image(公式 + SPI JAR)(S1Infra-4)

[win2cot]

Phase 1 Sprint 1 Infra-4: Keycloak Custom Docker Image(公式 + 自作 SPI JAR、共有 platform ビルド)

概要

公式 Keycloak Image をベースに、#320 でビルドした SPI JAR を同梱した 共有 platform Custom Image を作成し ECR に push できる体制を整える。Image は platform の Keycloak runtime(#322) で起動される共有ビルド(全プロジェクト SPI 同梱、当面 tasks のみ)。

詳細仕様: docs/adr/0006(改訂)/ infrastructure-plan §5.3。

背景

• 公式 Keycloak Image に SPI を載せるには JAR を providers/ 配下に配置 + kc.sh build
• プロジェクト追加時は共有 Image を再ビルド(受容済みのリリース結合、ADR-0004 改訂)
• ECR push は infra(terraform): Phase 1 Sprint 1 — ECR(tasks-webapi + keycloak-custom)(S1Infra-7) #324(ECR)後。Keycloak 内部 DB は platform Keycloak DB(infra(terraform): Phase 1 Sprint 1 — Keycloak (Custom) ECS Service + Listener Rule(S1Infra-5) #322 が接続)
• リスク: SPI 実装難航時は公式 Image に fallback(infrastructure-plan §10)

やること

• keycloak/Dockerfile(Multi-stage: kc.sh build で provider 取り込み)
• 認証情報(Keycloak DB / admin)は env vars + Parameter Store 経由(image に焼き込まない)
• local Docker Compose(infra(compose): MySQL 8.4 + Keycloak Docker Compose スタック雛形 #213/infra(compose): Keycloak Realm 設計 + JSON export 配置(keycloak/realm-export/) #214)との互換性確認
• dev 用 image tag 規約: v0.1.0-dev 等
• テスト: image build 成功 + local 起動で SPI load + realm import 動作確認

受入条件

• keycloak/Dockerfile で image build 成功
• local 起動で SPI が load(User Federation で確認可)
• env vars 注入で Keycloak DB / admin 接続可能
• (ECR push は infra(terraform): Phase 1 Sprint 1 — ECR(tasks-webapi + keycloak-custom)(S1Infra-7) #324 + S2Infra-5 CI/CD)

関連

• 親 tracker Issue: [Phase 1 Infra] Setup 0-2 + Sprint 0-5 Infra ストリーム横断 tracker #206 / ADR: ADR-0006(改訂)/ ADR-0004(改訂)
• Milestone: Phase 1 / Iteration: Phase 1 Sprint 1
• 依存: infra(keycloak): Phase 1 Sprint 1 — keycloak 独立 Gradle project 雛形(SPI 用)(S1Infra-3) #320(Gradle project)完了後
• 隣接(blocks): infra(terraform): Phase 1 Sprint 1 — Keycloak (Custom) ECS Service + Listener Rule(S1Infra-5) #322(platform Keycloak Service)/ 関連: infra(terraform): Phase 1 Sprint 1 — ECR(tasks-webapi + keycloak-custom)(S1Infra-7) #324(ECR)/ S2Infra-5(deploy CI/CD)

備考

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