project-auto-wizard 0.12.0 → 0.12.1

package/payload/workflows/spring/{nexus/PROJECT-SPRING-NEXUS-CI.yml → PROJECT-SPRING-CI.yml}

@@ -1,14 +1,7 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
-# Spring Nexus CI 워크플로우
-# ===================================================================
-#
-# 🔑 필수 GitHub Secrets
-# ===================================================================
-# GRADLE_PROPERTIES: gradle.properties 파일 내용 (Nexus 인증 정보 포함)
-# ===================================================================
+# Spring CI 워크플로우
 
-name: PROJECT-SPRING-NEXUS-CI
+name: PROJECT-SPRING-CI
 
 on:
   pull_request:
@@ -30,9 +23,7 @@ env:
   PROJECT_PATH: "."  # @wizard auto:project-path
 
 jobs:
-  # ===================================================================
   # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
-  # ===================================================================
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -76,10 +67,6 @@ jobs:
       uses: gradle/wrapper-validation-action@v2
       continue-on-error: true
 
-    - name: Create gradle.properties from secret
-      run: |
-        echo -e "${{ secrets.GRADLE_PROPERTIES }}" > gradle.properties
-
     - name: Setup Gradle
       uses: gradle/actions/setup-gradle@v4
       with:
@@ -119,30 +106,25 @@ jobs:
       id: report
       if: always()
       run: |
-        # 빌드 상태 확인 (exit code 기반)
         COMPILE_STATUS="✅ 성공"
         TEST_STATUS="✅ 성공"
         BUILD_STATUS="✅ 성공"
         
-        # 컴파일 상태 확인
         COMPILE_EXIT_CODE="${{ steps.compile.outputs.compile_exit_code }}"
         if [ "$COMPILE_EXIT_CODE" != "0" ] && [ "$COMPILE_EXIT_CODE" != "" ]; then
           COMPILE_STATUS="❌ 실패"
         fi
         
-        # 테스트 상태 확인  
         TEST_EXIT_CODE="${{ steps.test.outputs.test_exit_code }}"
         if [ "$TEST_EXIT_CODE" != "0" ] && [ "$TEST_EXIT_CODE" != "" ]; then
           TEST_STATUS="❌ 실패"
         fi
         
-        # 빌드 상태 확인
         BUILD_EXIT_CODE="${{ steps.build.outputs.build_exit_code }}"
         if [ "$BUILD_EXIT_CODE" != "0" ] && [ "$BUILD_EXIT_CODE" != "" ]; then
           BUILD_STATUS="❌ 실패"
         fi
         
-        # 전체 빌드 상태
         OVERALL_STATUS="✅ 성공"
         if [ "$COMPILE_EXIT_CODE" != "0" ] || [ "$TEST_EXIT_CODE" != "0" ] || [ "$BUILD_EXIT_CODE" != "0" ]; then
           OVERALL_STATUS="❌ 실패"
@@ -157,7 +139,6 @@ jobs:
       id: errors
       if: always()
       run: |
-        # 컴파일 에러 추출
         if [ -f compile_output.txt ] && [ "${{ steps.compile.outputs.compile_exit_code }}" != "0" ]; then
           echo "compile_errors<<EOF" >> $GITHUB_OUTPUT
           echo "## 🚨 컴파일 에러" >> $GITHUB_OUTPUT
@@ -168,7 +149,6 @@ jobs:
           echo "EOF" >> $GITHUB_OUTPUT
         fi
         
-        # 테스트 에러 추출
         if [ -f test_output.txt ] && [ "${{ steps.test.outputs.test_exit_code }}" != "0" ]; then
           echo "test_errors<<EOF" >> $GITHUB_OUTPUT
           echo "## 🧪 테스트 실패" >> $GITHUB_OUTPUT
@@ -179,7 +159,6 @@ jobs:
           echo "EOF" >> $GITHUB_OUTPUT
         fi
         
