project-auto-wizard 0.11.0 → 0.12.1

package/payload/workflows/python/PROJECT-PYTHON-CI.yaml

@@ -1,19 +1,10 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Python FastAPI 빌드 검증 워크플로우 (CI Only)
-# ===================================================================
-#
-# 설명:
 # - {{MAIN_BRANCH}} 브랜치에 push 시 Docker 빌드가 정상적으로 되는지만 검증
 # - 배포는 수행하지 않음 ({{MAIN_BRANCH}} 브랜치에서만 배포)
-#
-# ===================================================================
 
 name: PROJECT-PYTHON-CI
 
-# ===================================================================
-# 트리거 설정
-# ===================================================================
 on:
   push:
     branches:
@@ -23,9 +14,6 @@ on:
       - "{{DEVELOP_BRANCH}}"  # {{DEVELOP_BRANCH}} 브랜치로의 PR 시 빌드 검증
   workflow_dispatch:  # 수동 실행 허용
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
   # 프로젝트 고유 식별자 (컨테이너명, 이미지명, 도메인에 사용)
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
@@ -33,9 +21,6 @@ env:
   PROJECT_PATH: "."  # @wizard auto:project-path
 
 jobs:
-  # ===================================================================
-  # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
-  # ===================================================================
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -57,9 +42,6 @@ jobs:
             project:
               - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
 
-  # ===================================================================
-  # 빌드 검증 작업
-  # ===================================================================
   build-check:
     name: Python FastAPI 빌드 검증
     runs-on: ubuntu-latest
@@ -67,11 +49,9 @@ jobs:
     if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. .env 파일 생성 (빌드 검증용)
       - name: .env 파일 생성
         run: |
           cat > .env << 'EOF'
@@ -79,11 +59,9 @@ jobs:
           EOF
           echo "✅ .env 파일이 생성되었습니다"
 
-      # 3. Docker 빌드 환경 설정
       - name: Docker 빌드환경 설정
         uses: docker/setup-buildx-action@v3
 
-      # 4. Docker 이미지 빌드 (push 없이 검증만)
       - name: Docker 이미지 빌드 검증
         uses: docker/build-push-action@v5
         with:
@@ -91,11 +69,9 @@ jobs:
           file: ./Dockerfile
           push: false  # 푸시하지 않음 (빌드 검증만)
           tags: ${{ env.PROJECT_NAME }}:build-check
-          # GitHub Actions 캐시 사용
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-      # 5. 빌드 성공 메시지
       - name: 빌드 검증 완료
         run: |
           echo "✅ Docker 빌드 검증이 성공적으로 완료되었습니다!"
@@ -106,9 +82,7 @@ jobs:
           echo "  📝 커밋: ${{ github.sha }}"
           echo "  ⏰ 검증 시간: $(date '+%Y-%m-%d %H:%M:%S')"
 
-  # ===================================================================
-  # CI Gate (required check로 등록할 단일 job)
-  # ===================================================================
+  # CI Gate: required check로 등록할 단일 job
   ci-gate:
     name: CI Gate
     if: ${{ always() }}

package/payload/workflows/python/PROJECT-PYTHON-PR-PREVIEW.yaml

@@ -1,14 +1,9 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Python/FastAPI PR Preview (SSH + Docker + Traefik)
-# ===================================================================
-#
 # PR 또는 Issue 코멘트 명령어를 통해 Preview 환경을 자동으로 관리합니다.
 # Traefik 리버스 프록시를 통해 동적 라우팅됩니다.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 # ENV_FILE: .env 파일 전체 내용
 # DOCKERHUB_USERNAME: Docker Hub 사용자명
 # DOCKERHUB_TOKEN: Docker Hub 액세스 토큰
@@ -16,27 +11,23 @@
 # SERVER_USER: SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
 #
-# 🚀 사용법:
+# 사용법
 # /wizard server build    - Preview 빌드 및 배포
 # /wizard server destroy  - Preview 환경 삭제
 # /wizard server status   - 현재 상태 확인
 #
-# 📊 리소스 네이밍:
+# 리소스 네이밍
 # - 컨테이너: {PROJECT_NAME}-pr-{번호}
 # - 도메인: {PROJECT_NAME}-pr-{번호}.pr.example.com
 #
-# 📋 사전 요구사항:
+# 사전 요구사항
 # - Traefik 컨테이너 실행 중 (traefik-network)
 # - 와일드카드 DNS 설정: *.pr.example.com → 서버
