Docker Vibe Coding 가이드

# Node.js 앱
FROM node:20-alpine

WORKDIR /app

# 패키지 설치 (레이어 캐싱 활용)
COPY package*.json ./
RUN npm ci --only=production

# 소스 복사
COPY . .

# 포트 노출
EXPOSE 3000

# 실행
CMD ["node", "server.js"]

# 빌드 스테이지
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# 런타임 스테이지
FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
USER node
CMD ["node", "dist/server.js"]

# Go 앱 Multi-stage (최종 이미지 ~10MB)
FROM golang:1.22-alpine AS builder
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -ldflags="-s -w" -o /app/server ./cmd/server

# scratch: 완전 빈 이미지 (쉘 없음, 디버깅 불가)
FROM scratch
COPY --from=builder /app/server /server
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
EXPOSE 8080
ENTRYPOINT ["/server"]

node_modules
npm-debug.log
.git
.gitignore
README.md
Dockerfile
docker-compose.yml
.env
*.md
tests/
coverage/
.vscode/
.idea/
dist/
*.log

# 잘못된 순서: 소스 변경마다 npm ci 재실행
COPY . .
RUN npm ci          # 매번 재실행됨

# 올바른 순서: 의존성 파일만 먼저 복사
COPY package*.json ./
RUN npm ci          # package.json 변경 시에만 재실행
COPY . .             # 소스 변경은 이 레이어만 영향

