• https://www.docker.com/

Next.js 프로젝트를 Docker 컨테이너로 실행하여 로컬 개발 환경을 구축하려고 합니다.

이 글에서는 docker-compose.yml 파일을 설정하고, 컨테이너를 실행하는 방법을 정리합니다.

docker-compose.yml 작성

프로젝트 루트에 docker-compose.yml 파일을 생성한 후, 아래와 같이 설정합니다.

services:
  next-js:
    build:
      dockerfile: docker/next/Dockerfile
      context: .
    volumes:
      - '.:/var/www'
      - '/var/www/node_modules'
    ports:
      - '${APP_PORT:-3000}:3000'
    networks:
      - next-js-kit

networks:
  next-js-kit:
    driver: bridge

• Next.js 서비스(next-js)
  • docker/next/Dockerfile을 기반으로 컨테이너를 빌드합니다.
  • 소스 코드가 컨테이너 내부 /var/www 경로와 동기화됩니다.
  • 포트 3000을 호스트와 컨테이너에서 동일하게 설정합니다.
• 네트워크 설정(next-js-kit)
  • 모든 컨테이너는 next-js-kit 네트워크를 통해 서로 통신할 수 있습니다.

Dockerfile

FROM node:20-alpine

LABEL maintainer="Name <[email protected]>"
LABEL version="0.1"
LABEL description="next js 14 image for app"
LABEL build_date="2023-10-01"

WORKDIR /var/www
COPY . .
RUN npm install

CMD ["npm", "run", "dev"]

Docker 설치 및 실행

Docker를 설치하지 않았다면, 먼저 Docker 공식 사이트에서 Docker Desktop을 다운로드하고 설치하세요.

Docker 컨테이너 실행