-        # 빌드 에러 추출
         if [ -f build_output.txt ] && [ "${{ steps.build.outputs.build_exit_code }}" != "0" ]; then
           echo "build_errors<<EOF" >> $GITHUB_OUTPUT
           echo "## 📦 빌드 에러" >> $GITHUB_OUTPUT
@@ -347,9 +326,7 @@ jobs:
         echo "❌ 빌드가 실패했습니다. 위의 에러 메시지를 확인해주세요."
         exit 1
 
-  # ===================================================================
   # CI Gate (required check로 등록할 단일 job)
-  # ===================================================================
   ci-gate:
     name: CI Gate
     if: ${{ always() }}

package/payload/workflows/spring/server-deploy/PROJECT-SPRING-NONSTOP-NGINX-CICD.yaml

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Spring Boot 무중단 배포 (Nginx Blue-Green, SSH + Docker)
-# ===================================================================
 #
 # deploy 브랜치 푸시 시 Docker 이미지를 빌드하고
 # nginx config 의 proxy_pass 포트 토글로 Blue-Green 무중단 배포합니다.
@@ -10,9 +8,7 @@
 # 기본 배포는 PROJECT-SPRING-SIMPLE-CICD.yaml 입니다.
 # 전환하려면 아래 push.branches 주석 해제 + SIMPLE-CICD 의 push 트리거 주석 처리.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 # APPLICATION_PROD_YML (선택): application-prod.yml 내용
 # DOCKERHUB_USERNAME: DockerHub 사용자명
 # DOCKERHUB_TOKEN: DockerHub 액세스 토큰
@@ -20,34 +16,32 @@
 # SERVER_USER: SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
 #
-# 🔧 환경변수 설정 (env 섹션에서 설정)
-# ===================================================================
+# 환경변수 설정 (env 섹션에서 설정)
 #
-# 🌐 포트 및 컨테이너:
+# 포트 및 컨테이너:
 # PROJECT_NAME: 프로젝트명 (컨테이너/이미지 이름)
 # SERVICE_DOMAIN: 외부 도메인 (nginx server_name 과 일치)
 # CONTAINER_INTERNAL_PORT: Spring Boot 내부 포트 (기본: 8080)
 # BLUE_PORT: Blue 호스트 노출 포트 (기본: 8080)
 # GREEN_PORT: Green 호스트 노출 포트 (기본: 8081)
 #
-# 🔧 Nginx:
+# Nginx:
 # NGINX_RP_CONF: nginx 역방향 프록시 config 파일 경로
 # NGINX_BACKUP_DIR: nginx config 백업 디렉토리
 # NGINX_BACKUP_KEEP: 백업 보존 개수 (기본: 10)
 #
-# 📦 볼륨/스토리지:
+# 볼륨/스토리지:
 # ENABLE_VOLUME_MOUNT: 볼륨 마운트 여부 (true/false)
 # VOLUME_HOST_PATH: 호스트 볼륨 경로
 # VOLUME_CONTAINER_PATH: 컨테이너 내부 마운트 경로
 #
-# 🔌 SSH 연결:
+# SSH 연결:
 # SSH_PORT: SSH 포트 (기본: 2022)
 # SSH_COMMAND_TIMEOUT: 명령 타임아웃 (기본: 600s)
 # SSH_CONNECTION_TIMEOUT: 연결 타임아웃 (기본: 60s)
 #
-# ⏱️ 헬스체크:
+# 헬스체크:
 # HEALTHCHECK_PATH: HTTP 경로 (기본: /actuator/health, fallback: /)
 # HEALTHCHECK_MAX_RETRIES: 컨테이너 헬스체크 최대 횟수 (기본: 120)
 # HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 초 (기본: 1)
@@ -55,19 +49,16 @@
 # DOMAIN_CHECK_INTERVAL: 도메인 검증 간격 초 (기본: 2)
 # IN_FLIGHT_WAIT: old 컨테이너 제거 전 대기 초 (기본: 5)
 #
