my-project/ ├── docker-compose.yml # 서비스 오케스트레이션 ├── docker-compose.prod.yml # 운영 환경 오버라이드 ├── Dockerfile # Django 이미지 빌드 ├── .env # 환경변수 (git 제외!) ├── .env.example # 환경변수 템플릿 ├── nginx/ │ ├── nginx.conf │ └── conf.d/ │ └── default.conf └── app/ ├── manage.py ├── requirements.txt └── config/ ├── settings/ │ ├── base.py │ ├── local.py │ └── production.py └── wsgi.py

# 1단계: 빌드 스테이지 (의존성 설치) FROM python:3.12-slim AS builder WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir --upgrade pip \ && pip install --no-cache-dir -r requirements.txt # 2단계: 실행 스테이지 (최소 이미지) FROM python:3.12-slim ENV PYTHONDONTWRITEBYTECODE=1 \ # .pyc 파일 생성 방지 PYTHONUNBUFFERED=1 # 로그 실시간 출력 WORKDIR /app # 빌더에서 설치된 패키지만 복사 (이미지 크기 최소화) COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages COPY --from=builder /usr/local/bin /usr/local/bin COPY ./app . RUN python manage.py collectstatic --noinput --settings=config.settings.production EXPOSE 8000 CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "3", "config.wsgi:application"]

version: '3.9' services: # ── Django 애플리케이션 ────────────────────────── web: build: . command: gunicorn config.wsgi:application --bind 0.0.0.0:8000 --workers 3 volumes: - ./app:/app # 개발 시 코드 실시간 반영 - static_volume:/app/staticfiles - media_volume:/app/media env_file: - .env depends_on: db: condition: service_healthy # DB 준비 완료 후 시작 redis: condition: service_started # ── Nginx 리버스 프록시 ────────────────────────── nginx: image: nginx:1.25-alpine ports: - "80:80" - "443:443" volumes: - ./nginx/conf.d:/etc/nginx/conf.d - static_volume:/static - media_volume:/media - ./certbot/conf:/etc/letsencrypt # SSL 인증서 depends_on: - web # ── PostgreSQL ─────────────────────────────────── db: image: postgres:16-alpine volumes: - postgres_data:/var/lib/postgresql/data # 데이터 영속성! environment: POSTGRES_DB: ${DB_NAME} POSTGRES_USER: ${DB_USER} POSTGRES_PASSWORD: ${DB_PASSWORD} healthcheck: # DB 헬스체크 test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"] interval: 10s timeout: 5s retries: 5 # ── Redis (Celery/캐시용) ────────────────────── redis: image: redis:7-alpine volumes: - redis_data:/data # ── Celery Worker (비동기 작업) ─────────────── celery: build: . command: celery -A config worker --loglevel=info volumes: - ./app:/app env_file: - .env depends_on: - db - redis volumes: # Named volumes 정의 postgres_data: redis_data: static_volume: media_volume:

# 업스트림: Django 컨테이너 upstream django { server web:8000; # docker-compose 서비스명 사용 } server { listen 80; server_name your-domain.com; # Static 파일 직접 서빙 (Django를 거치지 않음) location /static/ { alias /static/; expires 30d; add_header Cache-Control "public, immutable"; } location /media/ { alias /media/; } # Django 앱으로 프록시 location / { proxy_pass http://django; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; client_max_body_size 10M; } }

# Django DJANGO_SETTINGS_MODULE=config.settings.production SECRET_KEY=your-super-secret-key-here DEBUG=False ALLOWED_HOSTS=your-domain.com,www.your-domain.com # Database DB_NAME=mydb DB_USER=myuser DB_PASSWORD=strongpassword123 DATABASE_URL=postgresql://myuser:strongpassword123@db:5432/mydb # Redis REDIS_URL=redis://redis:6379/0 # Email EMAIL_HOST=smtp.gmail.com EMAIL_PORT=587 EMAIL_HOST_USER=your@gmail.com EMAIL_HOST_PASSWORD=app-password

# 처음 서버 설정 $ docker-compose up -d --build # DB 마이그레이션 $ docker-compose exec web python manage.py migrate # 슈퍼유저 생성 $ docker-compose exec web python manage.py createsuperuser # 새 코드 배포 (무중단에 가까운 방식) $ git pull $ docker-compose up -d --build --no-deps web # web 서비스만 재빌드 # 로그 확인 $ docker-compose logs -f web $ docker-compose logs -f nginx # 이전 버전으로 롤백 $ docker-compose down $ docker tag myproject_web:latest myproject_web:backup $ docker-compose up -d