crone: 배포 파이프라인 구성

Author: ImGdevel

.env.example

@@ -0,0 +1,39 @@
+# ===========================================
+# ProjectVG API Server - Environment Variables Template
+# ===========================================
+# Copy this file to .env and fill in your actual values
+
+# Database Configuration
+DB_CONNECTION_STRING=Server=host.docker.internal,1433;Database=ProjectVG;User Id=sa;Password=YOUR_DB_PASSWORD;TrustServerCertificate=true;MultipleActiveResultSets=true
+DB_PASSWORD=YOUR_DB_PASSWORD
+
+# Redis Configuration
+REDIS_CONNECTION_STRING=host.docker.internal:6380
+
+# External Services
+LLM_BASE_URL=http://host.docker.internal:7908
+MEMORY_BASE_URL=http://host.docker.internal:7912
+TTS_BASE_URL=https://supertoneapi.com
+TTS_API_KEY=YOUR_TTS_API_KEY
+
+# JWT Configuration (IMPORTANT: Use a secure random key in production)
+JWT_SECRET_KEY=YOUR_JWT_SECRET_KEY_MINIMUM_32_CHARACTERS
+JWT_ACCESS_TOKEN_LIFETIME_MINUTES=15
+JWT_REFRESH_TOKEN_LIFETIME_DAYS=30
+
+# OAuth2 Configuration
+OAUTH2_ENABLED=true
+GOOGLE_OAUTH_ENABLED=true
+GOOGLE_OAUTH_CLIENT_ID=YOUR_GOOGLE_CLIENT_ID
+GOOGLE_OAUTH_CLIENT_SECRET=YOUR_GOOGLE_CLIENT_SECRET
+GOOGLE_OAUTH_REDIRECT_URI=http://localhost:7900/auth/oauth2/callback
+GOOGLE_OAUTH_AUTO_CREATE_USER=true
+GOOGLE_OAUTH_DEFAULT_ROLE=User
+
+# Application Configuration
+ASPNETCORE_ENVIRONMENT=Production
+
+# Container Resource Limits
+API_CPU_LIMIT=1.0
+API_MEMORY_LIMIT=1g
+API_PORT=7910

.gitattributes

@@ -0,0 +1,32 @@
+# Set default behavior to automatically normalize line endings.
+* text=auto
+
+# Set file types that should always have CRLF line endings on checkout.
+*.sln text eol=crlf
+*.csproj text eol=crlf
+*.config text eol=crlf
+
+# Set file types that should always have LF line endings on checkout.
+*.sh text eol=lf
+*.bash text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+
+# Ensure that shell scripts are executable
+*.sh text eol=lf
+deploy.sh text eol=lf
+deploy-dev.sh text eol=lf
+
+# PowerShell scripts
+*.ps1 text eol=crlf
+
+# Docker files
+Dockerfile text eol=lf
+*.dockerfile text eol=lf
+docker-compose*.yml text eol=lf
+
+# Markdown files
+*.md text eol=lf
+
+# JSON files
+*.json text eol=lf

.github/workflows/dev-ci.yml renamed to .github/workflows/develop.yml

@@ -1,4 +1,4 @@
-name: 개발 환경 CI
+name: Develop
 
 on:
   pull_request:
@@ -13,27 +13,27 @@ env:
 
 jobs:
   build-and-test:
-    name: 빌드 및 테스트
+    name: Build & Test
     runs-on: ubuntu-latest
 
     steps:
-    - name: 소스 코드 체크아웃
+    - name: Checkout
       uses: actions/checkout@v4
 
-    - name: .NET 환경 설정
+    - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
-    - name: NuGet 패키지 캐싱
+    - name: Cache NuGet
       uses: actions/cache@v4
       with:
         path: ~/.nuget/packages
         key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
         restore-keys: |
           ${{ runner.os }}-nuget-
           
-    - name: 종속성 복원
+    - name: Restore
       run: |
         echo "복원 중..."
         start_time=$(date +%s)
@@ -42,7 +42,7 @@ jobs:
         duration=$((end_time - start_time))
         echo "복원 완료 (${duration}초)"
       
-    - name: 솔루션 빌드
+    - name: Build
       run: |
         echo "🔨 빌드 중..."
         start_time=$(date +%s)
@@ -51,46 +51,30 @@ jobs:
         duration=$((end_time - start_time))
         echo "빌드 완료 (${duration}초)"
       