-# 💡 사전 조건:
+# 사전 조건:
 #   - 서버에 nginx 설치 + sites-enabled config 존재
 #   - 해당 config 의 server 블록에 다음 라인 존재:
 #       server_name ${SERVICE_DOMAIN};
 #       proxy_pass http://127.0.0.1:${BLUE_PORT};   # 또는 ${GREEN_PORT}
 #   - SSH 사용자가 sudo 로 nginx -t / reload, docker 명령 실행 가능
-# ===================================================================
 
 name: PROJECT-SPRING-NONSTOP-NGINX-CICD
 
-# ===================================================================
 # 트리거 설정
-# ===================================================================
 # deploy 브랜치 push 자동 트리거는 주석 처리되어 있습니다.
 # 본 워크플로우로 전환하려면 아래 push.branches 주석을 해제하세요.
 on:
@@ -76,51 +67,48 @@ on:
   #     - {{MAIN_BRANCH}}
   workflow_dispatch:
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
-  # 🔧 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
+  # 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   SERVICE_DOMAIN: "__SERVICE_DOMAIN__"  # @wizard ask:example.com
 
-  # ☁️ Spring Boot 설정
+  # Spring Boot 설정
   SPRING_PROFILE: "prod"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:@jdk
   GRADLE_OPTS: "-Dspring.profiles.active=prod"
 
-  # 📁 경로 설정
+  # 경로 설정
   APPLICATION_YML_DIR: "__APPLICATION_YML_DIR__"  # @wizard auto:spring-app-yml-dir
   DOCKERFILE_PATH: "./Dockerfile"
 
-  # 🌐 포트 및 컨테이너 설정
+  # 포트 및 컨테이너 설정
   # BLUE/GREEN은 서버에서 번갈아 뜨는 두 컨테이너의 호스트 포트다 — 다른 서비스와 겹치면 배포가 실패한다.
   CONTAINER_INTERNAL_PORT: "8080"
   BLUE_PORT: "__BLUE_PORT__"  # @wizard ask:8080
   GREEN_PORT: "__GREEN_PORT__"  # @wizard ask:8081
 
-  # 🔧 Nginx 설정
+  # Nginx 설정
   # NGINX_RP_CONF 경로가 틀리면 무중단 전환(proxy_pass 포트 토글) 자체가 동작하지 않는다.
   NGINX_RP_CONF: "__NGINX_RP_CONF__"  # @wizard ask:/etc/nginx/sites-enabled/__PROJECT_NAME__.conf
   NGINX_BACKUP_DIR: "__NGINX_BACKUP_DIR__"  # @wizard ask:/volume1/projects/nginx/backups
   NGINX_BACKUP_KEEP: "10"
 
-  # 📦 볼륨 마운트 설정
+  # 볼륨 마운트 설정
   ENABLE_VOLUME_MOUNT: "false"  # @wizard ask:false
   VOLUME_HOST_PATH: "/volume1/projects/__PROJECT_NAME__"  # @wizard ask:/volume1/projects/__PROJECT_NAME__
   VOLUME_CONTAINER_PATH: "/app"  # @wizard ask:/app
 
-  # 🔐 SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
+  # SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
   #   password → SERVER_PASSWORD secret 사용
   #   key      → SSH_KEY secret 사용 (.pem 파일 전체 내용을 secret 값으로)
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
-  # 🔌 SSH 연결 설정
+  # SSH 연결 설정
   SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
   SSH_COMMAND_TIMEOUT: "600s"
   SSH_CONNECTION_TIMEOUT: "60s"
 
-  # ⏱️ 헬스체크 설정
+  # 헬스체크 설정
   HEALTHCHECK_PATH: "/actuator/health"
   HEALTHCHECK_MAX_RETRIES: "120"
   HEALTHCHECK_RETRY_INTERVAL: "1"
