bio_frontend/README-Docker.md

Docker 배포 가이드

이 프로젝트는 Docker를 사용하여 컨테이너화할 수 있습니다.

사전 요구사항

• Docker Desktop 설치
• Docker Compose 설치 (Docker Desktop에 포함됨)

빠른 시작

1. 도커 이미지 빌드 및 실행

# 프로젝트 루트 디렉토리에서
docker-compose up --build

2. 백그라운드에서 실행

docker-compose up -d --build

3. 컨테이너 중지

docker-compose down

수동 도커 명령어

이미지 빌드

docker build -t nuxt-app .

컨테이너 실행

docker run -p 3000:3000 nuxt-app

백그라운드에서 실행

docker run -d -p 3000:3000 --name nuxt-container nuxt-app

환경 변수 설정

필요한 경우 환경 변수를 설정할 수 있습니다:

docker run -p 3000:3000 \
  -e NODE_ENV=production \
  -e API_URL=https://api.example.com \
  nuxt-app

또는 .env 파일을 사용:

docker run -p 3000:3000 --env-file .env nuxt-app

프로덕션 배포

1. 이미지 태그 지정

docker build -t your-registry/nuxt-app:latest .

2. 이미지 푸시

docker push your-registry/nuxt-app:latest

3. 프로덕션 서버에서 실행

docker pull your-registry/nuxt-app:latest
docker run -d -p 3000:3000 your-registry/nuxt-app:latest

문제 해결

포트 충돌

다른 포트를 사용하려면:

docker run -p 8080:3000 nuxt-app

볼륨 마운트 (개발용)

소스 코드 변경사항을 실시간으로 반영하려면:

docker run -p 3000:3000 -v $(pwd):/app nuxt-app

로그 확인

# docker-compose 사용 시
docker-compose logs

# 수동 실행 시
docker logs <container-id>

보안 고려사항

• 프로덕션에서는 non-root 사용자로 실행됩니다
• 필요한 포트만 노출됩니다
• 민감한 정보는 환경 변수로 관리하세요

성능 최적화

• 멀티스테이지 빌드를 사용하여 이미지 크기를 최소화했습니다
• 프로덕션 의존성만 설치합니다
• 캐시를 정리하여 이미지 크기를 줄입니다