🚀 [Deploy] Merge dev branch into main

.github/workflows/README.md

@@ -0,0 +1,101 @@
+## 📌 CI/CD 개요
+이 프로젝트는 **GitHub Actions + Docker + Nginx + Blue-Green Deployment**를 사용하여 **자동화된 CI/CD**를 수행합니다.
+
+## ✅ CI (Continuous Integration)
+| 브랜치                             | 동작                                        |
+|---------------------------------|-------------------------------------------|
+| `feature/*, bugfix/*, hotfix/*` | **빌드 & Docker Push** (`kok-CI.yml`)       |
+| `develop`                       | **빌드 & Docker Push** (`kok-CI.yml`)       |
+
+---
+
+## ✅ CD (Continuous Deployment)
+| 브랜치       | 동작                                        |
+|-----------|-------------------------------------------|
+| `develop` | **개발 서버** 배포 (`kok-dev-CD.yml`)           |
+| `main`    | **운영 서버 (Blue-Green 배포, 수동 실행)** (`kok-prod-CD.yml`) |
+
+---
+
+## 📂 CI/CD 워크플로우 파일 설명
+
+| 파일명                     | 설명                 |
+|-------------------------|--------------------|
+| `kok-CI.yml`            | 빌드 및 Docker 배포     |
+| `kok-dev-CD.yml`        | 개발 서버 배포           |
+| `kok-prod-CD.yml`       | 운영 서버 (Blue-Green) 배포 |
+| `blue-green-Nginx.conf` | Nginx 설정 (트래픽 스위칭) |
+
+---
+
+## 🔑 **필요한 GitHub Secrets 목록**
+| 이름 | 설명 |
+|------|------|
+| `DOCKERHUB_USERNAME` | Docker Hub 로그인 ID |
+| `DOCKERHUB_PASSWORD` | Docker Hub 로그인 비밀번호 |
+| `NCP_HOST` | NCP 서버 주소 (배포 서버 IP) |
+| `NCP_USER` | NCP 서버 로그인 계정 (보통 `ubuntu` 또는 `root`) |
+| `NCP_KEY` | NCP 서버 접근을 위한 SSH Key (pem 파일 내용) |
+| `COMPOSE_FILE_PATH` | Docker Compose가 실행될 서버 경로 |
+| `IMAGE_NAME` | Docker Hub에 업로드할 이미지명 |
+
+---
+
+## 🛠️ GitHub Actions 실행 방법
+
+### 1️⃣ **수동 실행 for Prod(`workflow_dispatch`)**
+GitHub Actions에서 `Run Workflow` 버튼을 눌러 배포할 수 있습니다.
+
+| 브랜치  | 실행 워크플로우|
+|---------|-----------------------------|
+| `main`  | `kok-prod-CD.yml` (운영 서버 배포) |
+
+### 2️⃣ **자동 실행 for Dev & CI**
+| 브랜치       | 트리거    | 실행되는 워크플로우                   |
+|-----------|--------|------------------------------|
+| `feature/*, bugfix/*, hotfix/*` | `PR`   | `kok-CI.yml` (빌드 & Docker 배포) |
+| `develop` | `PR`   | `kok-CI.yml` (빌드 & Docker 배포) |
+| `develop` | `Push` | `kok-CI.yml` (빌드 & Docker 배포) |
+| `develop` | `Push` | `kok-dev-CD.yml` (개발 서버 배포)  |
+
+---
+
+## 🚀 운영(Prod) 배포 프로세스 (Blue-Green Deployment)
+운영 배포는 **Blue-Green Deployment** 방식을 사용하여 **무중단 배포**를 수행합니다.
+
+### **1️⃣ 배포 트리거**
+- `main` 브랜치에 코드를 푸시하고 난 후, 수동으로 (`workflow_dispatch`) 배포를 시작합니다.
+- GitHub Actions가 `docker-compose-prod.yml`을 서버에 업로드하고 배포를 시작합니다.
+
+### **2️⃣ 현재 실행 중인 서비스 확인**
+- `nginx.conf`에서 현재 사용 중인 컨테이너(`kok-blue` 또는 `kok-green`을 확인)합니다.
+
+### **3️⃣ 새로운 컨테이너 실행**
+- 현재 사용 중인 환경이 `kok-blue`이면 `kok-green`을 실행 (`docker-compose-green.yml` 사용).
+- 현재 사용 중인 환경이 `kok-green`이면 `kok-blue`를 실행 (`docker-compose-blue.yml` 사용).
+
+### **4️⃣ Health Check**
+- 새롭게 실행된 컨테이너가 정상적으로 작동하는지 `/health_check` 엔드포인트를 통해 확인합니다.
+- Health Check 실패 시 롤백하여 기존 컨테이너를 유지합니다.
+
+### **5️⃣ 트래픽 전환**
+- `nginx.conf`의 `upstream` 설정을 변경하여, 새로운 컨테이너로 트래픽을 전환합니다.
+- `nginx -s reload` 명령어를 실행하여 Nginx설정을 반영합니다.
+
+### **6️⃣ 기존 컨테이너 정리**
+- 새로운 환경이 정상적으로 배포된 후, 이전 컨테이너를 중지하고 삭제하여 리소스를 절약합니다.
+
+---
+
+## 🚀 개발(Dev) 배포 프로세스
+개발 배포는 운영 환경보다 **간단한 단일 컨테이너 배포** 방식으로 진행됩니다.
+
+### **1️⃣ 배포 트리거**
+- `develop` 브랜치에 코드가 푸시되면 `kok-dev-CD.yml`이 실행됩니다.
+- GitHub Actions가 `docker-compose-dev.yml`을 서버에 업로드하고 배포를 시작합니다.
+
+### **2️⃣ 기존 컨테이너 종료**
+- 기존에 실행 중인 `kok-dev` 컨테이너를 중지 (`docker compose down` 실행).
+
+### **3️⃣ 새로운 컨테이너 실행**
+- `docker compose -f docker-compose-dev.yml up -d` 명령어를 실행하여 새로운 컨테이너를 실행합니다.