@@ -129,9 +117,7 @@ env:
   IN_FLIGHT_WAIT: "5"
 
 jobs:
-  # ===================================================================
   # 빌드 작업
-  # ===================================================================
   build:
     name: Spring Boot 애플리케이션 빌드
     runs-on: ubuntu-latest
@@ -193,9 +179,7 @@ jobs:
           rm -rf /tmp/.buildx-cache
           mv /tmp/.buildx-cache-new /tmp/.buildx-cache
 
-  # ===================================================================
   # 배포 작업 (Blue-Green 무중단)
-  # ===================================================================
   deploy:
     name: Blue-Green 무중단 배포
     needs: build
@@ -241,7 +225,7 @@ jobs:
             export PATH=$PATH:/usr/local/bin
             export PW="${SERVER_PASSWORD}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -264,15 +248,11 @@ jobs:
             echo "🔧 Nginx config: ${NGINX_RP_CONF}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # ============================================================
             # 1. 최신 이미지 Pull
-            # ============================================================
             echo "📥 이미지 Pull: ${IMAGE}"
             SUDO docker pull "${IMAGE}"
 
-            # ============================================================
             # 2. nginx 설정 백업
-            # ============================================================
             echo "📁 nginx 백업 디렉토리 생성: ${NGINX_BACKUP_DIR}"
             SUDO mkdir -p "${NGINX_BACKUP_DIR}"
 
@@ -280,9 +260,7 @@ jobs:
             echo "💾 nginx config 백업: ${BACKUP_FILE}"
             SUDO cp "${NGINX_RP_CONF}" "${BACKUP_FILE}"
 
-            # ============================================================
             # 3. 현재 활성 포트 판별 (nginx config proxy_pass 파싱)
-            # ============================================================
             echo "🔍 nginx config 의 현재 활성 포트 탐색"
             ACTIVE_PORT=$(
               SUDO awk -v dom="${SERVICE_DOMAIN}" '
@@ -335,17 +313,13 @@ jobs:
             echo "🐳 신규 배포 → 포트=${NEW_PORT} 컨테이너=${NEW_CONTAINER_NAME}"
             echo "🗑️ 이전 컨테이너 (제거 예정) = ${OLD_CONTAINER_NAME}"
 
-            # ============================================================
             # 4. 동일 슬롯(idle 쪽) 잔존 컨테이너 정리
-            # ============================================================
             if SUDO docker ps -a --format '{{.Names}}' | grep -Eq "^${NEW_CONTAINER_NAME}\$"; then
               echo "🗑️ idle 슬롯 정리: ${NEW_CONTAINER_NAME}"
               SUDO docker rm -f "${NEW_CONTAINER_NAME}"
             fi
 
-            # ============================================================
             # 5. 볼륨 마운트 옵션 구성
-            # ============================================================
             VOLUME_MOUNT_OPTION="-v /etc/localtime:/etc/localtime:ro"
             if [ "${ENABLE_VOLUME_MOUNT}" = "true" ]; then
               if [ ! -d "${VOLUME_HOST_PATH}" ]; then
@@ -358,9 +332,7 @@ jobs:
               echo "ℹ️ 볼륨 마운트 비활성화됨"
             fi
 
-            # ============================================================
             # 6. 새 컨테이너 기동
-            # ============================================================
             echo "🐳 새 컨테이너 기동: ${NEW_CONTAINER_NAME} (포트 ${NEW_PORT})"
             SUDO docker run -d \
               -p ${NEW_PORT}:${CONTAINER_INTERNAL_PORT} \
@@ -370,9 +342,7 @@ jobs:
               ${VOLUME_MOUNT_OPTION} \
               "${IMAGE}"
 
-            # ============================================================
             # 7. 컨테이너 헬스체크 (로컬 포트 직접 호출)
-            # ============================================================
             echo "⏳ 헬스체크 시작 (최대 ${HEALTHCHECK_MAX_RETRIES}회 × ${HEALTHCHECK_RETRY_INTERVAL}초)"
             HEALTHCHECK_SUCCESS=false
             for i in $(seq 1 ${HEALTHCHECK_MAX_RETRIES}); do
@@ -394,9 +364,7 @@ jobs:
               exit 1
             fi
 
-            # ============================================================
             # 8. nginx config 포트 토글 (proxy_pass 포트 치환)
-            # ============================================================
             echo "🔧 nginx config 포트 토글: ${ACTIVE_PORT} → ${NEW_PORT}"
             TMP_FILE="$(mktemp)"
             SUDO awk -v dom="${SERVICE_DOMAIN}" -v new_port="${NEW_PORT}" '
@@ -430,9 +398,7 @@ jobs:
               }
             ' "${NGINX_RP_CONF}" > "${TMP_FILE}"
 
