Merge branch 'crone/ci-cd-pipline' of https://github.com/ProjectVG/ProjectVG-API-Server into crone/ci-cd-pipline

Author: ImGdevel

.github/workflows/develop.yml

@@ -55,19 +55,11 @@ jobs:
       run: |
         echo "테스트 중..."
         start_time=$(date +%s)
-        dotnet test --no-build --configuration Release --verbosity normal --collect:"XPlat Code Coverage" --logger trx --results-directory coverage
+        dotnet test --no-build --configuration Release --verbosity normal
         end_time=$(date +%s)
         duration=$((end_time - start_time))
         echo "테스트 완료 (${duration}초)"
         
-    - name: Publish Test Results
-      uses: dorny/test-reporter@v1
-      if: success() || failure()
-      with:
-        name: Test Results
-        path: coverage/*.trx
-        reporter: dotnet-trx
-        
     - name: Success Status
       if: success()
       run: |

.github/workflows/release.yml

@@ -105,7 +105,8 @@ jobs:
 
     - name: Cleanup
       run: |
-        docker system prune -af --volumes
+        docker image prune -f
+        docker builder prune -f
         
     - name: Deploy Success Status
       if: success()

deploy/DEPLOYMENT.md

@@ -50,16 +50,17 @@ git push origin release
 # 1. 최신 코드 가져오기
 git pull origin release
 
-# 2. 환경 설정 파일 준비
-cp env.prod.example .env
-cp docker-compose.prod.yml docker-compose.yml
+# 2. DB/Redis 서비스 시작 (최초 1회만 실행)
+docker-compose -f docker-compose.db.yml up -d
 
+# 3. 환경 설정 파일 준비
+cp env.prod.example .env
 # 실제 환경변수 값으로 수정
 vi .env
 
-# 3. 배포 스크립트 실행
-chmod +x deploy.sh
-./deploy.sh
+# 4. API 서비스 배포
+chmod +x deploy/deploy.sh
+./deploy/deploy.sh
 ```
 
 ### 개발 환경 배포
@@ -73,8 +74,9 @@ chmod +x deploy-dev.sh
 ## 📋 배포 스크립트 상세
 
 ### `deploy.sh` (프로덕션)
-- **용도**: 프로덕션 환경 배포
+- **용도**: API 서비스만 배포 (DB/Redis는 별도 관리)
 - **이미지**: GHCR에서 최신 이미지 풀
+- **네트워크**: `projectvg-external-db` 네트워크로 DB/Redis 연결
 - **헬스체크**: 30회 재시도 (최대 2.5분)
 - **로그**: 배포 후 최근 로그 20줄 출력
 
@@ -140,6 +142,11 @@ docker-compose up -d
 - 민감한 정보는 평문으로 저장하지 않음
 - 프로덕션과 개발 환경 분리
 
+### 인프라 분리
+- **DB/Redis**: `docker-compose.db.yml`로 별도 관리 (영구 실행)
+- **API 서비스**: `docker-compose.prod.yml`로 배포시에만 재시작
+- **외부 DB/Cache**: AWS RDS, ElastiCache 등으로 쉽게 대체 가능
+
 ### Docker 이미지
 - GHCR을 통한 이미지 배포
 - 정기적인 base 이미지 업데이트

deploy/deploy.sh

@@ -20,31 +20,47 @@ if [ ! -f "deploy/docker-compose.prod.yml" ]; then
     exit 1
 fi
 
-# 현재 실행 중인 컨테이너 중지 및 제거
-echo "기존 컨테이너 중지 중..."
-docker-compose -f deploy/docker-compose.prod.yml down --remove-orphans || true
-
-# GitHub Container Registry에서 최신 이미지 풀
+# GitHub Container Registry에서 최신 이미지 풀 (Zero-downtime을 위해 먼저 실행)
 echo "최신 이미지 다운로드 중..."
-echo "GHCR 이미진 Pull: ghcr.io/projectvg/projectvgapi:latest"
-docker-compose -f deploy/docker-compose.prod.yml pull
+echo "GHCR 이미지 Pull: ghcr.io/projectvg/projectvgapi:latest"
+docker-compose -f deploy/docker-compose.prod.yml pull projectvg-api
 
 # 이미지 풀 후 확인
 if ! docker images ghcr.io/projectvg/projectvgapi:latest | grep -q latest; then
     echo "ERROR: 이미지 풀에 실패했습니다. GitHub Container Registry 인증을 확인하세요."
     exit 1
 fi
 
-# 서비스 시작
-echo "서비스 시작 중..."
-docker-compose -f deploy/docker-compose.prod.yml up -d
+# 기존 API 컨테이너만 중지 및 제거 (Zero-downtime strategy)
+echo "기존 API 컨테이너 교체 중..."
+echo "현재 실행중인 컨테이너 확인:"
+docker ps -f "name=projectvg-api"
+
+docker-compose -f deploy/docker-compose.prod.yml stop projectvg-api || true
+docker-compose -f deploy/docker-compose.prod.yml rm -f projectvg-api || true
+
+# 새 이미지로 API 서비스만 시작
+echo "새 이미지로 API 서비스 시작 중..."
+docker-compose -f deploy/docker-compose.prod.yml up -d projectvg-api
 
 # 서비스 상태 확인
-echo "서비스 상태 확인 중..."
-sleep 10
+# 빌드 후 불필요한 이미지 정리
+echo "이전 이미지 정리 중..."
+old_images=$(docker images ghcr.io/projectvg/projectvgapi -f "dangling=true" -q)
+if [ ! -z "$old_images" ]; then
+    docker rmi $old_images -f 2>/dev/null || true
+    echo "이전 이미지 정리 완료"
+else
+    echo "정리할 이전 이미지 없음"
+fi
+
+# 컨테이너 상태 확인
+echo "API 컨테이너 상태 확인 중..."
+sleep 3
 
-# 컨테이너 상태 출력
-docker-compose -f deploy/docker-compose.prod.yml ps
+# API 컨테이너 상태만 출력
+echo "API 컨테이너 상태:"
+docker ps -f "name=projectvg-api"
 
 # 헬스체크 (API가 응답하는지 확인)
 echo "헬스체크 수행 중..."
@@ -70,11 +86,12 @@ done
 
 if [ $retry_count -eq $max_retries ]; then
     echo "ERROR: API 서버가 시작되지 않았습니다. 로그를 확인하세요."
-    echo "API 컨테이너 로그:"
-    echo "Docker 컨테이너 상태:"
+    echo "API 컨테이너 상태:"
     docker ps -a --filter name=projectvg-api
-    echo ""
+    echo "API 컨테이너 로그 (최근 50줄):"
     docker-compose -f deploy/docker-compose.prod.yml logs --tail=50 projectvg-api
+    
+    echo "롤백을 수행하시겠습니까? 이전 이미지로 복구할 수 있습니다."
     exit 1
 fi
 
@@ -83,6 +100,14 @@ echo "배포가 성공적으로 완료되었습니다!"
 echo "API 엔드포인트: http://localhost:7910"
 echo "헬스체크: http://localhost:7910/health"
 
-# 로그 출력 (선택적)
-echo "최근 로그:"
-docker-compose -f deploy/docker-compose.prod.yml logs --tail=20
+# 최근 API 로그 출력
+echo "최근 API 로그 (20줄):"
+docker-compose -f deploy/docker-compose.prod.yml logs --tail=20 projectvg-api
+
+# 배포 완료 상태 요약
+echo ""
+echo "=== 배포 완료 상태 요약 ==="
+echo "API 컨테이너:"
+docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" -f "name=projectvg-api"
+echo "이미지 정보:"
+docker images --format "table {{.Repository}}:{{.Tag}}\t{{.CreatedAt}}\t{{.Size}}" ghcr.io/projectvg/projectvgapi:latest

deploy/docker-compose.prod.yml

@@ -5,17 +5,15 @@ services:
     image: ghcr.io/projectvg/projectvgapi:latest
     container_name: projectvg-api
     ports:
-      - "7910:8080"
+      - "${API_PORT:-7910}:8080"
     environment:
-      - ASPNETCORE_ENVIRONMENT=Production
+      - ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT:-Production}
       - ASPNETCORE_URLS=http://+:8080
     env_file:
       - .env
-    depends_on:
-      - projectvg-db
-      - projectvg-redis
     networks:
       - projectvg-network
+      - projectvg-external-db
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
@@ -29,51 +27,9 @@ services:
         max-size: "100m"
         max-file: "3"
 
-  projectvg-db:
-    image: mcr.microsoft.com/mssql/server:2022-latest
-    container_name: projectvg-db
-    ports:
-      - "1433:1433"
-    environment:
-      - ACCEPT_EULA=Y
-      - MSSQL_SA_PASSWORD=${DB_SA_PASSWORD}
-      - MSSQL_PID=Developer
-    volumes:
-      - projectvg_db_data:/var/opt/mssql
-    networks:
-      - projectvg-network
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P ${DB_SA_PASSWORD} -Q 'SELECT 1' || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 60s
-
-  projectvg-redis:
-    image: redis:7-alpine
-    container_name: projectvg-redis
-    ports:
-      - "6380:6379"
-    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD}
-    volumes:
-      - projectvg_redis_data:/data
-    networks:
-      - projectvg-network
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-
-volumes:
-  projectvg_db_data:
-    driver: local
-  projectvg_redis_data:
-    driver: local
-
 networks:
   projectvg-network:
-    driver: bridge
+    driver: bridge
+  projectvg-external-db:
+    external: true
+    name: projectvg-external-db