.github/workflows/kok-CI.yml

@@ -0,0 +1,101 @@
+name: kok-CI (Build & Push for kok)
+
+on:
+  pull_request:
+    branches:
+      - develop
+      - main
+  push:
+    branches:
+      - develop
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    outputs:
+      IMAGE_TAG: ${{ steps.determine-tag.outputs.IMAGE_TAG }}
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v2
+        with:
+          distribution: 'zulu'
+          java-version: '21'
+
+      - name: Determine Image Tag (prod/dev)
+        id: determine-tag
+        run: |
+          if [[ "$GITHUB_EVENT_NAME" == "pull_request" ]]; then
+            BRANCH_NAME="$GITHUB_BASE_REF"
+          else
+            BRANCH_NAME="$GITHUB_REF_NAME"
+          fi
+
+          echo "🔍 현재 브랜치: $BRANCH_NAME"
+
+          if [[ "$BRANCH_NAME" == "main" ]]; then
+            echo "IMAGE_TAG=prod" | tee -a $GITHUB_ENV
+            echo "::set-output name=IMAGE_TAG::prod"
+          else
+            echo "IMAGE_TAG=dev" | tee -a $GITHUB_ENV
+            echo "::set-output name=IMAGE_TAG::dev"
+          fi
+
+          echo "✅ 현재 GITHUB_ENV 값:"
+          cat $GITHUB_ENV
+
+      - name: Build with Gradle (멀티모듈)
+        run: |
+          ./gradlew clean build -x test
+
+      - name: Save Build Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifact
+          path: kok-api/build/libs/*.jar
+
+  docker:
+    runs-on: ubuntu-latest
+    needs: build
+    env:
+      IMAGE_TAG: ${{ needs.build.outputs.IMAGE_TAG }}
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Download Build Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-artifact
+          path: kok-api/build/libs/
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: Build & Push Docker Image
+        run: |
+          echo "🏷 IMAGE_TAG 값 확인: '$IMAGE_TAG'"
+
+          if [[ -z "$IMAGE_TAG" ]]; then
+            echo "🚨 ERROR: IMAGE_TAG 값이 비어 있음!"
+            exit 1
+          fi
+
+          IMAGE_NAME="${{ secrets.DOCKERHUB_USERNAME }}/kok-${IMAGE_TAG}"
+
+          echo "🚀 Building Docker Image: $IMAGE_NAME:$GITHUB_SHA"
+
+          # Docker Build & Push
+          docker build -t $IMAGE_NAME:$GITHUB_SHA -f Dockerfile .
+          docker push $IMAGE_NAME:$GITHUB_SHA
+
+      - name: Notify Deployment Trigger
+        run: |
+          echo "🚀 Docker 이미지 생성 완료! Image: $IMAGE_NAME"

.github/workflows/kok-dev-CD.yml

@@ -0,0 +1,47 @@
+name: kok-dev-CD (Deploy to Dev)
+
+on:
+  push:
+    branches:
+      - develop
+      - deploy/dev_cd # 배포 테스트 브랜치
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Get Latest Docker Image Tag
+        id: latest_tag
+        run: |
+          LATEST_TAG=$(curl -s "https://hub.docker.com/v2/repositories/${{ secrets.DOCKERHUB_USERNAME }}/kok-dev/tags" | jq -r '.results[0].name')
+          echo "LATEST_TAG=$LATEST_TAG" >> $GITHUB_ENV
+
+
+      - name: Create SSH key file
+        run: echo "${{ secrets.AWS_KEY }}" > /tmp/AWS_KEY.pem
+
+      - name: Set permissions for SSH key file
+        run: chmod 400 /tmp/AWS_KEY.pem
+
+      - name: Upload `docker-compose.yml` to AWS
+        run: |
+          scp -i /tmp/AWS_KEY.pem -o StrictHostKeyChecking=no infra/docker-compose-dev.yml ${{ secrets.AWS_USER }}@${{ secrets.AWS_DEV_HOST }}:${{ secrets.COMPOSE_FILE_PATH }}
+
+      - name: Deploy to Dev Server
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.AWS_DEV_HOST }}
+          username: ${{ secrets.AWS_USER }}
+          key: ${{ secrets.AWS_KEY }}
+          script: |
+            cd ${{ secrets.COMPOSE_FILE_PATH }}
+
+            sed -i '/^KOK_DEV_TAG = /d' .env
+            echo "KOK_DEV_TAG = ${{ env.LATEST_TAG }}" >> .env
+
+            sudo docker compose -f docker-compose-dev.yml pull
+            sudo docker compose -f docker-compose-dev.yml down
+            sudo docker compose -f docker-compose-dev.yml up -d

.github/workflows/kok-prod-CD.yml

@@ -0,0 +1,40 @@
+name: kok-prod-CD (Deploy to Prod - Blue-Green Auto)
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Get Latest Docker Image Tag
+        id: latest_tag
+        run: |
+          LATEST_TAG=$(curl -s "https://hub.docker.com/v2/repositories/${{ secrets.DOCKERHUB_USERNAME }}/kok-prod/tags" | jq -r '.results[0].name')
+          echo "LATEST_TAG=$LATEST_TAG" >> $GITHUB_ENV
+
+      - name: Create SSH key file
+        run: echo "${{ secrets.AWS_KEY }}" > /tmp/AWS_KEY.pem
+
+      - name: Set permissions for SSH key file
+        run: chmod 600 /tmp/AWS_KEY.pem
+
+      - name: Upload Compose files & deploy.sh to AWS
+        run: |
+          scp -i /tmp/AWS_KEY.pem -o StrictHostKeyChecking=no infra/docker-compose-blue.yml ${{ secrets.AWS_USER }}@${{ secrets.AWS_PROD_HOST }}:${{ secrets.COMPOSE_FILE_PATH }}
+          scp -i /tmp/AWS_KEY.pem -o StrictHostKeyChecking=no infra/docker-compose-green.yml ${{ secrets.AWS_USER }}@${{ secrets.AWS_PROD_HOST }}:${{ secrets.COMPOSE_FILE_PATH }}
+          scp -i /tmp/AWS_KEY.pem -o StrictHostKeyChecking=no infra/deploy.sh ${{ secrets.AWS_USER }}@${{ secrets.AWS_PROD_HOST }}:${{ secrets.COMPOSE_FILE_PATH }}
+
+      - name: Deploy to AWS via deploy.sh
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.AWS_PROD_HOST }}
+          username: ${{ secrets.AWS_USER }}
+          key: ${{ secrets.AWS_KEY }}
+          script: |
+            cd ${{ secrets.COMPOSE_FILE_PATH }}
+            chmod +x deploy.sh
+            ./deploy.sh "${{ env.LATEST_TAG }}"