-            # ============================================================
             # 9. nginx 설정 검증 + reload (실패 시 백업 복구)
-            # ============================================================
             echo "🔧 nginx 설정 적용 및 검증"
             SUDO cp "${TMP_FILE}" "${NGINX_RP_CONF}"
             if ! (SUDO nginx -t); then
@@ -461,9 +427,7 @@ jobs:
               fi
             fi
 
-            # ============================================================
             # 10. 도메인 접근 검증
-            # ============================================================
             echo "🌐 도메인 접근 검증 (${SERVICE_DOMAIN})"
             DOMAIN_OK=false
             for i in $(seq 1 ${DOMAIN_CHECK_RETRIES}); do
@@ -481,9 +445,7 @@ jobs:
               echo "⚠️ 도메인 접근 검증 실패: 배포 진행 (DNS 전파 지연 가능성)"
             fi
 
-            # ============================================================
             # 11. 이전 컨테이너 제거
-            # ============================================================
             echo "⏱️ in-flight 요청 처리 대기 (${IN_FLIGHT_WAIT}초)"
             sleep ${IN_FLIGHT_WAIT}
 
@@ -494,9 +456,7 @@ jobs:
               echo "ℹ️ old=${OLD_CONTAINER_NAME} 없음 — 정리 생략"
             fi
 
-            # ============================================================
             # 12. dangling 이미지 정리 + 백업 보존
-            # ============================================================
             echo "🧹 dangling(<none>) 이미지 정리..."
             SUDO docker image prune -af
 
@@ -509,9 +469,7 @@ jobs:
             echo "🌐 도메인: https://${SERVICE_DOMAIN}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# ===================================================================
-# 📝 사용 방법
-# ===================================================================
+# 사용 방법
 #
 # 1) GitHub Secrets 등록:
 #    APPLICATION_PROD_YML, DOCKERHUB_USERNAME, DOCKERHUB_TOKEN,
@@ -534,5 +492,3 @@ jobs:
 # 4) 본 워크플로우로 전환:
 #    - 본 파일의 push.branches 주석 해제
 #    - PROJECT-SPRING-SIMPLE-CICD.yaml 의 push 트리거 주석 처리
-#
-# ===================================================================

package/payload/workflows/spring/server-deploy/PROJECT-SPRING-NONSTOP-TRAEFIK-CICD.yaml

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Spring Boot 무중단 배포 (Traefik Blue-Green, SSH + Docker)
-# ===================================================================
 #
 # deploy 브랜치 푸시 시 Docker 이미지를 빌드하고
 # Traefik 라벨 기반 Blue-Green 토글로 서버(SSH 접속 가능한 호스트)에 무중단 배포합니다.
@@ -10,9 +8,7 @@
 # 기본 배포는 PROJECT-SPRING-SIMPLE-CICD.yaml 입니다.
 # 전환하려면 아래 push.branches 주석 해제 + SIMPLE-CICD 의 push 트리거 주석 처리.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 # APPLICATION_PROD_YML (선택): application-prod.yml 내용
 # DOCKERHUB_USERNAME: DockerHub 사용자명
 # DOCKERHUB_TOKEN: DockerHub 액세스 토큰
@@ -20,50 +16,45 @@
 # SERVER_USER: SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
 #
-# 🔧 환경변수 설정 (env 섹션에서 설정)
-# ===================================================================
+# 환경변수 설정 (env 섹션에서 설정)
 #
-# 🌐 포트 및 컨테이너:
+# 포트 및 컨테이너:
 # PROJECT_NAME: 프로젝트명 (컨테이너/이미지/Traefik router 이름)
 # SERVICE_DOMAIN: 외부 진입 도메인
 # CONTAINER_INTERNAL_PORT: Spring Boot 내부 포트 (기본: 8080)
 #
-# 🚦 Traefik:
+# Traefik:
 # TRAEFIK_NETWORK: Traefik docker 네트워크 (기본: traefik-network)
 # TRAEFIK_ENTRYPOINT: Traefik entrypoint 이름 (기본: web)
 # TRAEFIK_INTERNAL_PORT: NAS 호스트의 Traefik 진입 포트 (기본: 8079)
 # EXTRA_NETWORKS: 추가 docker 네트워크 (공백 구분, 예: selenium-chrome-network)
 #
-# 📦 볼륨/스토리지:
+# 볼륨/스토리지:
 # ENABLE_VOLUME_MOUNT: 볼륨 마운트 여부 (true/false)
 # VOLUME_HOST_PATH: 호스트 볼륨 경로
 # VOLUME_CONTAINER_PATH: 컨테이너 내부 마운트 경로
 #
-# 🔌 SSH 연결:
+# SSH 연결:
 # SSH_PORT: SSH 포트 (기본: 2022)
 # SSH_COMMAND_TIMEOUT: 명령 타임아웃 (기본: 600s)
 # SSH_CONNECTION_TIMEOUT: 연결 타임아웃 (기본: 60s)
 #
-# ⏱️ 헬스체크:
+# 헬스체크:
 # HEALTHCHECK_PATH: Traefik 통한 GET 호출 path (기본: /)
 # HEALTHCHECK_ACCEPT_CODES: 통과 인정 HTTP 코드 (| 구분, 기본: 200|301|302|308)
 # HEALTHCHECK_MAX_RETRIES: 최대 시도 횟수 (기본: 36)
 # HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 초 (기본: 5)
 # IN_FLIGHT_WAIT: old 컨테이너 제거 전 대기 초 (기본: 10)
 #
-# 💡 사전 조건:
+# 사전 조건:
 #   - 배포 서버에 Traefik 컨테이너가 traefik-network 에 띄워져 있어야 함
 #   - 역방향 프록시: ${SERVICE_DOMAIN}:443 → localhost:${TRAEFIK_INTERNAL_PORT}
 #     (예: Synology DSM 역방향 프록시, Nginx, Caddy 등)
-# ===================================================================
 
 name: PROJECT-SPRING-NONSTOP-TRAEFIK-CICD
 
-# ===================================================================
 # 트리거 설정
-# ===================================================================
 # deploy 브랜치 push 자동 트리거는 주석 처리되어 있습니다.
 # 본 워크플로우로 전환하려면 아래 push.branches 주석을 해제하세요.
 on:
@@ -72,48 +63,45 @@ on:
   #     - {{MAIN_BRANCH}}
   workflow_dispatch:
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
-  # 🔧 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
+  # 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   SERVICE_DOMAIN: "__SERVICE_DOMAIN__"  # @wizard ask:example.com
 
-  # ☁️ Spring Boot 설정
+  # Spring Boot 설정
   SPRING_PROFILE: "prod"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:@jdk
   GRADLE_OPTS: "-Dspring.profiles.active=prod"
 
