Skip to content

[codex] Add reproducible local backend startup - #2

Draft
SH-ZMD wants to merge 3 commits into
masterfrom
codex/publish-backend-fixes
Draft

[codex] Add reproducible local backend startup#2
SH-ZMD wants to merge 3 commits into
masterfrom
codex/publish-backend-fixes

Conversation

@SH-ZMD

@SH-ZMD SH-ZMD commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

What changed

  • add a multi-stage JDK 25 Docker image and Docker Compose development stack
  • provision PostgreSQL and Redis with health-based startup ordering and persistent development volumes
  • use a verified regional Gradle mirror first with official repositories retained as fallback
  • add Gradle cache and bounded retries for transient dependency-download failures
  • disable the nonessential mail health indicator only in the local Docker environment
  • document Docker-first startup and retain the existing manual setup path

Why

A fresh clone could not start without manually installing JDK 25, PostgreSQL, Redis, and a complete .env. Container builds could also fail on Gradle Plugin Portal TLS interruptions, while an unconfigured SMTP server made an otherwise healthy local stack report 503.

Validation

  • docker compose config: passed
  • clean Docker bootJar build with JDK 25: passed
  • PostgreSQL and Redis health checks: passed
  • backend Actuator health: overall UP with database and Redis UP
  • frontend-to-backend CORS request: passed with HTTP 200
  • real browser smoke test against the Docker backend: passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant