v1.1.0

.github/actions/deploy-module/action.yml

@@ -0,0 +1,177 @@
+name: 'Deploy Module'
+description: 'Build, push and deploy a module to server (dev/prod)'
+
+inputs:
+  environment:
+    description: 'Environment (dev or prod)'
+    required: true
+  module:
+    description: 'Module name (apis, admin, batch)'
+    required: true
+  port:
+    description: 'Server port (for logging only - actual port defined in docker-compose.yml)'
+    required: false
+    default: 'N/A'
+  dockerhub-username:
+    description: 'Docker Hub username'
+    required: true
+  dockerhub-token:
+    description: 'Docker Hub token'
+    required: true
+  secret-properties:
+    description: 'Secret properties (dev or prod)'
+    required: true
+  apple-auth-key:
+    description: 'Apple Auth Key'
+    required: true
+  host:
+    description: 'Server host'
+    required: true
+  username:
+    description: 'Server username'
+    required: true
+  ssh-key:
+    description: 'Server SSH key'
+    required: true
+  ssh-port:
+    description: 'Server SSH port'
+    required: true
+  discord-webhook-url:
+    description: 'Discord webhook URL'
+    required: true
+  image-prefix:
+    description: 'Docker image prefix'
+    required: true
+  image-tag-type:
+    description: 'Image tag type (development-latest or semver)'
+    required: true
+  deploy-script:
+    description: 'Deploy script name (deploy-dev.sh or deploy-prod.sh)'
+    required: true
+    default: 'deploy-dev.sh'
+  release-version:
+    description: 'Release version tag (e.g., v1.2.3). Only used in production for metadata tracking.'
+    required: false
+    default: 'unknown'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Inject application-secret.properties from Secrets
+      shell: bash
+      run: |
+        mkdir -p ./secret
+        echo "$SECRET_CONTENT" > ./secret/application-${{ inputs.environment }}-secret.properties
+        echo "$APPLE_KEY_CONTENT" > ./secret/AuthKey.p8
+        chmod 600 ./secret/*
+      env:
+        SECRET_CONTENT: ${{ inputs.secret-properties }}
+        APPLE_KEY_CONTENT: ${{ inputs.apple-auth-key }}
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Log in to Docker Hub
+      uses: docker/login-action@v3
+      with:
+        username: ${{ inputs.dockerhub-username }}
+        password: ${{ inputs.dockerhub-token }}
+
+    - name: Extract metadata for Docker
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: docker.io/${{ inputs.image-prefix }}-${{ inputs.module }}
+        tags: ${{ inputs.image-tag-type }}
+
+    - name: Build and push Docker image
+      id: build-and-push
+      uses: docker/build-push-action@v6
+      with:
+        context: .
+        file: ./Dockerfile
+        platforms: linux/amd64
+        push: true
+        tags: ${{ steps.meta.outputs.tags }}
+        cache-from: type=gha,scope=${{ inputs.module }}
+        cache-to: type=gha,mode=max,scope=${{ inputs.module }}
+        build-args: |
+          MODULE=${{ inputs.module }}
+
+    - name: Deploy to Server
+      uses: appleboy/ssh-action@v1.2.2
+      with:
+        host: ${{ inputs.host }}
+        username: ${{ inputs.username }}
+        key: ${{ inputs.ssh-key }}
+        port: ${{ inputs.ssh-port }}
+        script: |
+          export DOCKERHUB_USERNAME="${{ inputs.dockerhub-username }}"
+          export DOCKERHUB_TOKEN="${{ inputs.dockerhub-token }}"
+          export MODULE="${{ inputs.module }}"
+          export SPRING_PROFILE="${{ inputs.environment }}"
+          export IMAGE_TAG="$(echo "${{ steps.meta.outputs.tags }}" | head -n1)"
+          export RELEASE_VERSION="${{ inputs.release-version }}"
+          cd ~/deploy
+          chmod +x ./${{ inputs.deploy-script }}
+          ./${{ inputs.deploy-script }}
+
+    - name: Send Discord notification on success (Development)
+      uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
+      if: success() && inputs.environment == 'dev'
+      continue-on-error: true
+      with:
+        webhook-url: ${{ inputs.discord-webhook-url }}
+        embed-title: "✅ [${{ github.repository }}] Development Deploy Succeeded - ${{ inputs.module }}"
+        embed-description: |
+          **Module**: `${{ inputs.module }}`
+          **Commit**: `${{ github.sha }}`
+          **Author**: `${{ github.actor }}`
+          **Message**: `${{ github.event.head_commit.message }}`
+          [View Committed Changes](https://github.com/${{ github.repository }}/commit/${{ github.sha }})
+        embed-color: 65280
+
+    - name: Send Discord notification on success (Production)
+      uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
+      if: success() && inputs.environment == 'prod'
+      continue-on-error: true
+      with:
+        webhook-url: ${{ inputs.discord-webhook-url }}
+        content: "🚀 **Production Deploy Succeeded!**"
+        embed-title: "✅ [${{ github.repository }}] Production Deploy Succeeded - ${{ inputs.module }}"
+        embed-description: |
+          **Module**: `${{ inputs.module }}`
+          **Deployed by**: `${{ github.actor }}`
+          The new version has been successfully deployed to production.
+          [View Workflow](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
+        embed-color: 65280
+
+    - name: Send Discord notification on failure (Development)
+      uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
+      if: failure() && inputs.environment == 'dev'
+      continue-on-error: true
+      with:
+        webhook-url: ${{ inputs.discord-webhook-url }}
+        embed-title: "❌ [${{ github.repository }}] Development Deploy Failed - ${{ inputs.module }}"
+        embed-description: |
+          **Module**: `${{ inputs.module }}`
+          **Commit**: `${{ github.sha }}`
+          **Author**: `${{ github.actor }}`
+          An error occurred during the workflow execution.
+          [View Failed Workflow](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
+        embed-color: 16711680
+
+    - name: Send Discord notification on failure (Production)
+      uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
+      if: failure() && inputs.environment == 'prod'
+      continue-on-error: true
+      with:
+        webhook-url: ${{ inputs.discord-webhook-url }}
+        content: "🚨 **Production Deploy Failed!**"
+        embed-title: "❌ [${{ github.repository }}] Production Deploy Failed - ${{ inputs.module }}"
+        embed-description: |
+          **Module**: `${{ inputs.module }}`
+          **Deployed by**: `${{ github.actor }}`
+          An error occurred during the production deployment workflow.
+          [View Failed Workflow](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
+        embed-color: 16711680

.github/workflows/ci-pr.yml

@@ -58,4 +58,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.PAT_TOKEN }}
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-        run: ./gradlew fullCheck --parallel --build-cache --info --stacktrace
+        run: |
+          # fullCheck: 모든 모듈 (apis, admin, batch, gateway 등)의 빌드, 테스트, 정적분석 수행
+          # --parallel: 모듈별 병렬 빌드로 시간 단축
+          # --build-cache: Gradle 빌드 캐시 사용
+          ./gradlew fullCheck --parallel --build-cache --info --stacktrace

.github/workflows/close-jira-issue.yml

@@ -29,4 +29,4 @@ jobs:
         uses: atlassian/gajira-transition@v3
         with:
           issue: ${{ env.JIRA_KEY }}
-          transition: "31"
+          transition: 개발 완료

.github/workflows/create-jira-issue.yml

@@ -85,7 +85,7 @@ jobs:
         uses: atlassian/gajira-create@v3
         with:
           project: BOOK
-          issuetype: Task
+          issuetype: 하위 작업
           summary: '${{ github.event.issue.title }}'
           description: '${{ steps.md2jira.outputs.output-text }}'
           fields: |

.github/workflows/dev-ci-cd.yml

@@ -11,96 +11,93 @@ concurrency:
 
 env:
   REGISTRY: docker.io
-  IMAGE_NAME: ninecraft0523/ninecraft-server
-  MODULE: apis
+  IMAGE_PREFIX: ninecraft0523/ninecraft
 
 jobs:
-  build-push-and-deploy:
+  detect-changes:
     runs-on: ubuntu-24.04
-    timeout-minutes: 20
-    environment: development
-
+    outputs:
+      apis: ${{ steps.filter.outputs.apis }}
+      # admin: ${{ steps.filter.outputs.admin }}  # TODO: Uncomment when admin module is ready
+      batch: ${{ steps.filter.outputs.batch }}
+      any: ${{ steps.filter.outputs.any }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Inject application-secret.properties from Secrets
-        run: |
-          mkdir ./secret
-          echo "${{ secrets.DEV_SECRET_PROPERTIES }}" > ./secret/application-dev-secret.properties
-          echo "${{ secrets.APPLE_AUTH_KEY }}" > ./secret/AuthKey.p8
-          chmod 600 ./secret/*
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
+      - name: Check changed files
+        uses: dorny/paths-filter@v3
+        id: filter
         with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
+          filters: |
+            apis:
+              - 'apis/**'
+              - 'domain/**'
+              - 'infra/**'
+              - 'global-utils/**'
+              - 'observability/**'
+              - '.github/**'
+            # admin:  # TODO: Uncomment when admin module is ready
+            #   - 'admin/**'
+            #   - 'domain/**'
+            #   - 'infra/**'
+            #   - 'global-utils/**'
+            #   - 'observability/**'
+            #   - '.github/**'
+            batch:
+              - 'batch/**'
+              - 'domain/**'
+              - 'infra/**'
+              - 'global-utils/**'
+              - 'observability/**'
+              - '.github/**'
+            any:
+              - 'apis/**'
+              # - 'admin/**'  # TODO: Uncomment when admin module is ready
+              - 'batch/**'
+              - 'domain/**'
+              - 'infra/**'
+              - 'global-utils/**'
+              - 'observability/**'
+              - '.github/**'
 
-      - name: Extract metadata for Docker
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-          tags: |
-            type=raw,value=development-latest
+  build-push-and-deploy:
+    needs: detect-changes
+    if: needs.detect-changes.outputs.any == 'true'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    environment: development
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - module: apis
+            changed: ${{ needs.detect-changes.outputs.apis }}
+          # - module: admin  # TODO: Uncomment when admin module is ready
+          #   changed: ${{ needs.detect-changes.outputs.admin }}
+          - module: batch
+            changed: ${{ needs.detect-changes.outputs.batch }}
 
-      - name: Build and push Docker image
-        id: build-and-push
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: ./Dockerfile
-          platforms: linux/amd64
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-          build-args: |
-            MODULE=${{ env.MODULE }}
+    steps:
+      - name: Checkout code
+        if: matrix.changed == 'true'
+        uses: actions/checkout@v4
 
-      - name: Deploy to Development Server
-        uses: appleboy/ssh-action@v1.2.2
+      - name: Deploy module
+        if: matrix.changed == 'true'
+        uses: ./.github/actions/deploy-module
         with:
+          environment: dev
+          module: ${{ matrix.module }}
+          dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
+          dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
+          secret-properties: ${{ secrets.DEV_SECRET_PROPERTIES }}
+          apple-auth-key: ${{ secrets.APPLE_AUTH_KEY }}
           host: ${{ secrets.DEV_HOST }}
           username: ${{ secrets.DEV_USERNAME }}
-          key: ${{ secrets.DEV_SSH_KEY }}
-          port: ${{ secrets.DEV_PORT }}
-          script: |
-            export DOCKERHUB_USERNAME="${{ secrets.DOCKERHUB_USERNAME }}"
-            export DOCKERHUB_TOKEN="${{ secrets.DOCKERHUB_TOKEN }}"
-            export IMAGE_TAG="$(echo "${{ steps.meta.outputs.tags }}" | head -n1)"
-            cd ~/deploy
-            chmod +x ./deploy.sh
-            ./deploy.sh
-
-      - name: Send Discord notification on success
-        uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
-        if: success()
-        continue-on-error: true
-        with:
-          webhook-url: ${{ secrets.DEV_DEPLOY_DISCORD_WEBHOOK_URL }}
-          embed-title: "✅ [${{ github.repository }}] Development Deploy Succeeded"
-          embed-description: |
-            **Commit**: `${{ github.sha }}`
-            **Author**: `${{ github.actor }}`
-            **Message**: `${{ github.event.head_commit.message }}`
-            [View Committed Changes](https://github.com/${{ github.repository }}/commit/${{ github.sha }})
-          embed-color: 65280
-
-      - name: Send Discord notification on failure
-        uses: tsickert/discord-webhook@b217a69502f52803de774ded2b1ab7c282e99645
-        if: failure()
-        continue-on-error: true
-        with:
-          webhook-url: ${{ secrets.DEV_DEPLOY_DISCORD_WEBHOOK_URL }}
-          embed-title: "❌ [${{ github.repository }}] Development Deploy Failed"
-          embed-description: |
-            **Commit**: `${{ github.sha }}`
-            **Author**: `${{ github.actor }}`
-            An error occurred during the workflow execution.
-            [View Failed Workflow](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
-          embed-color: 16711680
+          ssh-key: ${{ secrets.DEV_SSH_KEY }}
+          ssh-port: ${{ secrets.DEV_PORT }}
+          discord-webhook-url: ${{ secrets.DEV_DEPLOY_DISCORD_WEBHOOK_URL }}
+          image-prefix: ${{ env.IMAGE_PREFIX }}
+          image-tag-type: type=raw,value=development-latest
+          deploy-script: deploy-dev.sh