From 7dbb742981c23441be1388ee8ce33181bd96a1a9 Mon Sep 17 00:00:00 2001
From: Hyungi Ahn <hyungiahn@Hyungiui-MacBookPro.local>
Date: Fri, 1 Aug 2025 13:46:22 +0900
Subject: [PATCH] =?UTF-8?q?=F0=9F=90=B3=20Docker=20=ED=99=98=EA=B2=BD?=
 =?UTF-8?q?=EB=B3=84=20=EC=84=A4=EC=A0=95=20=EB=B6=84=EB=A6=AC=20=EB=B0=8F?=
 =?UTF-8?q?=20=EC=8B=A4=ED=96=89=20=EC=8A=A4=ED=81=AC=EB=A6=BD=ED=8A=B8=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docker-compose.dev.yml: 개발환경 전용 설정
- docker-compose.prod.yml: 프로덕션환경 전용 설정
- scripts/dev.sh, scripts/prod.sh: 환경별 실행 스크립트
- Dockerfile 및 nginx.conf 추가로 완전한 컨테이너화 구현
- 환경변수를 통한 유연한 API URL 설정
---
 backend/Dockerfile      | 28 +++++++++++++++++++++++++
 docker-compose.dev.yml  | 26 +++++++++++++++++++++++
 docker-compose.prod.yml | 46 +++++++++++++++++++++++++++++++++++++++++
 frontend/Dockerfile     | 36 ++++++++++++++++++++++++++++++++
 frontend/nginx.conf     | 26 +++++++++++++++++++++++
 scripts/dev.sh          | 19 +++++++++++++++++
 scripts/prod.sh         | 17 +++++++++++++++
 7 files changed, 198 insertions(+)
 create mode 100644 backend/Dockerfile
 create mode 100644 docker-compose.dev.yml
 create mode 100644 docker-compose.prod.yml
 create mode 100644 frontend/Dockerfile
 create mode 100644 frontend/nginx.conf
 create mode 100755 scripts/dev.sh
 create mode 100755 scripts/prod.sh

