도커

# === Dockerfile 베스트 프랙티스 ===

# 1. 멀티스테이지 빌드 (이미지 경량화)
# ===== Stage 1: 빌드 =====
FROM node:20-alpine AS builder
WORKDIR /app

# 의존성 파일만 먼저 복사 (캐시 최적화)
COPY package*.json ./
RUN npm ci

# 소스 코드 복사 & 빌드
COPY tsconfig.json ./
COPY src/ ./src/
RUN npm run build

# 프로덕션 의존성만 재설치
RUN npm ci --only=production && npm cache clean --force

# ===== Stage 2: 런타임 =====
FROM node:20-alpine AS runner

# 보안: 비루트 사용자 설정
RUN addgroup -g 1001 -S nodejs \
    && adduser -S nodejs -u 1001

WORKDIR /app

# 빌드 결과물만 복사 (소스코드, devDeps 제외)
COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
COPY --from=builder --chown=nodejs:nodejs /app/node_modules ./node_modules
COPY --from=builder --chown=nodejs:nodejs /app/package.json ./

# 비루트 사용자로 전환
USER nodejs

# 환경 변수 설정
ENV NODE_ENV=production
ENV PORT=3000

# 포트 노출 (문서화 목적)
EXPOSE 3000

# 헬스체크
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \
    CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1

# 실행 명령
CMD ["node", "dist/server.js"]

# === 결과 ===
# 빌드 스테이지: ~1GB (node_modules, TypeScript, 소스코드)
# 런타임 스테이지: ~150MB (Alpine + dist + production deps만)

# === docker-compose.yml (로컬 개발 환경) ===
version: "3.9"

services:
  # Node.js 애플리케이션
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    container_name: myapp
    ports:
      - "3000:3000"
      - "9229:9229"  # 디버깅 포트
    environment:
      - NODE_ENV=development
      - DATABASE_URL=postgres://user:password@db:5432/myapp
      - REDIS_URL=redis://redis:6379
    volumes:
      - .:/app                    # 소스코드 바인드 마운트 (핫 리로드)
      - /app/node_modules         # node_modules는 컨테이너 것 사용
    depends_on:
      db:
        condition: service_healthy
    networks:
      - app-network
    command: npm run dev          # 개발 서버 실행

  # PostgreSQL 데이터베이스
  db:
    image: postgres:16-alpine
    container_name: myapp-db
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: myapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
      interval: 5s
      timeout: 5s
      retries: 5
    networks:
      - app-network

  # Redis 캐시
  redis:
    image: redis:7-alpine
    container_name: myapp-redis
    command: redis-server --appendonly yes
    volumes:
      - redis_data:/data
    networks:
      - app-network

# Named Volumes (데이터 영속화)
volumes:
  postgres_data:
  redis_data:

# 네트워크
networks:
  app-network:
    driver: bridge

# === 명령어 ===
# docker compose up -d          # 백그라운드 실행
# docker compose up --build     # 이미지 재빌드 후 실행
# docker compose logs -f app    # app 서비스 로그 확인
# docker compose exec app sh    # app 컨테이너 접속
# docker compose down           # 정지 및 삭제
# docker compose down -v        # 볼륨까지 삭제