# 비효율: 3개 레이어, 캐시 파일 잔존
RUN apt-get update
RUN apt-get install -y curl
RUN rm -rf /var/lib/apt/lists/*

# 효율: 1개 레이어, 캐시 파일 제거됨
RUN apt-get update && \
    apt-get install -y --no-install-recommends curl && \
    rm -rf /var/lib/apt/lists/*

# 이미지 빌드
docker build -t myapp:latest .

# 컨테이너 실행
docker run -d -p 3000:3000 --name myapp myapp:latest

# 실행 중인 컨테이너 확인
docker ps

# 로그 확인
docker logs myapp

# 컨테이너 중지/삭제
docker stop myapp
docker rm myapp

# 이미지 목록
docker images

# 사용하지 않는 리소스 정리
docker system prune -a --volumes

# Named Volume 생성
docker volume create mydata

# Named Volume으로 컨테이너 실행
docker run -d -v mydata:/data --name mydb postgres:15-alpine

# Bind Mount로 개발 환경 구성
docker run -d \
  -v $(pwd)/src:/app/src:ro \
  -v $(pwd)/config:/app/config:ro \
  -v nodemodules:/app/node_modules \
  -p 3000:3000 myapp:dev

# 볼륨 목록 확인
docker volume ls

# 볼륨 상세 정보
docker volume inspect mydata

# 사용하지 않는 볼륨 정리
docker volume prune

# 사용자 정의 네트워크 생성
docker network create --driver bridge myapp-network

# 네트워크에 컨테이너 연결
docker run -d --name api --network myapp-network myapi:latest
docker run -d --name db --network myapp-network postgres:15-alpine

# 컨테이너 간 통신 (DNS 자동 해석)
# api 컨테이너에서 "db" 호스트명으로 접속 가능
docker exec api ping db

# 네트워크 목록
docker network ls

# 네트워크 상세 정보
docker network inspect myapp-network

services:
  app:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
    environment:
      - DATABASE_URL=postgresql://db:5432/mydb

  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=dev
      - POSTGRES_PASSWORD=dev
      - POSTGRES_DB=mydb
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

# 서비스 시작
docker-compose up -d

# 서비스 중지
docker-compose down

# 볼륨까지 함께 삭제
docker-compose down -v

# 로그 확인
docker-compose logs -f

# 특정 서비스만 실행
docker-compose up db

# 서비스 재빌드
docker-compose up --build -d

services:
  app:
    image: node:20
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  db:
    image: postgres:15
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d mydb"]
      interval: 10s
      timeout: 5s
      retries: 5

services:
  app:
    build: .
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

  db:
    image: postgres:15-alpine
    healthcheck:
      test: ["CMD-SHELL", "pg_isready"]
      interval: 5s
      timeout: 3s
      retries: 10

  redis:
    image: redis:7-alpine

services:
  app:
    build: .
    ports:
      - "3000:3000"

  db:
    image: postgres:15-alpine

  adminer:
    image: adminer
    ports:
      - "8080:8080"
    profiles:
      - debug

  prometheus:
    image: prom/prometheus
    profiles:
      - monitoring

  grafana:
    image: grafana/grafana
    profiles:
      - monitoring

# 기본 서비스만 실행 (app, db)
docker-compose up -d

# debug 프로파일 포함 실행
docker-compose --profile debug up -d

# 모니터링 포함 실행
docker-compose --profile monitoring up -d

services:
  db:
    image: postgres:15-alpine
    secrets:
      - db_password
    environment:
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password

  app:
    build: .
    secrets:
      - db_password
      - api_key

secrets:
  db_password:
    file: ./secrets/db_password.txt
  api_key:
    file: ./secrets/api_key.txt

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/mydb
      - REDIS_URL=redis://redis:6379
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    restart: always

  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

  redis:
    image: redis:7-alpine
    restart: always

volumes:
  pgdata:

FROM node:20-alpine

# 전용 사용자 생성
RUN addgroup -S appgroup && adduser -S appuser -G appgroup

WORKDIR /app
COPY --chown=appuser:appgroup package*.json ./
RUN npm ci --only=production
COPY --chown=appuser:appgroup . .

# 비root 사용자로 전환
USER appuser

EXPOSE 3000
CMD ["node", "server.js"]

# 읽기 전용 파일 시스템 + tmpfs로 필요한 쓰기 영역만 허용
docker run -d \
  --read-only \
  --tmpfs /tmp:rw,size=64m \
  --tmpfs /var/run:rw \
  -p 3000:3000 \
  myapp:latest

services:
  app:
    image: myapp:latest
    deploy:
      resources:
        limits:
          cpus: '0.5'      # CPU 50% 제한
          memory: 512M     # 메모리 512MB 제한
        reservations:
          cpus: '0.25'     # 최소 CPU 보장
          memory: 256M     # 최소 메모리 보장

# Docker Scout (Docker Desktop 내장)
docker scout cves myapp:latest

# Trivy (오픈소스 스캐너)
trivy image myapp:latest

# Snyk
snyk container test myapp:latest

# CI/CD에서 취약점 발견 시 빌드 실패
trivy image --exit-code 1 --severity HIGH,CRITICAL myapp:latest

# 실시간 로그 스트리밍
docker logs -f myapp

# 최근 100줄만 확인
docker logs --tail 100 myapp

# 타임스탬프 포함
docker logs -t myapp

# 특정 시간 이후 로그
docker logs --since 2h myapp

# Compose에서 특정 서비스 로그
docker-compose logs -f app

# 실행 중인 컨테이너에 쉘 접속
docker exec -it myapp /bin/sh

# 특정 명령어 실행
docker exec myapp cat /app/config.json

# 환경 변수 확인
docker exec myapp env

# 네트워크 상태 확인
docker exec myapp netstat -tlnp

# 컨테이너 상세 정보 (JSON)
docker inspect myapp

# IP 주소만 추출
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' myapp

# 마운트된 볼륨 확인
docker inspect -f '{{json .Mounts}}' myapp | python3 -m json.tool

# 실시간 리소스 사용량 모니터링
docker stats

# 특정 컨테이너 리소스 확인
docker stats myapp --no-stream

# 컨테이너 프로세스 확인
docker top myapp

# 파일 시스템 변경 사항 확인
docker diff myapp

services:
  app:
    image: myapp:latest
    logging:
      driver: "json-file"
      options:
        max-size: "10m"     # 로그 파일 최대 크기
        max-file: "3"       # 로그 파일 최대 개수
        compress: "true"    # 로테이션된 로그 압축

services:
  app:
    image: myapp:1.2.3       # 명시적 태그 (latest 금지)
    ports:
      - "3000:3000"
    restart: unless-stopped
    read_only: true
    tmpfs:
      - /tmp:rw,size=64m
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 512M
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:15-alpine
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app"]
      interval: 10s
      timeout: 5s
      retries: 5
    deploy:
      resources:
        limits:
          memory: 1G
    secrets:
      - db_password
    environment:
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password

volumes:
  pgdata:

secrets:
  db_password:
    file: ./secrets/db_password.txt

# Docker와 Podman 명령어 비교 (거의 동일)
docker run -d -p 8080:80 nginx     # Docker
podman run -d -p 8080:80 nginx     # Podman

# alias 설정으로 전환
alias docker=podman