diff --git a/backend/Dockerfile b/backend/Dockerfile
new file mode 100644
index 0000000..441297e
--- /dev/null
+++ b/backend/Dockerfile
@@ -0,0 +1,28 @@
+# Python 3.9 베이스 이미지 사용
+FROM python:3.9-slim
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# 시스템 패키지 업데이트 및 필요한 패키지 설치
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# requirements.txt 복사 및 의존성 설치
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 애플리케이션 코드 복사
+COPY . .
+
+# 포트 8000 노출
+EXPOSE 8000
+
+# 환경변수 설정
+ENV PYTHONPATH=/app
+
+# 서버 실행
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
\ No newline at end of file
diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
new file mode 100644
index 0000000..a092ebe
--- /dev/null
+++ b/docker-compose.dev.yml
@@ -0,0 +1,26 @@
+version: '3.8'
+
+# 개발 환경용 오버라이드
+services:
+  frontend:
+    environment:
+      - VITE_API_URL=http://localhost:8000
+    build:
+      args:
+        - VITE_API_URL=http://localhost:8000
+
+  backend:
+    volumes:
+      - ./backend:/app  # 개발 시 코드 변경 실시간 반영
+    environment:
+      - DEBUG=True
+      - RELOAD=True
+
+  # 개발용 포트 매핑
+  postgres:
+    ports:
+      - "5432:5432"
+
+  redis:
+    ports:
+      - "6379:6379"
\ No newline at end of file
diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml
new file mode 100644
index 0000000..60b3557
--- /dev/null
+++ b/docker-compose.prod.yml
@@ -0,0 +1,46 @@
+version: '3.8'
+
+# 프로덕션 환경용 오버라이드
+services:
+  frontend:
+    environment:
+      - VITE_API_URL=/api
+    build:
+      args:
+        - VITE_API_URL=/api
+    # 포트를 외부에 노출하지 않음 (리버스 프록시 사용)
+    ports: []
+
+  backend:
+    environment:
+      - DEBUG=False
+      - RELOAD=False
+    # 포트를 외부에 노출하지 않음
+    ports: []
+
+  # 프로덕션용 리버스 프록시 (예: Nginx)
+  nginx:
+    image: nginx:alpine
+    container_name: tk-mp-nginx
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
+      - ./nginx/ssl:/etc/nginx/ssl  # SSL 인증서
+    depends_on:
+      - frontend
+      - backend
+    networks:
+      - tk-mp-network
+
+  # 데이터베이스 접근 제한
+  postgres:
+    ports: []  # 외부 접근 차단
+
+  redis:
+    ports: []  # 외부 접근 차단
+
+  pgadmin:
+    ports: []  # 외부 접근 차단 (필요시 SSH 터널링)
\ No newline at end of file
diff --git a/frontend/Dockerfile b/frontend/Dockerfile
new file mode 100644
index 0000000..0c73b67
--- /dev/null
+++ b/frontend/Dockerfile
@@ -0,0 +1,36 @@
+# Node.js 18 베이스 이미지 사용
+FROM node:18-alpine
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# 빌드 인자 받기
+ARG VITE_API_URL=http://localhost:8000
+ENV VITE_API_URL=$VITE_API_URL
+
+# package.json과 package-lock.json 복사
+COPY package*.json ./
+
+# 의존성 설치 (플랫폼별 바이너리 다운로드)
+RUN npm ci --force
+
+# 소스 코드 복사 (node_modules 제외)
+COPY . .
+
+# Vite 빌드
+RUN npm run build
+
+# Nginx 이미지로 멀티스테이지 빌드
+FROM nginx:alpine
+
+# 빌드된 파일을 nginx로 복사
+COPY --from=0 /app/dist /usr/share/nginx/html
+
+# nginx 설정 파일 복사 (필요시)
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# 포트 3000 노출
+EXPOSE 3000
+
+# nginx 실행
+CMD ["nginx", "-g", "daemon off;"]
\ No newline at end of file
diff --git a/frontend/nginx.conf b/frontend/nginx.conf
new file mode 100644
index 0000000..b6ab2bf
--- /dev/null
+++ b/frontend/nginx.conf
@@ -0,0 +1,26 @@
+server {
+    listen 3000;
+    server_name localhost;
+    root /usr/share/nginx/html;
+    index index.html index.htm;
+
+    # SPA를 위한 설정 (React Router 등)
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # API 프록시 설정
+    location /api/ {
+        proxy_pass http://tk-mp-backend:8000/;
+        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;
+    }
+
+    # 정적 파일 캐싱
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}
\ No newline at end of file
diff --git a/scripts/dev.sh b/scripts/dev.sh
new file mode 100755
index 0000000..c61163c
--- /dev/null
+++ b/scripts/dev.sh
@@ -0,0 +1,19 @@
+#!/bin/bash
+# 개발 환경 실행 스크립트
+
+echo "🚀 TK-MP 프로젝트 개발 환경 시작..."
+
+# 기존 컨테이너 정리
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml down
+
+# 개발 환경으로 빌드 및 실행
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d
+
+echo "✅ 개발 환경이 실행되었습니다!"
+echo "📱 프론트엔드: http://localhost:3000"
+echo "🔧 백엔드 API: http://localhost:8000"
+echo "📚 API 문서: http://localhost:8000/docs"
+echo "🗄️ pgAdmin: http://localhost:5050"
+
+# 로그 출력
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml logs -f
\ No newline at end of file
diff --git a/scripts/prod.sh b/scripts/prod.sh
new file mode 100755
index 0000000..a3511ff
--- /dev/null
+++ b/scripts/prod.sh
@@ -0,0 +1,17 @@
+#!/bin/bash
+# 프로덕션 환경 실행 스크립트
+
+echo "🚀 TK-MP 프로젝트 프로덕션 환경 시작..."
+
+# 기존 컨테이너 정리
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml down
+
+# 프로덕션 환경으로 빌드 및 실행
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml up --build -d
+
+echo "✅ 프로덕션 환경이 실행되었습니다!"
+echo "🌐 애플리케이션: http://localhost (또는 도메인)"
+echo "🔒 HTTPS: https://localhost (SSL 설정 시)"
+
+# 상태 확인
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml ps
\ No newline at end of file