📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드 - NestJS 마이크로서비스를 Docker로 컨테이너화하기

📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드

2. NestJS 마이크로서비스를 Docker로 컨테이너화하기

---

NestJS로 마이크로서비스 아키텍처를 구현했다면, 이제는 각 서비스를 Docker 컨테이너로 패키징하여 운영 환경에 쉽게 배포할 수 있도록 준비해야 합니다.
이번 글에서는 NestJS 마이크로서비스를 Docker로 컨테이너화하는 실전 방법, docker-compose로 로컬에서 다중 서비스 실행까지 진행합니다. 🚀

---

✅ 왜 NestJS 마이크로서비스를 Docker로 컨테이너화해야 할까?

• 환경 일관성 확보: OS에 상관없이 동일한 실행 환경 제공
• 배포 자동화 용이: CI/CD 파이프라인 구축에 필수
• 확장성 극대화: Kubernetes와 같은 플랫폼에서 확장 가능
• 마이크로서비스 독립 실행: 서비스 단위로 컨테이너 분리 실행 가능

---

✅ 기본 디렉토리 구조 복습

nestjs-microservices/
├── apps/
│   ├── api-gateway/     # API Gateway
│   ├── user-service/    # 사용자 서비스
├── docker/
│   ├── Dockerfile.api-gateway
│   ├── Dockerfile.user-service
├── docker-compose.yml

---

✅ Dockerfile 작성 – API Gateway

📂 docker/Dockerfile.api-gateway

FROM node:18-alpine

WORKDIR /app
COPY package*.json ./
RUN npm install

COPY . .

WORKDIR /app/apps/api-gateway
RUN npm run build

CMD ["node", "dist/main"]

---

✅ Dockerfile 작성 – User Service

반응형

📂 docker/Dockerfile.user-service

FROM node:18-alpine

WORKDIR /app
COPY package*.json ./
RUN npm install

COPY . .

WORKDIR /app/apps/user-service
RUN npm run build

CMD ["node", "dist/main"]

---

✅ docker-compose.yml 작성

📂 docker-compose.yml

version: '3.8'
services:
  api-gateway:
    build:
      context: .
      dockerfile: docker/Dockerfile.api-gateway
    ports:
      - '3000:3000'
    depends_on:
      - user-service

  user-service:
    build:
      context: .
      dockerfile: docker/Dockerfile.user-service
    ports:
      - '3001:3001'

---

✅ 실행해보기

docker-compose up --build

📌 이후 http://localhost:3000/users로 API 호출 시, 내부에서 TCP 통신을 통해 user-service에 연결됩니다.

---

✅ .dockerignore 추가

📂 .dockerignore

node_modules
dist
.git
.env

💡 빌드 속도 향상과 보안 강화를 위해 불필요한 파일은 제외합니다.

---

✅ 로컬 개발 시 유용한 옵션들

• volumes를 활용한 실시간 코드 반영 (Hot Reload와 함께 사용)
• environment로 환경 변수 주입
• network_mode: bridge로 서비스 간 연결 명확히 구성 가능

---

✅ 서비스 간 통신 확인

API Gateway → User Service로 TCP 요청을 보내는 구조를 다음처럼 테스트합니다:

curl http://localhost:3000/users

응답:

[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" }
]

🎉 성공적으로 Docker 기반으로 NestJS 마이크로서비스를 컨테이너화했습니다!

---

✅ 결론: Docker로 NestJS 마이크로서비스를 효율적으로 패키징하기

✅ NestJS의 각 서비스를 독립된 Docker 이미지로 분리
✅ docker-compose를 통해 전체 시스템을 하나의 명령어로 실행
✅ Kubernetes 배포를 위한 준비 단계 완료

다음 글에서는 이 Docker 기반 마이크로서비스를 Kubernetes 클러스터에 배포하는 방법을 배워봅니다.

---

🔍 다음 글 예고: NestJS 마이크로서비스 Kubernetes 클러스터 배포 실습

📌 다음 편: 3. NestJS 마이크로서비스를 Kubernetes에 배포하기

---