prod : 프로덕션과 테스트 서버 파이프라인 분리

.github/ISSUE_TEMPLATE/성능 분석.md

@@ -0,0 +1,97 @@
+---
+name: 성능 테스트 및 개선 리포트
+about: 성능 병목 테스트 및 개선 과정을 기록합니다.
+title: "[📈 성능 개선] OOO 기능의 부하 테스트 및 최적화"
+labels: "성능개선, 부하테스트, 최적화"
+assignees: ""
+---
+
+## 🎯 테스트 시나리오 정의
+
+> 어떤 기능에 대해 어떤 상황을 가정하여 성능 테스트를 진행할 것인지 구체적으로 작성합니다.
+
+- **테스트 대상 API**: `[HTTP Method] /api/v1/...`
+- **핵심 로직**: (예: 게시글 목록 조회, 복잡한 조인 쿼리 포함)
+- **부하 테스트 도구**: (예: nGrinder, JMeter, k6)
+- **테스트 환경**: (예: 로컬 MacBook Pro (M1, 16GB), DB는 Docker, 애플리케이션 메모리 1GB)
+
+---
+
+## 📊 1차 성능 측정 결과 (개선 전)
+
+> 개선 작업을 진행하기 전의 성능 지표를 기록합니다. (Before)
+
+| 지표 (Metric)                 | 측정 값 (Value) | 단위 (Unit) |
+|:----------------------------|:-------------|:----------|
+| **VUser (가상 사용자 수)**        |              | 명         |
+| **TPS (초당 트랜잭션 수)**         |              | tps       |
+| **평균 응답 시간 (Avg. Latency)** |              | ms        |
+| **최대 응답 시간 (Max. Latency)** |              | ms        |
+| **에러율 (Error Rate)**        |              | %         |
+
+**[nGrinder, JMeter 등 결과 그래프 스크린샷을 여기에 첨부해 주세요]**
+
+
+---
+
+## 🧐 병목 지점 분석 및 가설
+
+> 1차 측정 결과를 바탕으로 어떤 부분에서 병목이 발생하고 있는지 분석하고, 원인에 대한 가설을 세웁니다.
+
+**가설**:
+(예: N+1 쿼리 문제로 인해 DB 조회 시간이 과도하게 소요될 것으로 추정됨.)
+
+**근거**:
+
+- [ ] APM(Pinpoint, Sentry 등)에서 특정 메서드 지연 확인
+- [ ] 느린 쿼리 로그(Slow Query Log)에서 해당 쿼리 발견
+- [ ] 높은 CPU / Memory 사용량 확인 (구간:          )
+- [ ] 코드 리뷰 (비효율적인 로직, 불필요한 API 호출 등)
+- **기타**:
+
+---
+
+## 🛠️ 개선 전략 및 실행
+
+> 위 가설을 바탕으로 어떤 방식으로 문제를 해결할 것인지 구체적인 전략을 작성하고 실행합니다.
+
+**전략**:
+(예: JPA의 Fetch Join을 사용하여 N+1 문제를 해결. 또는, 자주 변경되지 않는 데이터에 캐싱(Redis, Caffeine)을 적용.)
+
+**관련 PR**:
+
+- #(PR 번호)
+
+---
+
+## 📊 2차 성능 측정 결과 (개선 후)
+
+> 개선 작업 후, 1차 측정과 동일한 조건으로 다시 성능을 측정하여 기록합니다. (After)
+
+| 지표 (Metric)                 | 측정 값 (Value) | 단위 (Unit) |
+|:----------------------------|:-------------|:----------|
+| **VUser (가상 사용자 수)**        |              | 명         |
+| **TPS (초당 트랜잭션 수)**         |              | tps       |
+| **평균 응답 시간 (Avg. Latency)** |              | ms        |
+| **최대 응답 시간 (Max. Latency)** |              | ms        |
+| **에러율 (Error Rate)**        |              | %         |
+
+**[개선 후 결과 그래프 스크린샷을 여기에 첨부해 주세요]**
+
+
+---
+
+## ✨ 최종 결론
+
+> 개선 전/후 지표를 비교하여 개선 효과를 정량적으로 요약하고, 결론을 작성합니다.
+
+**개선 효과 요약**:
+
+- **TPS**: `(개선 전 값)` -> `(개선 후 값)` **( 약 O 배 증가 )**
+- **평균 응답 시간**: `(개선 전 값)` -> `(개선 후 값)` **( 약 O % 감소 )**
+
+**결론**:
+(예: Fetch Join 적용으로 N+1 문제를 해결하여 DB I/O를 크게 줄였고, 그 결과 TPS는 2.5배 증가, 평균 응답 시간은 60% 감소하는 효과를 확인했습니다.)
+
+**추가 논의 사항**:
+(예: 향후 트래픽 증가 시 스케일 아웃 전략 필요, 캐시 동기화 문제에 대한 추가 논의 필요 등)