-# ===================================================================
 
 name: PROJECT-PYTHON-PR-PREVIEW
 
-# ===================================================================
-# ⚠️ [영역 1] 프로젝트별 설정 - 다른 프로젝트에서 사용 시 이 섹션만 수정하세요
-# ===================================================================
+# 프로젝트별 설정: 다른 프로젝트에서 사용 시 이 섹션만 수정하세요
 env:
   # 프로젝트 고유 식별자 (컨테이너명, 이미지명, 도메인에 사용)
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
@@ -45,7 +36,7 @@ env:
   DOCKERFILE_PATH: './Dockerfile'
   INTERNAL_PORT: '8000'
 
-  # 🗂️ 볼륨 마운트 설정 (프로젝트별 수정 필요, 빈값이면 마운트 안함)
+  # 볼륨 마운트 설정 (프로젝트별 수정 필요, 빈값이면 마운트 안함)
   PROJECT_TARGET_DIR: "__PROJECT_TARGET_DIR__"  # @wizard ask:/volume1/projects/__PROJECT_NAME__
   PROJECT_MNT_DIR: "__PROJECT_MNT_DIR__"  # @wizard ask:/mnt/__PROJECT_NAME__
 
@@ -54,7 +45,7 @@ env:
   PREVIEW_DOMAIN_SUFFIX: "__PREVIEW_DOMAIN_SUFFIX__"  # @wizard ask:pr.example.com
   PREVIEW_PORT: '8079'
 
-  # 🔐 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
@@ -79,9 +70,6 @@ env:
   HEALTH_CHECK_LOG_PATTERN: 'Uvicorn running on|Application startup complete'
   API_DOCS_PATH: '/docs'
 
-# ===================================================================
-# 트리거 설정
-# ===================================================================
 on:
   issue_comment:
     types: [created]      # PR 댓글 + Issue 댓글
@@ -95,13 +83,8 @@ permissions:
   pull-requests: write
   issues: write
 
-# ===================================================================
-# Jobs
-# ===================================================================
 jobs:
-  # -----------------------------------------------------------------
   # Job 1: 명령어 파싱 (PR 댓글 + Issue 댓글 모두 지원)
-  # -----------------------------------------------------------------
   check-command:
     name: 명령어 확인
     if: github.event_name == 'issue_comment'
@@ -132,7 +115,6 @@ jobs:
           COMMENT: ${{ github.event.comment.body }}
           IS_PR: ${{ github.event.issue.pull_request != null }}
         run: |
-          # PR인지 Issue인지 확인
           if [[ "$IS_PR" == "true" ]]; then
             echo "is_pr=true" >> $GITHUB_OUTPUT
             echo "ℹ️ PR 댓글에서 명령어 감지"
@@ -141,7 +123,6 @@ jobs:
             echo "ℹ️ Issue 댓글에서 명령어 감지"
           fi
 
-          # 명령어 파싱 (브랜치 파라미터 지원)
           # 형식: /wizard server <command> [브랜치명]
           if [[ "$COMMENT" =~ /wizard[[:space:]]+server[[:space:]]+build([[:space:]]+([^[:space:]]+))? ]]; then
             echo "command=build" >> $GITHUB_OUTPUT
@@ -181,9 +162,7 @@ jobs:
             echo "ℹ️ /wizard server 명령어가 아님"
           fi
 
-  # -----------------------------------------------------------------
   # Job 2-1: 빌드 & 배포 (PR 댓글에서 실행)
-  # -----------------------------------------------------------------
   build-preview-pr:
     name: Preview 빌드 & 배포 (PR)
     needs: check-command
@@ -208,9 +187,7 @@ jobs:
             core.setOutput('sha', pr.data.head.sha.substring(0, 7));
             return pr.data.number;
 
-      # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
       # 진행 상황 댓글 시스템
-      # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
       - name: 진행 상황 댓글 생성
         id: progress
         uses: actions/github-script@v9
@@ -250,17 +227,12 @@ jobs:
         with:
           ref: ${{ steps.pr.outputs.ref }}
 
-      # =================================================================
-      # ⚠️ [영역 2] 환경변수 파일 생성
-      # =================================================================
+      # 환경변수 파일 생성 (프로젝트별 수정 영역)
       - name: "[필수] .env 파일 생성"
         run: |
           cat << 'EOF' > .env
           ${{ secrets.ENV_FILE }}
           EOF
