운영환경 배포 - V1.5.0

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,14 +1,25 @@
-## #️⃣연관된 이슈
-> close #
+## 🚀 Why - 해결하려는 문제가 무엇인가요?
 
-## 📝작업 내용
-> 작업한 내용을 작성해주세요.
+- `어떤 문제를 해결하고자 하나요?`
 
-## 🔎코드 설명
-> 코드에 대한 설명을 작성해주세요.
+- `어떤 배경이 있었나요?`
 
-## 💬고민사항 및 리뷰 요구사항
-> 고민사항 및 의견 받고 싶은 부분 있으면 적어두기
+## ✅ What - 무엇이 변경됐나요?
 
-## 비고 (Optional)
-> 참고했던 링크 등 참고 사항을 적어주세요. 코드 리뷰하는 사람이 참고해야 하는 내용을 자유로운 형식으로 적을 수 있습니다.
+- `구현한 기능 요약`
+
+- `주요 변경사항`
+
+## 🛠️ How - 어떻게 해결했나요?
+
+- `핵심 로직 설명`
+
+- `예외 사항, 고민 포인트 등`
+
+## 🖼️ Attachment
+
+- `화면 이미지, 결과 캡처 등 첨부`
+
+## 💬 기타 코멘트
+
+- `리뷰어에게 전하고 싶은 말, 테스트 방법, 주의할 점 등`

.github/workflows/ci-prd.yaml

@@ -13,7 +13,7 @@ jobs:
       SPRING_PROFILES_ACTIVE: test
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           submodules: recursive
           token: ${{ secrets.PAT }}
@@ -25,7 +25,7 @@ jobs:
           distribution: 'temurin'
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v3
+        uses: gradle/actions/setup-gradle@v5
 
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
@@ -34,46 +34,79 @@ jobs:
         run: ./gradlew clean build --info --stacktrace --no-daemon
 
       - name: Docker login
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_PASSWORD }}
 
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
       - name: Set image tag
         id: vars
         run: echo "IMAGE_TAG=${GITHUB_SHA::7}" >> $GITHUB_ENV
 
-      - name: Build Docker image
-        run: docker build -t ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }} -f deploy/Dockerfile .
-
-      - name: Docker Hub push
-        run: docker push ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }}
+      # Multi-architecture 빌드 및 푸시
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: deploy/Dockerfile
+          platforms: linux/amd64,linux/arm64  # 두 아키텍처 모두 빌드
+          push: true
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
 
       - name: Checkout manifest repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           repository: 'StartUpLight/STARLIGHT_MANIFEST'
           token: ${{ secrets.PAT }}
           path: 'manifest'
 
-      - name: Update deployment.yml
+      - name: Update deployment.yml and push manifest
         env:
           DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
           IMAGE_TAG: ${{ env.IMAGE_TAG }}
         run: |
-          sed -i "s|image:.*|image: ${DOCKERHUB_USERNAME}/startuplight-be:${IMAGE_TAG}|g" manifest/production/deployment.yml
-
-          # 변경사항 확인
-          echo "Updated deployment.yml:"
-          cat manifest/production/deployment.yml
+          update_manifest() {
+            local dir="$1"
+            local file="$dir/production/deployment.yml"
 
-      - name: Commit and push changes
-        env:
-          IMAGE_TAG: ${{ env.IMAGE_TAG }}
-        run: |
-          cd manifest
-          git config --local user.email "[email protected]"
-          git config --local user.name "SeongHo5356"
-          git add production/deployment.yml
-          git commit -m "Update image tag to $IMAGE_TAG" || exit 0
-          git push
+            sed -i "s|image:.*|image: ${DOCKERHUB_USERNAME}/startuplight-be:${IMAGE_TAG}|g" "$file"
+            echo "Updated $file:"
+            cat "$file"
+
+            git -C "$dir" config --local user.email "[email protected]"
+            git -C "$dir" config --local user.name "SeongHo5356"
+            git -C "$dir" add production/deployment.yml
+
+            if [ -z "$(git -C "$dir" status --porcelain)" ]; then
+              echo "No changes to commit in $dir"
+              return 0
+            fi
+
+            git -C "$dir" commit -m "Update image tag to $IMAGE_TAG"
+
+            for i in {1..3}; do
+              echo "Push attempt $i for $dir"
+              git -C "$dir" pull --rebase origin main && \
+              git -C "$dir" push && \
+              echo "Successfully pushed $dir" && \
+              break || {
+                echo "Push failed for $dir, retrying in 2 seconds..."
+                sleep 2
+              }
+            done
+
+            if ! git -C "$dir" diff --quiet origin/main HEAD; then
+              echo "ERROR: Failed to push $dir after 3 attempts"
+              return 1
+            fi
+          }
+
+          update_manifest manifest