.github/workflows/docker-ci.yaml

@@ -2,12 +2,9 @@ name: Docker CI/CD
 
 on:
   pull_request:
-    branches:
-      - 'develop'
+    branches: [ develop ]
   push:
-    branches:
-      - 'develop'
-
+    branches: [ develop ]
   workflow_dispatch:
 
 jobs:
@@ -24,8 +21,24 @@ jobs:
           java-version: '21'
           distribution: 'temurin'
 
+      - name: Cache Gradle files
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            gradle-${{ runner.os }}-
+
+      - name: Clone external repo with jar into libs/
+        run: |
+          mkdir -p libs
+          git clone https://x-access-token:${{ secrets.GH_PAT }}@github.com/mosu-dev/mosu-kmc-jar.git temp-jar
+          cp temp-jar/*.jar libs/
+
       - name: Build with Gradle
-        run: ./gradlew clean build -x test
+        run: ./gradlew build -x test
 
       - name: Log in to DockerHub
         uses: docker/login-action@v3
@@ -34,9 +47,7 @@ jobs:
           password: ${{ secrets.DOCKER_PASSWORD }}
 
       - name: Build Docker image
-        run: |
-          docker build -t kangtaehyun1107/mosu-server:${{ github.sha }} .
-
+        run: docker build -t kangtaehyun1107/mosu-server:${{ github.sha }} .
+        working-directory:
       - name: Push Docker image
-        run: |
-          docker push kangtaehyun1107/mosu-server:${{ github.sha }}
+        run: docker push kangtaehyun1107/mosu-server:${{ github.sha }}

.github/workflows/docker-depoly.yaml

@@ -22,10 +22,9 @@ jobs:
           script: |
             cd /home/ubuntu/mosu
 
-            echo "${{ secrets.env }}" > .env.prod
+            echo "${{ secrets.ENV_BLUE }}" > .env.blue
+            echo "${{ secrets.ENV_GREEN }}" > .env.green
 
-            echo "APP_IMAGE_VERSION=${{ github.sha }}" >> .env.prod
-
-            sudo docker compose pull
-            sudo docker compose down
-            sudo docker compose -f docker-compose.yml --env-file .env.prod up -d --build
+            echo "APP_IMAGE_VERSION=${{ github.sha }}" >> .env.blue
+            echo "APP_IMAGE_VERSION=${{ github.sha }}" >> .env.green
+            ./deploy.sh

.github/workflows/docker-pr-build.yaml

@@ -0,0 +1,38 @@
+name: Docker PR build
+
+on:
+  pull_request:
+    branches: [ develop ]
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v3
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v3
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+
+      - name: Cache Gradle files
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            gradle-${{ runner.os }}-
+
+      - name: Clone external repo with jar into libs/
+        run: |
+          mkdir -p libs
+          git clone https://x-access-token:${{ secrets.GH_PAT }}@github.com/mosu-dev/mosu-kmc-jar.git temp-jar
+          cp temp-jar/*.jar libs/
+
+      - name: Build with Gradle
+        run: ./gradlew build -x test

.github/workflows/self-depoly.yaml

@@ -0,0 +1,24 @@
+name: Docker CI/CD - Deploy
+
+on:
+  workflow_dispatch:
+    branches:
+      - test
+jobs:
+  deploy:
+    runs-on: self-hosted
+
+    steps:
+      - name: Deploy via SSH
+        run: |
+          cd ~/mosu-server
+
+          echo "${{ secrets.TEST_ENV_BLUE }}" > .env.blue
+          echo "${{ secrets.TEST_ENV_GREEN }}" > .env.green
+          echo "APP_IMAGE_VERSION=${{ github.sha }}" >> .env.blue
+          echo "APP_IMAGE_VERSION=${{ github.sha }}" >> .env.green
+          sudo docker stop $(sudo docker ps -aq) || true
+          sudo docker rm $(sudo docker ps -aq) || true
+          echo "Stopping all containers..."
+
+          sudo ./deploy.sh

.gitignore

@@ -4,6 +4,7 @@ build/
 !gradle/wrapper/gradle-wrapper.jar
 !**/src/main/**/build/
 !**/src/test/**/build/
