Docker 배포 실수 5가지

실수 1: .env 파일을 이미지에 포함

# [나쁜 예] .dockerignore에 .env 미포함
# -> docker build 시 .env가 이미지에 포함됨
# -> 이미지를 공유하면 API 키 유출!

# [좋은 예] .dockerignore에 반드시 추가
.env
.env.local
.env.production

실수 2: localhost로 서비스 간 통신

# [나쁜 예] 컨테이너 내부에서
NEO4J_URI = "bolt://localhost:7687"
# -> 컨테이너 자신의 localhost를 가리킴!

# [좋은 예] Docker Compose 서비스 이름 사용
NEO4J_URI = "bolt://neo4j:7687"
# -> Docker 내부 네트워크의 neo4j 서비스

실수 3: Volume 미설정으로 데이터 손실

# [나쁜 예] Volume 없이 실행
services:
  neo4j:
    image: neo4j:5-community
    # Volume 없음!
    # -> docker compose down 하면 데이터 전부 삭제

# [좋은 예]
services:
  neo4j:
    image: neo4j:5-community
    volumes:
      - neo4j_data:/data     # 데이터 영속화!

실수 4: 큰 이미지 크기

# [나쁜 예] 풀 이미지 사용
FROM python:3.11          # ~1GB

# [좋은 예] slim 이미지 사용
FROM python:3.12-slim     # ~150MB

# [더 좋은 예] 불필요한 캐시 삭제
RUN pip install --no-cache-dir -e .
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

실수 5: 서비스 시작 순서 미보장

# [나쁜 예] depends_on만 사용
depends_on:
  - neo4j
# -> Neo4j 프로세스 시작만 보장, 실제 준비는 미보장

# [좋은 예] healthcheck와 함께
depends_on:
  neo4j:
    condition: service_healthy
# -> Neo4j가 실제로 쿼리 가능한 상태가 된 후 앱 시작