<aside>

https://github.com/boostcampwm2025/web01-BoostUs/wiki/ADR‐004:-Docker-기반-CI-CD-아키텍처-설계-결정

</aside>

1. Status (상태)

• 상태: ✅ Accepted
• 작성자: LimSR12

2. Context (배경)

BoostUs 프로젝트는 초기 개발 단계에서 docker-compose 기반 환경을 사용하고 있다.

기존 구성은 개발 편의성에는 적합했으나, 배포 환경으로 사용하기에는 다음과 같은 문제가 있었다.

• backend / frontend 컨테이너가 매 실행 시마다
  • npm install
  • pnpm install 을 수행한다.
• 컨테이너 재시작 또는 배포 시마다 의존성 설치가 반복된다.
• 배포 시간이 길어지고, 네트워크·패키지 문제로 실패 가능성이 존재한다.
• 개발 환경과 배포 환경의 경계가 명확하지 않다.

이에 따라 개발용과 배포용 환경을 명확히 분리하고,

배포 환경에서는 사전에 빌드된 Docker 이미지를 사용하는 구조가 필요했다.

3. Decision (결정)

• 개발 환경과 배포 환경을 분리한다.
  • 개발용: docker-compose.dev.yml
  • 배포용: docker-compose.prod.yml
• 배포 환경에서는 Dockerfile로 빌드된 이미지를 실행한다.
• CI 단계에서 Docker 이미지를 빌드하고 GHCR에 push한다.
• CD 단계에서 서버에서 이미지를 pull한 뒤 docker compose up으로 실행한다.
• GitHub Actions 기반 CI/CD 파이프라인을 구성한다.

4. Rationale (근거)