Skip to content

T-04 로컬 실행 환경 검증 - #75

Merged
ff1451 merged 1 commit into
mainfrom
feat/t04-local-env
Aug 21, 2026
Merged

T-04 로컬 실행 환경 검증#75
ff1451 merged 1 commit into
mainfrom
feat/t04-local-env

Conversation

@ff1451

@ff1451 ff1451 commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Refs #16

원래 PR #57(base: feat/t01-common-foundation)이 #56 squash-merge 후 base 브랜치 삭제로 재오픈이 불가능해 새로 열었다. 커밋 내용은 원래 PR과 동일, main 위로 rebase만 했다.

Summary by CodeRabbit

  • New Features

    • Added Docker Compose configuration for running PostgreSQL 16 locally with persistent storage, configurable ports, credentials, restart behavior, and health checks.
  • Documentation

    • Added setup, local development, testing, troubleshooting, health-check, and deployment instructions for the backend service.

부팅 → 마이그레이션 → /health 200을 로컬에서 재현하고, 그 과정에서 겪은 문제를
README에 남긴다.

- docker-compose.yml — 로컬 Postgres 16. 호스트 포트는 COMPOSE_POSTGRES_PORT로
  오버라이드 가능(기본 5432)
- README.md — 실행 절차, 테스트 실행, 흔히 겪는 문제

application-local.yml은 추가하지 않았다. .env + springboot4-dotenv(developmentOnly)가
이미 이 역할을 하고 있고(.env.example에 필요한 오버라이드가 전부 문서화되어 있다),
Spring profile을 추가로 얹으면 로컬 설정 경로가 두 개가 된다.

로컬에서 실제로 부딪힌 문제: 이 Mac에 홈브루 postgresql@18 서비스가 이미 5432를
점유하고 있어 Flyway가 엉뚱한 Postgres(역할 "postgres" 없음)에 연결해 실패했다.
COMPOSE_POSTGRES_PORT 오버라이드로 재현 확인 — README에 원인과 해결을 남겼다.

검증: docker compose up -d → .env 생성(JWT_SECRET 발급) → ./gradlew bootRun →
Flyway 6개 마이그레이션 적용 → curl /health → 200 OK. ./gradlew test 전체 통과.

Refs #16
@ff1451
ff1451 merged commit 538e7e4 into main Aug 21, 2026
1 check was pending
@ff1451
ff1451 deleted the feat/t04-local-env branch August 21, 2026 12:44
@coderabbitai

coderabbitai Bot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9d0cdc56-d4a2-43e6-9ff0-e775c9db9e67

📥 Commits

Reviewing files that changed from the base of the PR and between 2157a77 and d3c7159.

📒 Files selected for processing (2)
  • README.md
  • docker-compose.yml

📝 Walkthrough

Walkthrough

Adds a PostgreSQL 16 Docker Compose service and a README for local setup, testing, troubleshooting, health checks, migrations, and deployment operations.

Changes

Environment and operational documentation

Layer / File(s) Summary
Local database and development setup
docker-compose.yml, README.md
Adds configurable PostgreSQL hosting with persistent storage and readiness checks. Documents environment setup, application startup, health verification, migrations, tests, and troubleshooting.
Deployment operations
README.md
Documents the GitHub Actions image build, server restart process, downtime, and memory checks.

Estimated code review effort: 2 (Simple) | ~10 minutes

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/t04-local-env

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ff1451 ff1451 self-assigned this Aug 21, 2026
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