-      # =================================================================
-      # ⚠️ [영역 2 끝] 환경변수 파일 생성 끝
-      # =================================================================
 
       - name: Docker 로그인
         uses: docker/login-action@v3
@@ -333,11 +305,10 @@ jobs:
           script: |
             set -e
 
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
             export PW="${{ secrets.SERVER_PASSWORD }}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -346,7 +317,6 @@ jobs:
             fi
             echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
 
-            # 변수 설정
             PR_NUMBER=${{ github.event.issue.number }}
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
             CONTAINER_NAME="${PROJECT_NAME}-pr-${PR_NUMBER}"
@@ -364,21 +334,17 @@ jobs:
             echo "🌐 도메인: ${DOMAIN}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # 이미지 Pull
             echo "📥 Docker 이미지 Pull 중..."
             SUDO docker pull "${IMAGE}"
 
-            # 기존 컨테이너 삭제
             echo "🗑️ 기존 컨테이너 정리 중..."
             SUDO docker rm -f "${CONTAINER_NAME}" 2>/dev/null || true
 
-            # 볼륨 마운트 옵션 구성
             VOLUME_OPTS="-v /etc/localtime:/etc/localtime:ro"
             if [ -n "${{ env.PROJECT_TARGET_DIR }}" ] && [ -n "${{ env.PROJECT_MNT_DIR }}" ]; then
               VOLUME_OPTS="$VOLUME_OPTS -v ${{ env.PROJECT_TARGET_DIR }}:${{ env.PROJECT_MNT_DIR }}"
             fi
 
-            # 새 컨테이너 실행
             echo "🐳 새 컨테이너 실행 중..."
             SUDO docker run -d \
               --name "${CONTAINER_NAME}" \
@@ -392,11 +358,9 @@ jobs:
               $VOLUME_OPTS \
               "${IMAGE}"
 
-            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
             # Health Check (최대 120초 대기) - 하이브리드 방식
             # 1. HEALTH_CHECK_PATH가 설정되어 있으면 HTTP 체크 시도
             # 2. 폴백: 로그 패턴 매칭 (HEALTH_CHECK_LOG_PATTERN)
-            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
             echo ""
             echo "⏳ Health Check 시작 (최대 120초 대기)..."
             HEALTH_PATH="${{ env.HEALTH_CHECK_PATH }}"
@@ -616,9 +580,7 @@ jobs:
               });
             }
 
-  # -----------------------------------------------------------------
   # Job 2-2: Issue에서 브랜치명 추출
-  # -----------------------------------------------------------------
   get-branch-from-issue:
     name: Issue에서 브랜치 추출
     needs: check-command
@@ -706,9 +668,7 @@ jobs:
               body: body
             });
 
-  # -----------------------------------------------------------------
   # Job 2-3: 빌드 & 배포 (Issue 댓글에서 실행)
-  # -----------------------------------------------------------------
   build-preview-issue:
     name: Preview 빌드 & 배포 (Issue)
     needs: [check-command, get-branch-from-issue]
@@ -784,12 +744,9 @@ jobs:
         run: |
           echo "ref=${{ needs.get-branch-from-issue.outputs.branch_name }}" >> $GITHUB_OUTPUT
           echo "issue_number=${{ needs.get-branch-from-issue.outputs.issue_number }}" >> $GITHUB_OUTPUT
-          # 브랜치의 최신 커밋 SHA 가져오기
           echo "sha=$(git ls-remote https://github.com/${{ github.repository }}.git refs/heads/${{ needs.get-branch-from-issue.outputs.branch_name }} | cut -c1-7)" >> $GITHUB_OUTPUT
 
-      # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
       # 진행 상황 댓글 시스템
-      # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
       - name: 진행 상황 댓글 생성
         if: steps.check_branch.outputs.exists == 'true'
         id: progress
@@ -834,18 +791,13 @@ jobs:
         with:
           ref: ${{ needs.get-branch-from-issue.outputs.branch_name }}
 
-      # =================================================================
-      # ⚠️ [영역 2] 환경변수 파일 생성
-      # =================================================================
+      # 환경변수 파일 생성 (프로젝트별 수정 영역)
       - name: "[필수] .env 파일 생성"
         if: steps.check_branch.outputs.exists == 'true'
         run: |
           cat << 'EOF' > .env
           ${{ secrets.ENV_FILE }}
           EOF