-  # 📁 경로 설정
+  # 경로 설정
   APPLICATION_YML_DIR: "__APPLICATION_YML_DIR__"  # @wizard auto:spring-app-yml-dir
   DOCKERFILE_PATH: "./Dockerfile"
 
-  # 🌐 포트 및 컨테이너 설정
+  # 포트 및 컨테이너 설정
   CONTAINER_INTERNAL_PORT: "8080"
 
-  # 🚦 Traefik 설정 (서버의 Traefik 환경 구축 후 수정 금지)
+  # Traefik 설정 (서버의 Traefik 환경 구축 후 수정 금지)
   TRAEFIK_NETWORK: "traefik-network"
   TRAEFIK_ENTRYPOINT: "web"
   TRAEFIK_INTERNAL_PORT: "8079"
   EXTRA_NETWORKS: ""
 
-  # 📦 볼륨 마운트 설정
+  # 볼륨 마운트 설정
   ENABLE_VOLUME_MOUNT: "false"  # @wizard ask:false
   VOLUME_HOST_PATH: "/volume1/projects/__PROJECT_NAME__"  # @wizard ask:/volume1/projects/__PROJECT_NAME__
   VOLUME_CONTAINER_PATH: "/mnt/__PROJECT_NAME__"  # @wizard ask:/mnt/__PROJECT_NAME__
 
-  # 🔐 SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
+  # SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
   #   password → SERVER_PASSWORD secret 사용
   #   key      → SSH_KEY secret 사용 (.pem 파일 전체 내용을 secret 값으로)
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
-  # 🔌 SSH 연결 설정
+  # SSH 연결 설정
   SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
   SSH_COMMAND_TIMEOUT: "600s"
   SSH_CONNECTION_TIMEOUT: "60s"
 
-  # ⏱️ 헬스체크 설정
+  # 헬스체크 설정
   HEALTHCHECK_PATH: "/"
   HEALTHCHECK_ACCEPT_CODES: "200|301|302|308"
   HEALTHCHECK_MAX_RETRIES: "36"
@@ -121,9 +109,7 @@ env:
   IN_FLIGHT_WAIT: "10"
 
 jobs:
-  # ===================================================================
   # 빌드 작업
-  # ===================================================================
   build:
     name: Spring Boot 애플리케이션 빌드
     runs-on: ubuntu-latest
@@ -185,9 +171,7 @@ jobs:
           rm -rf /tmp/.buildx-cache
           mv /tmp/.buildx-cache-new /tmp/.buildx-cache
 
-  # ===================================================================
   # 배포 작업 (Blue-Green 무중단)
-  # ===================================================================
   deploy:
     name: Blue-Green 무중단 배포
     needs: build
@@ -231,7 +215,7 @@ jobs:
             export PATH=$PATH:/usr/local/bin
             export PW="${SERVER_PASSWORD}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -252,15 +236,11 @@ jobs:
             echo "🔧 Traefik 진입: localhost:${TRAEFIK_INTERNAL_PORT} (entrypoint=${TRAEFIK_ENTRYPOINT})"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # ============================================================
             # 1. 최신 이미지 Pull
-            # ============================================================
             echo "📥 이미지 Pull: ${IMAGE}"
             SUDO docker pull "${IMAGE}"
 
-            # ============================================================
             # 2. 현재 active 컨테이너 색 판별 (Traefik 라벨 부착 여부 기준)