+src/main/generated
 
 ### STS ###
 .apt_generated
@@ -37,4 +38,8 @@ out/
 .vscode/
 
 docker-compose/.env
-docker-compose/.env.local
+docker-compose/.env.local
+docker-compose/.env.prod
+
+/logs/**
+/libs/**

Dockerfile

@@ -1,4 +1,4 @@
-FROM openjdk:21-jdk
-ARG JAR_FILE=build/libs/*.jar
-ADD ${JAR_FILE} app.jar
-ENTRYPOINT ["java", "-Duser.timezone=GMT+9", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/app.jar"]
+FROM amazoncorretto:21
+COPY build/libs/*SNAPSHOT.war app.war
+
+ENTRYPOINT ["java", "-Duser.timezone=GMT+9", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/app.war"]

build.gradle

@@ -2,6 +2,7 @@ plugins {
     id 'java'
     id 'org.springframework.boot' version '3.4.5'
     id 'io.spring.dependency-management' version '1.1.7'
+    id 'war'
 }
 
 group = 'life.mosu'
@@ -24,7 +25,7 @@ repositories {
 }
 
 dependencies {
-
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.boot:spring-boot-starter-validation'
@@ -38,8 +39,12 @@ dependencies {
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 
+    // 인증사 관련 의존성
+    implementation 'javax.servlet:jstl:1.2'
+    implementation "org.apache.tomcat.embed:tomcat-embed-jasper"
+
     // swagger
-    implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0"
+    implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.9"
 
     // jwt
     implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
@@ -58,9 +63,17 @@ dependencies {
     implementation 'org.flywaydb:flyway-mysql'
     runtimeOnly 'com.mysql:mysql-connector-j'
 
+    // Testcontainers
+    testImplementation 'org.springframework.boot:spring-boot-testcontainers:3.3.5'
+    testImplementation 'org.testcontainers:testcontainers:1.19.3'
+    testImplementation 'org.testcontainers:junit-jupiter:1.19.3'
+    testImplementation 'org.testcontainers:mysql:1.20.0'
+
+
     // security
     implementation 'org.springframework.boot:spring-boot-starter-security'
     implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'
+    implementation 'com.github.ben-manes.caffeine:caffeine:3.1.8'
 
     // aws
     implementation platform('software.amazon.awssdk:bom:2.20.0')
@@ -85,6 +98,31 @@ dependencies {
 
     // poi-excel
     implementation 'org.apache.poi:poi-ooxml:5.4.0'
+
+    implementation 'org.springframework.boot:spring-boot-starter-webflux'
+
+    runtimeOnly 'com.h2database:h2'
+
+    testImplementation 'org.springframework.boot:spring-boot-testcontainers:3.3.5'
+    testImplementation 'org.testcontainers:testcontainers:1.19.3'
+    testImplementation 'org.testcontainers:junit-jupiter:1.19.3'
+    testImplementation 'org.testcoscntainers:mysql:1.20.0'
+
+    annotationProcessor "org.springframework.boot:spring-boot-configuration-processor"
+
+    implementation 'org.apache.commons:commons-pool2:2.12.1'
+
+    //scheduler
+    implementation 'org.springframework.boot:spring-boot-starter-quartz'
+
+    //타임리프
+    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
+}
+
+configurations.configureEach {
+    resolutionStrategy {
+        force 'org.apache.commons:commons-lang3:3.18.0'
+    }
 }
 
 tasks.named('test') {