Skip to content

feat: 처음 받은 사람도 docker compose up 한 번으로 띄울 수 있게 - #113

Merged
RosieOh merged 1 commit into
mainfrom
feat/local-quickstart
Sep 22, 2026
Merged

RosieOh merged 1 commit into
mainfrom
feat/local-quickstart

Conversation

@RosieOh

@RosieOh RosieOh commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

Closes #112

변경

  • docker-compose.yml — 앱 + MariaDB 10.11 + Redis 7. .env 없이 로컬 기본값으로 기동. Flyway 로 스키마 생성 + Hibernate validate (운영과 동일)
  • .env.example — 선택 연동 키 (카카오·메일·공공데이터·챗봇·샘플 데이터·포트)
  • Dockerfile — 업로드 디렉터리 소유권, HEALTHCHECK start-period 180s (Docker Desktop 기동 3분 반영)
  • .dockerignore — .env 제외
  • README.md — 빠른 시작·배포·DB·구조를 실제와 맞춤

확인

README 순서대로 새 볼륨에서 실행:

단계 결과
docker compose up --build app healthy, Flyway 18건 적용 → validate 통과
가입 → 로그인 200, refreshToken HttpOnly 쿠키
GET /users/me 200
SQL 로 ADMIN 승격 후 재로그인 → /api/admin/users 200
Swagger UI, GET /facilities 200

기존 로컬 컨테이너(carecode-mariadb:3406, carecode-redis:6379)와 포트가 겹치지 않는다 (3307 / 6380).

README 의 빠른 시작이 존재하지 않는 docker-compose.yml, application-docker.yml,
-Pprofile=prod 옵션, 없는 관리자 계정(admin@carecode.com)을 안내하고 있었다.
그대로 따라 하면 첫 명령부터 실패했다.

- docker-compose.yml: 앱 + MariaDB 10.11 + Redis 7. .env 없이도 로컬 기본값으로 뜬다.
  스키마는 Flyway 로 만들고 Hibernate 는 validate 만 한다(운영과 같은 방식) —
  마이그레이션이 빠지면 로컬에서도 기동 실패로 바로 드러난다.
- .env.example: 카카오·메일·공공데이터·챗봇 등 선택 연동 키. 없어도 해당 기능만 비활성.
- Dockerfile: 업로드 디렉터리를 비루트 사용자 소유로 만든다(볼륨 마운트 시 쓰기 실패 방지).
  HEALTHCHECK start-period 30s → 180s. Docker Desktop 에서 Flyway 초기 적용 포함
  기동이 3분 넘게 걸려 준비 중에 unhealthy 로 표시됐다.
- .dockerignore: .env 가 이미지에 들어가지 않게.
- README: 빠른 시작·가입/로그인·관리자 승격·샘플 데이터·배포(GitHub Actions)·
  마이그레이션·테이블·프로젝트 구조를 실제 코드와 맞춘다. 목차 링크 수정.

로컬에서 README 순서대로 실행해 확인: 기동(healthy, Flyway V1~V18 적용 후 validate),
가입 → 로그인(리프레시 쿠키) → /users/me → SQL 로 ADMIN 승격 → /api/admin/users 200.
@RosieOh
RosieOh merged commit 39c2b47 into main Sep 22, 2026
7 checks 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.

[ 인프라 ] 로컬 실행 경로가 없어 README 대로 따라 하면 첫 명령부터 실패

1 participant