-      # =================================================================
-      # ⚠️ [영역 2 끝] 환경변수 파일 생성 끝
-      # =================================================================
 
       - name: Docker 로그인
         if: steps.check_branch.outputs.exists == 'true'
@@ -926,11 +878,10 @@ jobs:
           script: |
             set -e
 
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
             export PW="${{ secrets.SERVER_PASSWORD }}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -939,7 +890,6 @@ jobs:
             fi
             echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
 
-            # 변수 설정
             ISSUE_NUMBER=${{ needs.get-branch-from-issue.outputs.issue_number }}
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
             CONTAINER_NAME="${PROJECT_NAME}-pr-${ISSUE_NUMBER}"
@@ -957,21 +907,17 @@ jobs:
             echo "🌐 도메인: ${DOMAIN}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # 이미지 Pull
             echo "📥 Docker 이미지 Pull 중..."
             SUDO docker pull "${IMAGE}"
 
-            # 기존 컨테이너 삭제
             echo "🗑️ 기존 컨테이너 정리 중..."
             SUDO docker rm -f "${CONTAINER_NAME}" 2>/dev/null || true
 
-            # 볼륨 마운트 옵션 구성
             VOLUME_OPTS="-v /etc/localtime:/etc/localtime:ro"
             if [ -n "${{ env.PROJECT_TARGET_DIR }}" ] && [ -n "${{ env.PROJECT_MNT_DIR }}" ]; then
               VOLUME_OPTS="$VOLUME_OPTS -v ${{ env.PROJECT_TARGET_DIR }}:${{ env.PROJECT_MNT_DIR }}"
             fi
 
-            # 새 컨테이너 실행
             echo "🐳 새 컨테이너 실행 중..."
             SUDO docker run -d \
               --name "${CONTAINER_NAME}" \
@@ -985,11 +931,9 @@ jobs:
               $VOLUME_OPTS \
               "${IMAGE}"
 
-            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
             # Health Check (최대 120초 대기) - 하이브리드 방식
             # 1. HEALTH_CHECK_PATH가 설정되어 있으면 HTTP 체크 시도
             # 2. 폴백: 로그 패턴 매칭 (HEALTH_CHECK_LOG_PATTERN)
-            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
             echo ""
             echo "⏳ Health Check 시작 (최대 120초 대기)..."
             HEALTH_PATH="${{ env.HEALTH_CHECK_PATH }}"
@@ -1209,9 +1153,7 @@ jobs:
               });
             }
 
-  # -----------------------------------------------------------------
   # Job 3: Preview 삭제 (PR/Issue 닫힘 또는 destroy 명령)
-  # -----------------------------------------------------------------
   destroy-preview:
     name: Preview 삭제
     # needs 의존성 제거: PR/Issue 닫힘 이벤트에서도 독립적으로 실행되도록 함
@@ -1247,11 +1189,10 @@ jobs:
           port: ${{ env.SSH_PORT }}
           envs: SSH_AUTH_METHOD
           script: |
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
             export PW="${{ secrets.SERVER_PASSWORD }}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -1272,11 +1213,9 @@ jobs:
             echo "🔢 PR 번호: #${PR_NUMBER}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # 컨테이너 삭제
             echo "🐳 컨테이너 삭제 중..."
             SUDO docker rm -f "${CONTAINER_NAME}" 2>/dev/null || true
 
-            # 이미지 삭제
             echo "🖼️ 이미지 삭제 중..."
             SUDO docker rmi "${IMAGE}" 2>/dev/null || true
 
@@ -1314,9 +1253,7 @@ jobs:
               body: body
             });
 
-  # -----------------------------------------------------------------
   # Job 4: 상태 확인 (PR/Issue 모두 지원)
-  # -----------------------------------------------------------------
   check-status:
     name: Preview 상태 확인
     needs: check-command
@@ -1333,7 +1270,6 @@ jobs:
           key: ${{ secrets.SSH_KEY }}
           port: ${{ env.SSH_PORT }}
           script: |
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
 
             NUMBER=${{ github.event.issue.number }}
@@ -1364,7 +1300,6 @@ jobs:
           key: ${{ secrets.SSH_KEY }}
           port: ${{ env.SSH_PORT }}
           script: |
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
 
             NUMBER=${{ github.event.issue.number }}
@@ -1429,9 +1364,7 @@ jobs:
               body: body
             });
 
