2.1 KiB
2.1 KiB
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 사용자로 실행됩니다
- 필요한 포트만 노출됩니다
- 민감한 정보는 환경 변수로 관리하세요
성능 최적화
- 멀티스테이지 빌드를 사용하여 이미지 크기를 최소화했습니다
- 프로덕션 의존성만 설치합니다
- 캐시를 정리하여 이미지 크기를 줄입니다