Container

# === 멀티스테이지 빌드 (빌드 도구 제외로 이미지 경량화) ===

# ========== Stage 1: 빌드 ==========
FROM node:20-alpine AS builder

WORKDIR /app

# 의존성 설치 (devDependencies 포함)
COPY package*.json ./
RUN npm ci

# TypeScript 빌드
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

# 빌드 결과물과 프로덕션 의존성만 복사
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

EXPOSE 3000

CMD ["node", "dist/server.js"]

# 결과: 빌드 스테이지의 TypeScript, 소스코드, devDependencies 제외
# 이미지 크기: 약 1GB → 약 150MB로 감소

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

services:
  # 애플리케이션
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development
      - DATABASE_URL=postgres://user:pass@db:5432/myapp
      - REDIS_URL=redis://redis:6379
    volumes:
      - .:/app                    # 소스 코드 바인드 마운트
      - /app/node_modules         # node_modules는 컨테이너 것 사용
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    networks:
      - app-network

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

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

  # Nginx 리버스 프록시
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - app
    networks:
      - app-network

volumes:
  postgres_data:
  redis_data:

networks:
  app-network:
    driver: bridge

# === Docker 기본 명령어 ===

# 이미지 빌드
docker build -t myapp:v1.0 .
docker build -f Dockerfile.prod -t myapp:prod .

# 컨테이너 실행
docker run -d --name myapp -p 3000:3000 myapp:v1.0
docker run -it --rm myapp:v1.0 /bin/sh    # 대화형 쉘

# 컨테이너 관리
docker ps                                  # 실행 중인 컨테이너
docker ps -a                               # 모든 컨테이너
docker logs -f myapp                       # 로그 실시간 확인
docker exec -it myapp /bin/sh              # 실행 중 컨테이너 접속
docker stop myapp && docker rm myapp       # 정지 및 삭제

# 이미지 관리
docker images                              # 이미지 목록
docker rmi myapp:v1.0                      # 이미지 삭제
docker image prune -a                      # 미사용 이미지 정리

# === Docker Compose 명령어 ===

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

# === 이미지 레지스트리 ===

docker login                               # Docker Hub 로그인
docker tag myapp:v1.0 username/myapp:v1.0  # 태깅
docker push username/myapp:v1.0            # 푸시
docker pull username/myapp:v1.0            # 풀

# === 보안 스캔 ===

docker scout cves myapp:v1.0               # Docker Scout 취약점 스캔
trivy image myapp:v1.0                     # Trivy로 스캔