-  # -----------------------------------------------------------------
   # Job 5: 커스텀 브랜치 빌드 & 배포
-  # -----------------------------------------------------------------
   build-preview-custom-branch:
     name: Preview 빌드 & 배포 (Custom Branch)
     needs: check-command
@@ -1525,7 +1458,6 @@ jobs:
           SHA=$(git ls-remote https://github.com/${{ github.repository }}.git refs/heads/${{ needs.check-command.outputs.custom_branch }} | cut -c1-7)
           echo "sha=$SHA" >> $GITHUB_OUTPUT
 
-      # 진행 상황 댓글 생성
       - name: 진행 상황 댓글 생성
         if: steps.branch_info.outputs.branch_exists == 'true'
         id: progress
@@ -1570,7 +1502,6 @@ jobs:
         with:
           ref: ${{ needs.check-command.outputs.custom_branch }}
 
-      # 환경변수 파일 생성
       - name: "[필수] .env 파일 생성"
         if: steps.branch_info.outputs.branch_exists == 'true'
         run: |
@@ -1669,11 +1600,10 @@ jobs:
           script: |
             set -e
 
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
             export PW="${{ secrets.SERVER_PASSWORD }}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -1682,7 +1612,6 @@ jobs:
             fi
             echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
 
-            # 변수 설정
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
             CONTAINER_NAME="${{ steps.container.outputs.name }}"
             CONTAINER_SUFFIX="${{ steps.container.outputs.suffix }}"
@@ -1699,21 +1628,17 @@ jobs:
             echo "🌐 도메인: ${DOMAIN}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # 이미지 Pull
             echo "📥 Docker 이미지 Pull 중..."
             SUDO docker pull "${IMAGE}"
 
-            # 기존 컨테이너 삭제
             echo "🗑️ 기존 컨테이너 정리 중..."
             SUDO docker rm -f "${CONTAINER_NAME}" 2>/dev/null || true
 
-            # 볼륨 마운트 옵션 구성
             VOLUME_OPTS="-v /etc/localtime:/etc/localtime:ro"
             if [ -n "${{ env.PROJECT_TARGET_DIR }}" ] && [ -n "${{ env.PROJECT_MNT_DIR }}" ]; then
               VOLUME_OPTS="$VOLUME_OPTS -v ${{ env.PROJECT_TARGET_DIR }}:${{ env.PROJECT_MNT_DIR }}"
             fi
 
-            # 새 컨테이너 실행
             echo "🐳 새 컨테이너 실행 중..."
             SUDO docker run -d \
               --name "${CONTAINER_NAME}" \
@@ -1727,7 +1652,6 @@ jobs:
               $VOLUME_OPTS \
               "${IMAGE}"
 
-            # Health Check
             echo ""
             echo "⏳ Health Check 시작 (최대 120초 대기)..."
             HEALTH_PATH="${{ env.HEALTH_CHECK_PATH }}"
@@ -1942,9 +1866,7 @@ jobs:
               });
             }
 
-  # -----------------------------------------------------------------
   # Job 6: 커스텀 브랜치 Preview 삭제
-  # -----------------------------------------------------------------
   destroy-preview-custom-branch:
     name: Preview 삭제 (Custom Branch)
     needs: check-command
@@ -1997,11 +1919,10 @@ jobs:
           port: ${{ env.SSH_PORT }}
           envs: SSH_AUTH_METHOD
           script: |
-            # 환경 변수 설정 (배포 서버용)
             export PATH=$PATH:/usr/local/bin
             export PW="${{ secrets.SERVER_PASSWORD }}"
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
@@ -2024,11 +1945,9 @@ jobs:
             echo "📛 컨테이너: ${CONTAINER_NAME}"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-            # 컨테이너 삭제
             echo "🐳 컨테이너 삭제 중..."
             SUDO docker rm -f "${CONTAINER_NAME}" 2>/dev/null || true
 
-            # 이미지 삭제
             echo "🖼️ 이미지 삭제 중..."
             SUDO docker rmi "${IMAGE}" 2>/dev/null || true
 
@@ -2063,9 +1982,7 @@ jobs:
               body: body
             });
 
-  # -----------------------------------------------------------------
   # Job 7: 커스텀 브랜치 Preview 상태 확인
-  # -----------------------------------------------------------------
   check-status-custom-branch:
     name: Preview 상태 확인 (Custom Branch)
     needs: check-command