-    - name: 단위 테스트 실행
+    - name: Test
       run: |
         echo "테스트 중..."
         start_time=$(date +%s)
         dotnet test --no-build --configuration Release --verbosity normal --collect:"XPlat Code Coverage" --logger trx --results-directory coverage
         end_time=$(date +%s)
         duration=$((end_time - start_time))
         echo "테스트 완료 (${duration}초)"
-      
-    - name: 코드 커버리지 리포트 생성
-      uses: irongut/[email protected]
-      with:
-        filename: coverage/**/coverage.cobertura.xml
-        badge: true
-        fail_below_min: false
-        format: markdown
-        hide_branch_rate: false
-        hide_complexity: true
-        indicators: true
-        output: both
-        thresholds: '60 80'
-        
-    - name: PR에 커버리지 결과 댓글 추가
-      uses: marocchino/sticky-pull-request-comment@v2
-      if: github.event_name == 'pull_request'
-      with:
-        recreate: true
-        path: code-coverage-results.md
         
-    - name: 테스트 결과 발행
+    - name: Publish Test Results
       uses: dorny/test-reporter@v1
       if: success() || failure()
       with:
-        name: 테스트 결과
+        name: Test Results
         path: coverage/*.trx
         reporter: dotnet-trx
 
-    - name: 빌드 상태 확인
+    - name: Success Status
+      if: success()
+      run: |
+        echo "✅ 빌드 및 테스트 성공"
+
+    - name: Build Status
       if: failure()
       run: |
         echo "❌ 빌드 실패"
-        echo "단계를 확인하세요."
         exit 1

.github/workflows/release-cicd.yml renamed to .github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Release CI/CD
+name: Release
 
 on:
   push:
@@ -12,79 +12,110 @@ env:
   DOTNET_VERSION: '8.0.x'
   DOCKER_IMAGE_NAME: ghcr.io/projectvg/projectvgapi
   ACTOR: projectvg
+
+permissions:
+  contents: read
+  packages: write
 
 jobs:
   build:
+    name: Build & Push
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout Repository
+    - name: Checkout
       uses: actions/checkout@v4
 
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
-    - name: Cache NuGet packages
+    - name: Cache NuGet
       uses: actions/cache@v4
       with:
         path: ~/.nuget/packages
         key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
         restore-keys: |
           ${{ runner.os }}-nuget-
           
-    - name: 종속성 복원
+    - name: Restore
       run: |
         echo "복원 중..."
         dotnet restore ProjectVG.sln
         echo "복원 완료"
         
-    - name: 솔루션 빌드
+    - name: Build
       run: |
         echo "🔨 빌드 중..."
         dotnet build ProjectVG.sln --no-restore --configuration Release
         echo "빌드 완료"
         
-    - name: 단위 테스트 실행
+    - name: Test
       run: |
         echo "테스트 중..."
-        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
         echo "테스트 완료"
         
-    - name: Login to GitHub Container Registry
+    - name: Login GHCR
       uses: docker/login-action@v3
       with:
         registry: ghcr.io
         username: ${{ env.ACTOR }}
         password: ${{ secrets.GHCR_TOKEN }}
 
-    - name: Build and Push Docker Image
+    - name: Build & Push Image
       run: |
         docker build -t ${{ env.DOCKER_IMAGE_NAME }}:latest -f ProjectVG.Api/Dockerfile .
         docker push ${{ env.DOCKER_IMAGE_NAME }}:latest
+        
+    - name: Build Success Status
+      if: success()
+      run: |
+        echo "✅ 빌드 및 이미지 푸시 완료"
+        echo "이미지: ${{ env.DOCKER_IMAGE_NAME }}:latest"
+        
+    - name: Build Failure Status
+      if: failure()
+      run: |
+        echo "❌ 빌드 또는 이미지 푸시 실패"
+        exit 1
 
   deploy:
+    name: Deploy
     needs: build
     runs-on: [self-hosted, deploy-runner]
 
     steps:
-    - name: Login to GitHub Container Registry
+    - name: Checkout
+      uses: actions/checkout@v4
+      
+    - name: Login GHCR
       run: echo "${{ secrets.GHCR_TOKEN }}" | docker login ghcr.io -u ${{ env.ACTOR }} --password-stdin
 
-    - name: Add Private Files
+    - name: Add Config Files
       run: |
         echo "${{ secrets.PROD_APPLICATION_ENV }}" | base64 --decode > .env
-        echo "${{ secrets.PROD_DOCKER_COMPOSE }}" | base64 --decode > docker-compose.yml
+        echo "${{ secrets.PROD_DOCKER_COMPOSE }}" | base64 --decode > deploy/docker-compose.yml
+        
+    - name: Make Script Executable
+      run: chmod +x deploy/deploy.sh
 
-    - name: Run Deployment Script
-      run: ./deploy.sh
+    - name: Deploy
+      run: ./deploy/deploy.sh
 
-    - name: Cleanup Docker and Cache
+    - name: Cleanup
       run: |
         docker system prune -af --volumes
         
-    - name: Deployment Status
+    - name: Deploy Success Status
+      if: success()
+      run: |
+        echo "✅ 배포 완료"
+        echo "이미지: ${{ env.DOCKER_IMAGE_NAME }}:latest"
+        
+    - name: Deploy Failure Status
+      if: failure()
       run: |
-        echo "🚀 배포 완료"
-        echo "📦 이미지: ${{ env.DOCKER_IMAGE_NAME }}:latest"
+        echo "❌ 배포 실패"
+        exit 1

.gitignore

@@ -100,7 +100,11 @@ _ReSharper*/
 
 # Docker
 **/Dockerfile.*
