[Docker] 손쉽게 NodeJS 프로젝트 구성 (with docker-compose)

Node.js 프로젝트 Docker 구성 및 폴더 구조

이 글에서는 Node.js 기반 예시용 Discord 봇 프로젝트를 Docker Compose와 Dockerfile을 사용해 구성하는 방법을 설명하도록 하겠다.
MariaDB를 데이터베이스로 사용하며, 소스코드와 Node.js 모듈을 효율적으로 관리할 수 있는 구성을 보여준다.

---

Node.js 프로젝트 구조

my-project/
├── src/                   # TypeScript 소스코드
│   ├── repository/          
│   ├── modules/            
│   └── index.ts           # 엔트리 포인트
├── db/                    # MariaDB 데이터 및 초기 쿼리
│   ├── .mariadb/          # DB 실제 데이터 저장
│   └── mariadb_init/      # 초기 SQL 스크립트
├── .env                   # 환경 변수
├── package.json            # Node.js 의존성 관리
├── tsconfig.json           # TypeScript 설정
├── Dockerfile             # Node.js 컨테이너 구성
└── docker-compose.yml     # 서비스 정의

 

---

Docker Compose 구성

version: "3.9"

services:
  myproject_server:
    build: 
      context: .
      dockerfile: ./Dockerfile #프로젝트를 컨테이너에 구성하기 위해 Dockerfile 실행
    restart: always
    depends_on:
      - myproject_db #DB먼저 될때까지 대기
    volumes:
      - ./src:/app/src #소스 실시간 동기화
      - /app/node_modules #모듈 파일 유지

  myproject_db:
    image: mariadb:11.4
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mydb
      MYSQL_USER: me
      MYSQL_PASSWORD: mypw
    ports:
      - "10001:3306"
    volumes:
      - ./db/.mariadb:/var/lib/mysql
      - ./db/mariadb_init:/docker-entrypoint-initdb.d #초기 실행 쿼리문 복사

networks:
  #현재 컴포즈 내에서 공유할 네트워크
  default:
    name: my_net
    driver: bridge

 

설명:

1. myproject_server

• build: 현재 디렉터리와 Dockerfile을 기반으로 컨테이너 빌드
• restart: always: 컨테이너가 중지되면 자동 재시작
• depends_on: DB 컨테이너가 준비될 때까지 대기
• volumes
  • ./src:/app/src: 호스트의 소스를 컨테이너와 실시간 동기화
  • /app/node_modules: 컨테이너 내부 모듈 유지

2. myproject_db

• image: MariaDB 11.4 사용
• environment: DB 계정 및 비밀번호 설정
• ports: 호스트 10001 → 컨테이너 3306
• volumes
  • ./db/.mariadb: DB 데이터 영구 저장
  • ./db/mariadb_init: 초기 SQL 스크립트 자동 실행

3. 네트워크

• my_net 브리지 네트워크를 통해 컨테이너끼리 통신

---

Dockerfile 구성

FROM node:20

WORKDIR /app

# package.json 복사 후 의존성 설치
COPY ./package*.json ./
RUN npm install

# 환경파일 및 TypeScript 설정 복사
COPY ./.env ./
COPY ./tsconfig.json ./

# TypeScript 글로벌 설치
RUN npm install -g typescript ts-node

CMD ["npm", "start"]

 

설명:

1. WORKDIR /app : 컨테이너 내부 작업 디렉토리
2. package.json / package-lock.json 복사 → npm install로 의존성 설치
3. 환경 변수, TypeScript 설정 복사 → 컨테이너 빌드 시 필요한 설정 적용
4. TypeScript 글로벌 설치 → ts-node로 TypeScript 실행 가능
5. CMD ["npm", "start"] → 컨테이너 시작 시 프로젝트 실행

---

사용 방법

1. 프로젝트 디렉터리 준비
2. docker-compose up -d 실행

• logs -f 명령으로 실행 로그 확인 가능

 

이 구성을 통해 호스트에서 소스를 바로 수정하면서 컨테이너에서 실행되는 Node.js 봇을 실시간으로 테스트할 수 있고, MariaDB 데이터도 영구 저장할 수 있다.