-            # ============================================================
             ACTIVE=$(SUDO docker ps \
               --filter "label=traefik.http.routers.${ROUTER_NAME}.rule" \
               --filter "name=${PROJECT_NAME}-" \
@@ -283,15 +263,11 @@ jobs:
 
             echo "🎨 active=${ACTIVE:-none} → new=${NEW_NAME}, old=${OLD_NAME}"
 
-            # ============================================================
             # 3. 동일 슬롯(idle 쪽) 잔존 컨테이너 정리
-            # ============================================================
             echo "🗑️ idle 슬롯 정리: ${NEW_NAME}"
             SUDO docker rm -f "${NEW_NAME}" 2>/dev/null || true
 
-            # ============================================================
             # 4. 볼륨 마운트 옵션 구성
-            # ============================================================
             VOLUME_MOUNT_OPTION="-v /etc/localtime:/etc/localtime:ro"
             if [ "${ENABLE_VOLUME_MOUNT}" = "true" ]; then
               if [ ! -d "${VOLUME_HOST_PATH}" ]; then
@@ -304,9 +280,7 @@ jobs:
               echo "ℹ️ 볼륨 마운트 비활성화됨"
             fi
 
-            # ============================================================
             # 5. 새 컨테이너 기동 (Traefik 라벨 포함)
-            # ============================================================
             echo "🐳 새 컨테이너 기동: ${NEW_NAME}"
             SUDO docker run -d \
               --name "${NEW_NAME}" \
@@ -320,9 +294,7 @@ jobs:
               ${VOLUME_MOUNT_OPTION} \
               "${IMAGE}"
 
-            # ============================================================
             # 6. 추가 네트워크 연결 (EXTRA_NETWORKS, 공백 구분)
-            # ============================================================
             if [ -n "${EXTRA_NETWORKS}" ]; then
               for net in ${EXTRA_NETWORKS}; do
                 echo "🔗 추가 네트워크 연결: ${net}"
@@ -330,15 +302,11 @@ jobs:
               done
             fi
 
-            # ============================================================
             # 7. Traefik 라벨 디버그 출력 (escape 검증용)
-            # ============================================================
             echo "🔍 Traefik 라벨 확인:"
             SUDO docker inspect "${NEW_NAME}" --format '{{range $k, $v := .Config.Labels}}  {{$k}} = {{$v}}{{"\n"}}{{end}}' | grep traefik || true
 
-            # ============================================================
             # 8. 헬스체크 — Traefik 통한 라우팅 확인
-            # ============================================================
             MAX_WAIT=$((HEALTHCHECK_MAX_RETRIES * HEALTHCHECK_RETRY_INTERVAL))
             echo "⏳ 헬스체크 시작 (최대 ${MAX_WAIT}초, ${HEALTHCHECK_MAX_RETRIES}회 × ${HEALTHCHECK_RETRY_INTERVAL}초)"
 
@@ -388,9 +356,7 @@ jobs:
               exit 1
             fi
 
-            # ============================================================
             # 9. in-flight 처리 + old 컨테이너 자동 제거
-            # ============================================================
             if SUDO docker ps -a --format '{{.Names}}' | grep -Eq "^${OLD_NAME}$"; then
               echo "⏱️ in-flight 요청 처리 대기 (${IN_FLIGHT_WAIT}초)"
               sleep ${IN_FLIGHT_WAIT}
@@ -400,9 +366,7 @@ jobs:
               echo "ℹ️ old=${OLD_NAME} 없음 — 정리 생략"
             fi
 
-            # ============================================================
             # 10. dangling 이미지 정리
-            # ============================================================
             echo "🧹 dangling(<none>) 이미지 정리..."
             SUDO docker image prune -af
 
@@ -411,9 +375,7 @@ jobs:
             echo "🌐 도메인: https://${SERVICE_DOMAIN}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# ===================================================================
-# 📝 사용 방법
-# ===================================================================
+# 사용 방법
 #
 # 1) GitHub Secrets 등록:
 #    APPLICATION_PROD_YML, DOCKERHUB_USERNAME, DOCKERHUB_TOKEN,
@@ -434,5 +396,3 @@ jobs:
 # 4) 본 워크플로우로 전환:
 #    - 본 파일의 push.branches 주석 해제
 #    - PROJECT-SPRING-SIMPLE-CICD.yaml 의 push 트리거 주석 처리
-#
-# ===================================================================