-docker-compose*
+docker-compose.override.yml
+
+# Keep template files but ignore runtime files
+!docker-compose.prod.yml
+!env.prod.example
 
 # Logs
 *.log
@@ -175,5 +179,5 @@ secrets.json
 *.xlsx
 
 # Demo files
-web_chat_demo.html
-time_travel_commit.exe
+*.exe
+*.ini

ProjectVG.Api/Dockerfile

@@ -29,8 +29,8 @@ EXPOSE 7900
 # 빌드 결과 복사
 COPY --from=build /app/publish .
 
-# 헬스체크 추가
-HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
-    CMD curl -f http://localhost:7900/health || exit 1
+# 헬스체크 추가 - wget 사용
+HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
+    CMD wget --no-verbose --tries=1 --spider http://localhost:7900/health || exit 1
 
 ENTRYPOINT ["dotnet", "ProjectVG.Api.dll"]

ProjectVG.sln

@@ -15,8 +15,6 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ProjectVG.Common", "Project
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ProjectVG.Tests", "ProjectVG.Tests\ProjectVG.Tests.csproj", "{9A8B7C6D-5E4F-3210-9876-543210987654}"
 EndProject
-Project("{E53339B2-1760-4266-BCC7-CA923CBCF16C}") = "docker-compose", "docker-compose.dcproj", "{81DDED9D-158B-E303-5F62-77A2896D2A5A}"
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -47,10 +45,6 @@ Global
 		{9A8B7C6D-5E4F-3210-9876-543210987654}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{9A8B7C6D-5E4F-3210-9876-543210987654}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{9A8B7C6D-5E4F-3210-9876-543210987654}.Release|Any CPU.Build.0 = Release|Any CPU
-		{81DDED9D-158B-E303-5F62-77A2896D2A5A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{81DDED9D-158B-E303-5F62-77A2896D2A5A}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{81DDED9D-158B-E303-5F62-77A2896D2A5A}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{81DDED9D-158B-E303-5F62-77A2896D2A5A}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

README.md

@@ -115,6 +115,26 @@ dotnet test ProjectVG.Tests/ProjectVG.Tests.csproj
 - `POST /api/auth/logout` - 로그아웃
 - `GET /api/test/me` - 사용자 정보 (인증 필요)
 
+## 🚀 배포
+
+### 자동 배포 (CI/CD)
+`release` 브랜치에 푸시하면 자동 배포됩니다.
+
+### 수동 배포
+```bash
+# 프로덕션 배포
+./deploy.sh
+
+# 개발 환경 배포  
+./deploy-dev.sh
+
+# Windows 환경
+.\scripts\deploy.ps1 -Environment dev
+.\scripts\deploy.ps1 -Environment prod
+```
+
+상세한 배포 가이드는 [DEPLOYMENT.md](DEPLOYMENT.md)를 참조하세요.
+
 ## 🧪 테스트
 
 ### 테스트 실행