.github/workflows/ci-stg.yaml

@@ -13,7 +13,7 @@ jobs:
       SPRING_PROFILES_ACTIVE: test
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           submodules: recursive
           token: ${{ secrets.PAT }}
@@ -25,7 +25,7 @@ jobs:
           distribution: 'temurin'
 
       - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v3
+        uses: gradle/actions/setup-gradle@v5
 
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
@@ -34,46 +34,87 @@ jobs:
         run: ./gradlew clean build --info --stacktrace --no-daemon
 
       - name: Docker login
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_PASSWORD }}
 
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
       - name: Set image tag
         id: vars
         run: echo "IMAGE_TAG=${GITHUB_SHA::7}" >> $GITHUB_ENV
 
-      - name: Build Docker image
-        run: docker build -t ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }} -f deploy/Dockerfile .
-
-      - name: Docker Hub push
-        run: docker push ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }}
+      # Multi-architecture 빌드 및 푸시
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: deploy/Dockerfile
+          platforms: linux/amd64,linux/arm64  # 두 아키텍처 모두 빌드
+          push: true
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/startuplight-be:${{ env.IMAGE_TAG }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
 
       - name: Checkout manifest repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           repository: 'StartUpLight/STARLIGHT_MANIFEST'
           token: ${{ secrets.PAT }}
           path: 'manifest'
 
-      - name: Update deployment.yml
+      - name: Checkout manifest repository (oracle)
+        uses: actions/checkout@v6
+        with:
+          repository: 'StartUpLight/STARLIGHT_MANIFEST_ORACLE'
+          token: ${{ secrets.PAT }}
+          path: 'manifest-oracle'
+
+      - name: Update deployment.yml and push manifests
         env:
           DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
           IMAGE_TAG: ${{ env.IMAGE_TAG }}
         run: |
-          sed -i "s|image:.*|image: ${DOCKERHUB_USERNAME}/startuplight-be:${IMAGE_TAG}|g" manifest/staging/deployment.yml
-
-          # 변경사항 확인
-          echo "Updated deployment.yml:"
-          cat manifest/staging/deployment.yml
+          update_manifest() {
+            local dir="$1"
+            local file="$dir/staging/deployment.yml"
 
-      - name: Commit and push changes
-        env:
-          IMAGE_TAG: ${{ env.IMAGE_TAG }}
-        run: |
-          cd manifest
-          git config --local user.email "[email protected]"
-          git config --local user.name "SeongHo5356"
-          git add staging/deployment.yml
-          git commit -m "Update image tag to $IMAGE_TAG" || exit 0
-          git push
+            sed -i "s|image:.*|image: ${DOCKERHUB_USERNAME}/startuplight-be:${IMAGE_TAG}|g" "$file"
+            echo "Updated $file:"
+            cat "$file"
+
+            git -C "$dir" config --local user.email "[email protected]"
+            git -C "$dir" config --local user.name "SeongHo5356"
+            git -C "$dir" add staging/deployment.yml
+
+            if [ -z "$(git -C "$dir" status --porcelain)" ]; then
+              echo "No changes to commit in $dir"
+              return 0
+            fi
+
+            git -C "$dir" commit -m "Update image tag to $IMAGE_TAG"
+
+            for i in {1..3}; do
+              echo "Push attempt $i for $dir"
+              git -C "$dir" pull --rebase origin main && \
+              git -C "$dir" push && \
+              echo "Successfully pushed $dir" && \
+              break || {
+                echo "Push failed for $dir, retrying in 2 seconds..."
+                sleep 2
+              }
+            done
+
+            if ! git -C "$dir" diff --quiet origin/main HEAD; then
+              echo "ERROR: Failed to push $dir after 3 attempts"
+              return 1
+            fi
+          }
+
+          update_manifest manifest
+          update_manifest manifest-oracle

.gitignore

@@ -45,3 +45,5 @@ out/
 node_modules/
 dist/
 *.log
+/docs/
+/AGENTS.md

README.md

@@ -16,8 +16,8 @@
 | Category             | Technology                                                                 |
 |----------------------|---------------------------------------------------------------------------|
 | **Language**         | Java 21                                                                 |
-| **Framework**        | Spring Boot 3.3.10                                                        |
-| **Databases**        | Postgresql, Redis                                                             |
+| **Framework**        | Spring Boot 3.4.10                                                      |
+| **Databases**        | MySQL, Redis                                                             |
 | **Authentication**   | JWT, Spring Security, OAuth2.0                                           |
 | **Development Tools**| Lombok                                                   |
 | **API Documentation**| Swagger UI (SpringDoc)                                                   |
@@ -120,49 +120,3 @@ https://www.erdcloud.com/d/bEeEkcvDoau3kf7W5
 - `컨벤션명/#이슈번호-작업내용`
 - pull request를 통해 develop branch에 merge 후, branch delete
 - 부득이하게 develop branch에 직접 commit 해야 할 경우, `!hotfix:` 사용
-
-<br></br>
-
-## 📁 Directory
-
-```PlainText
-src/
-├── main/
-│   ├── domain/
-│   │   ├── entity/
-│   │   ├── controller/
-│   │   ├── service/
-│   │   ├── repository/
-│   │   └── dto/
-            ├── request/
-            └── response/
-│   ├── global/
-│   │   ├── apiPayload/
-│   │   ├── config/
-│   │   ├── security/
-
-```
-
-<br></br>
-
-## 📈  부하테스트
-각 플랫폼(Instagram, Facebook, Threads) API에는 계정/시간 당 발행 가능한 게시물 수에 제한이 있어, 부하 테스트에는 제약이 존재합니다. 이에 따라 저희는 즉시 발행이 아닌 **"예약 발행" API**를 활용한 부하 시뮬레이션 방식을 구성하였습니다.
-
-|시나리오 ① 10명이 1초 동안 최대한의 요청을 보낸다.| 시나리오 ② 2000명이 1초 동안 최대한의 요청을 보낸다.|
-| :-------| :-------|
-|![image](https://github.com/user-attachments/assets/026eb04b-4aa3-4e23-8820-5d22f1d94d12)|![image](https://github.com/user-attachments/assets/b73b7838-48e6-4392-99cd-c6497a4958d1)|
-|✅ 총 120개의 요청이 문제없이 처리됨 <br>  - 평균 요청 처리 시간 : 82.09 ms <br>  - 최소 요청 처리 시간 : 22.52ms <br>  - 최대 요청 처리 시간 : 164.64ms |✅ 총 4002개의 요청이 문제없이 처리됨<br> - 평균 요청 처리 시간 : 7.74s <br>  - 최소 요청 처리 시간 : 21.9s <br>  - 최대 요청 처리 시간 : 18.28s <br> - 95th 퍼센타일 : 14.95s|
-
-<br>
-
-| 시나리오 ③ 사용자 수 변동 시나리오 | 시나리오 ④ 응답 시간이 5초 이내인 최대 요청 수 파악|
-| :-------|:----|
-|![image](https://github.com/user-attachments/assets/c77e54f8-765f-4ef5-a79b-f8896eb761a7)|![image](https://github.com/user-attachments/assets/a856af66-9d1b-47df-b287-156c125bd9b3)|
-|0초 ~ 2초 : `50명`, 2초 ~ 12초 : `300명`, 12초 ~ 17초 : `1000명`, 17초 ~ 18초 : `500명`| 5초가 지날 경우 사용자 이탈이 늘어날 것이라고 판단하여 1초 동안 `1000명`의 사용자가 요청을 보내 `요청 처리 시간이 5초 이내`인 요청 개수를 파악 |
-|✅ 총 3789개의 요청이 문제없이 처리됨 <br>  - 평균 요청 처리 시간 : 1.94s <br>  - 최소 요청 처리 시간 : 20.53ms <br>  - 최대 요청 처리 시간 : 7.88s |✅ 총 2002개의 요청이 시간 내 처리됨 |
-
-### 테스트 결과 분석
-- 현재 시스템은 동시 약 `1,000건` 수준까지는 안정적으로 요청을 처리할 수 있는 것으로 보입니다. **시나리오 ③**처럼 사용자 수가 점차 증가하는 상황에서도 평균 응답 시간은 `1.94초`, 최대 응답 시간은 `7.88초`로, 대부분의 요청이 정상적으로 처리되었습니다.
-- 하지만 **시나리오 ②**처럼 `2,000명`의 동시 요청이 들어오면 평균 응답 시간이 `7.74초`, 최대 `18.28초`까지 증가하면서 응답 지연이 발생하였습니다. 이 결과는 대규모 트래픽에 대한 성능 한계가 있음을 보여주며, 추후 이를 개선할 필요가 있습니다.
-- **시나리오 ④**에서는 `1000명`의 사용자가 동시에 요청을 보낸 경우, 총 `2,002건`의 요청이 `5초` 이내에 처리되었습니다. 이는 현재 시스템이 실시간 대응보다는 예약 처리에 더 적합한 구조임을 보여줍니다.
-- 일반적으로 사용자 이탈이 늘기 시작하는 5초 이내 응답을 기준으로 예상 접속자 수 약 `1,000명` 정도에 대해서는 충분히 안정적인 성능을 제공할 수 있다고 판단됩니다.

src/main/java/starlight/StarlightApplication.java

@@ -2,7 +2,6 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.autoconfigure.domain.EntityScan;
 import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
 @EnableJpaAuditing