project-auto-wizard 0.11.0 → 0.12.1

package/payload/workflows/python/PROJECT-PYTHON-SIMPLE-CICD.yaml

@@ -1,14 +1,9 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Python FastAPI CI/CD 배포 (SSH + Docker)
-# ===================================================================
-#
 # {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고
 # SSH로 접속 가능한 서버(Synology·AWS EC2·VPS 등)에 자동 배포합니다.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 # ENV_FILE: .env 파일 내용
 # DOCKERHUB_USERNAME: DockerHub 사용자명
 # DOCKERHUB_TOKEN: DockerHub 액세스 토큰
@@ -16,43 +11,12 @@
 # SERVER_USER: SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
-#
-# 🔧 환경변수 설정 (env 섹션에서 설정)
-# ===================================================================
-#
-# 🌐 포트 및 컨테이너:
-# CONTAINER_INTERNAL_PORT: FastAPI 내부 포트 (기본: 8000)
-# DEPLOY_PORT: 배포 포트
-# CONTAINER_NAME: 컨테이너 이름 (기본: PROJECT_NAME)
-#
-# 📦 볼륨 마운트:
-# ENABLE_VOLUME_MOUNT: 볼륨 마운트 활성화 (true/false)
-# VOLUME_HOST_PATH: 호스트 볼륨 경로
-# VOLUME_CONTAINER_PATH: 컨테이너 내부 마운트 경로
-#
-# 🔌 SSH 연결:
-# SSH_PORT: SSH 포트 (기본: 2022)
-# SSH_COMMAND_TIMEOUT: SSH 명령 타임아웃 (기본: 600s)
-# SSH_CONNECTION_TIMEOUT: SSH 연결 타임아웃 (기본: 60s)
-#
-# ⏱️ 헬스체크:
-# HEALTHCHECK_WAIT_SECONDS: 초기화 대기 시간 (기본: 10초)
-# HEALTHCHECK_PATH: HTTP 엔드포인트 경로 (비어있으면 로그만 사용)
-# HEALTHCHECK_MAX_RETRIES: HTTP 재시도 횟수 (기본: 5회)
-# HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 (기본: 3초)
-# HEALTHCHECK_LOG_PATTERN: Fallback 로그 검색 패턴
 #
-# 💡 HEALTHCHECK_PATH 예시:
-#   FastAPI: "/docs"
-#   커스텀: "/api/v1/health"
-# ===================================================================
+# 환경변수는 아래 env 섹션에서 설정하며, 항목별 설명과 기본값은 각 줄에 적혀 있습니다.
+# HEALTHCHECK_PATH 예시: FastAPI "/docs", 커스텀 "/api/v1/health"
 
 name: PROJECT-PYTHON-SIMPLE-CICD
 
-# ===================================================================
-# 트리거 설정
-# ===================================================================
 on:
   push:
     branches:
@@ -60,38 +24,35 @@ on:
     # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
   workflow_dispatch:  # 수동 실행 허용
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
   # 프로젝트 고유 식별자
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
 
-  # 🌐 포트 설정
+  # 포트 설정
   DEPLOY_PORT: "__DEPLOY_PORT__"  # @wizard ask:8000
 
-  # 🐳 컨테이너 이름 설정 (비워두면 PROJECT_NAME 사용)
+  # 컨테이너 이름 설정 (비워두면 PROJECT_NAME 사용)
   CONTAINER_NAME: ""
 
-  # 🗂️ 볼륨 마운트 설정 (빈값이면 마운트 안함)
+  # 볼륨 마운트 설정 (빈값이면 마운트 안함)
   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 명령 실행 타임아웃
   SSH_CONNECTION_TIMEOUT: "60s"  # SSH 연결 타임아웃
 
-  # 🌐 컨테이너 포트 설정
+  # 컨테이너 포트 설정
   CONTAINER_INTERNAL_PORT: "8000"  # FastAPI 내부 포트
 
-  # ⏱️ 헬스체크 설정
+  # 헬스체크 설정
   HEALTHCHECK_WAIT_SECONDS: "10"  # 컨테이너 초기화 대기 시간 (초)
   HEALTHCHECK_PATH: "/docs"  # HTTP 엔드포인트 경로 (비어있으면 로그 패턴만 사용)
   HEALTHCHECK_MAX_RETRIES: "5"  # HTTP 재시도 횟수
@@ -99,19 +60,15 @@ env:
   HEALTHCHECK_LOG_PATTERN: "Uvicorn running on"  # Fallback 로그 검색 패턴
 
 jobs:
-  # ===================================================================
-  # 빌드 작업
-  # ===================================================================
+  # Job: 빌드
   build:
     name: Python FastAPI 애플리케이션 빌드
     runs-on: ubuntu-latest
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. 디스크 공간 확보
       - name: 디스크 공간 확보
         run: |
           echo "📊 빌드 전 디스크 사용량:"
@@ -129,7 +86,6 @@ jobs:
           echo "📊 정리 후 디스크 사용량:"
           df -h
 
-      # 3. .env 파일 생성
       - name: .env 파일 생성
         run: |
           cat > .env << 'EOF'
@@ -137,18 +93,15 @@ jobs:
           EOF
           echo "✅ .env 파일이 생성되었습니다"
 
-      # 4. Docker 빌드 환경 설정
       - name: Docker 빌드환경 설정
         uses: docker/setup-buildx-action@v3
 
-      # 5. DockerHub 로그인
       - name: DockerHub 로그인
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
-      # 6. Docker 이미지 빌드 및 푸시
       - name: Docker 이미지 빌드 및 푸시
         uses: docker/build-push-action@v5
         with:
@@ -160,7 +113,6 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-      # 7. 빌드 후 정리
       - name: 빌드 후 정리
         if: always()
         run: |
@@ -169,16 +121,13 @@ jobs:
           echo "📊 최종 디스크 사용량:"
           df -h
 
-  # ===================================================================
-  # 배포 작업
-  # ===================================================================
+  # Job: 배포
   deploy:
     name: 원격 서버 배포
     needs: build
     runs-on: ubuntu-latest
 
     steps:
-      # SSH 통한 원격 서버 배포 실행
       - name: Deploy
         uses: appleboy/ssh-action@v1.0.3
         env:
@@ -195,14 +144,12 @@ jobs:
           script: |
             set -e
 
-            # ============================================================
             # 배포 환경 변수 설정
-            # ============================================================
             echo "🔧 환경변수 설정.."
             export PATH=$PATH:/usr/local/bin
             export PW=${{ secrets.SERVER_PASSWORD }}
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             #   password 모드: echo $PW | sudo -S  (Synology 등 sudo 비밀번호 필요 서버)
             #   key 모드: sudo 직접  (AWS EC2 등 passwordless sudo 서버)
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
@@ -213,18 +160,13 @@ jobs:
             fi
             echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
 
-            # GitHub에서 전달받은 브랜치명
             BRANCH=${{ github.ref_name }}
 
-            # 프로젝트 설정
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
 
-            # ============================================================
             # 포트 및 컨테이너명 설정
-            # ============================================================
             PORT=${{ env.DEPLOY_PORT }}
 
-            # 컨테이너 이름 설정
             if [ -z "${{ env.CONTAINER_NAME }}" ]; then
               CONTAINER_NAME="${PROJECT_NAME}"
               echo "ℹ️ CONTAINER_NAME이 설정되지 않아 PROJECT_NAME을 사용합니다: $CONTAINER_NAME"
@@ -235,7 +177,6 @@ jobs:
 
             echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
 
-            # 설정 정보 출력
             echo "📋 배포 설정 정보:"
             echo "  - 브랜치: $BRANCH"
             echo "  - 프로젝트: $PROJECT_NAME"
@@ -243,18 +184,13 @@ jobs:
             echo "  - 포트: $PORT"
             echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}"
 
-            # ============================================================
             # Docker 이미지 풀 (Pull)
-            # ============================================================
             echo "⬇️ Docker 이미지 풀: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}"
             SUDO docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}
 
-            # ============================================================
             # 기존 컨테이너 정리
-            # ============================================================
             echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
 
-            # 동일한 이름의 컨테이너가 존재하는지 확인
             if SUDO docker ps -a --format '{{.Names}}' | grep -Eq "^${CONTAINER_NAME}\$"; then
               echo "⚠️ 컨테이너 $CONTAINER_NAME 이(가) 존재합니다. 중지 및 삭제 중..."
               SUDO docker rm -f $CONTAINER_NAME
@@ -263,21 +199,13 @@ jobs:
               echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
             fi
 
-            # ============================================================
             # 새 컨테이너 실행
-            # ============================================================
             echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
 
-            # Docker 컨테이너 실행
-            # - 포트 매핑: ${PORT}:${{ env.CONTAINER_INTERNAL_PORT }} (외부:내부)
-            # - 시간대: Asia/Seoul
-            # - 볼륨 마운트: 로컬 시간 동기화 및 프로젝트 데이터
-            # ⚠️ .env 파일은 이미 Docker 이미지에 포함되어 있습니다
+            # .env 파일은 이미 Docker 이미지에 포함되어 있습니다
 
-            # 볼륨 마운트 옵션 구성
             VOLUME_OPTS="-v /etc/localtime:/etc/localtime:ro"
             if [ "${{ env.ENABLE_VOLUME_MOUNT }}" == "true" ]; then
-              # 디렉토리가 없으면 생성
               if [ ! -d "${{ env.VOLUME_HOST_PATH }}" ]; then
                 echo "📁 볼륨 마운트 디렉토리 생성: ${{ env.VOLUME_HOST_PATH }}"
                 SUDO mkdir -p "${{ env.VOLUME_HOST_PATH }}"
@@ -295,9 +223,7 @@ jobs:
               $VOLUME_OPTS \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}
 
-            # ============================================================
             # 컨테이너 헬스체크
-            # ============================================================
             echo "⏳ 컨테이너 초기화 대기 중... (${{ env.HEALTHCHECK_WAIT_SECONDS }}초)"
             sleep ${{ env.HEALTHCHECK_WAIT_SECONDS }}
 
@@ -364,14 +290,10 @@ jobs:
               fi
             fi
 
-            # 최종 성공 메시지
             if [ "$HEALTHCHECK_SUCCESS" = "true" ]; then
               echo "✅ 헬스체크 완료: 컨테이너 $CONTAINER_NAME 이(가) 정상적으로 실행 중입니다"
             fi
 
-            # ============================================================
-            # 배포 완료 확인
-            # ============================================================
             echo "✅ 배포가 성공적으로 완료되었습니다!"
             echo ""
             echo "📋 배포 결과 요약:"

package/payload/workflows/react/PROJECT-REACT-CI.yaml

@@ -1,29 +1,14 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
-# React CI (코드 분석 및 빌드 검증)
-# ===================================================================
+# React CI (빌드 검증)
+# {{MAIN_BRANCH}} 브랜치 푸시 시 npm ci와 npm run build로 빌드를 검증합니다. node_modules와 빌드 결과를 캐싱합니다.
 #
-# {{MAIN_BRANCH}} 브랜치 푸시 시 React 애플리케이션의 빌드를 검증합니다.
+# GitHub Secrets
+#   ENV_FILE (선택): .env 파일 내용. CI는 빌드 검증 목적이므로 배포 관련 Secrets는 불필요
 #
-# 주요 특징:
-# - npm ci로 의존성 설치
-# - npm run build로 빌드 검증
-# - node_modules 및 빌드 캐싱 지원
-#
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
-# ENV_FILE (선택): .env 파일 내용
-#
-# ※ CI는 빌드 검증 목적이므로 배포 관련 Secrets 불필요
-# ===================================================================
-#
-# 🔧 프로젝트별 설정 (env 섹션)
-# ===================================================================
-# PROJECT_NAME : 프로젝트 이름
-# NODE_VERSION : Node.js 버전 (기본: 20.15.0)
-# ENV_FILE     : 환경변수 파일명 (기본: .env)
-# ===================================================================
+# 프로젝트별 설정 (env 섹션)
+#   PROJECT_NAME : 프로젝트 이름
+#   NODE_VERSION : Node.js 버전 (기본: 20.15.0)
+#   ENV_FILE     : 환경변수 파일명 (기본: .env)
 
 name: PROJECT-REACT-CI
 
@@ -45,9 +30,7 @@ permissions:
   issues: write
 
 jobs:
-  # ===================================================================
-  # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
-  # ===================================================================
+  # Job: 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -76,24 +59,20 @@ jobs:
     if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. 환경변수 파일 생성
       - name: 환경변수 파일 생성 (${{ env.ENV_FILE }})
         run: |
           echo -e "${{ secrets.ENV_FILE || secrets.ENV }}" > ${{ env.ENV_FILE }}
           echo "✅ ${{ env.ENV_FILE }} 파일 생성 완료"
 
-      # 3. Node.js 설정
       - name: Node.js 설정
         uses: actions/setup-node@v7
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: "npm"
 
-      # 4. npm 의존성 캐싱
       - name: npm 의존성 캐싱
         uses: actions/cache@v6
         with:
@@ -102,7 +81,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      # 5. node_modules 캐싱
       # package-lock.json이 변경되지 않으면 npm ci 건너뛰기
       - name: node_modules 캐싱
         id: node-modules-cache
@@ -113,7 +91,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-node-modules-
 
-      # 6. 의존성 설치
       # 캐시가 없을 때만 실행 (npm ci는 package-lock.json 기준 정확한 버전 설치)
       - name: 의존성 설치
         if: steps.node-modules-cache.outputs.cache-hit != 'true'
@@ -122,7 +99,7 @@ jobs:
           npm ci
           echo "✅ 의존성 설치 완료"
 
-      # 7. Next.js 빌드 캐싱 (Next.js 프로젝트인 경우)
+      # Next.js 빌드 캐싱 (Next.js 프로젝트인 경우)
       # .next/cache 폴더를 캐싱하여 증분 빌드 속도 향상
       - name: Next.js 빌드 캐싱
         uses: actions/cache@v6
@@ -133,7 +110,6 @@ jobs:
             ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
             ${{ runner.os }}-nextjs-
 
-      # 8. 프로젝트 빌드
       # 빌드 실패 시에도 워크플로우를 중단하지 않고 에러 로그 수집
       - name: 프로젝트 빌드
         id: build
@@ -157,7 +133,6 @@ jobs:
           echo "status=success" >> $GITHUB_OUTPUT
           echo "✅ 빌드 완료"
 
-      # 9. 빌드 실패 시 에러 로그 출력
       # 빌드가 실패한 경우에만 실행
       - name: 빌드 에러 로그 출력
         if: steps.build.outputs.build_failed == 'true'
@@ -180,7 +155,6 @@ jobs:
           # 빌드 실패로 워크플로우 종료
           exit 1
 
-      # 10. 빌드 로그 아티팩트 업로드
       # 빌드 성공/실패 여부와 관계없이 로그 저장
       - name: 빌드 로그 업로드
         if: always()
@@ -190,7 +164,6 @@ jobs:
           path: build_log.txt
           retention-days: 7  # 7일간 보관
 
-      # 11. 빌드 결과 요약
       # 워크플로우 실행 결과를 보기 쉽게 요약
       - name: 빌드 결과 요약
         if: always()
@@ -222,9 +195,7 @@ jobs:
             echo "💡 Actions 탭에서 'build-log' 아티팩트를 다운로드하여 전체 로그를 확인하세요."
           fi
 
-  # ===================================================================
-  # CI Gate (required check로 등록할 단일 job)
-  # ===================================================================
+  # Job: CI Gate (required check로 등록할 단일 job)
   ci-gate:
     name: CI Gate
     if: ${{ always() }}

package/payload/workflows/react/PROJECT-REACT-CICD.yaml

@@ -1,21 +1,15 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # React CI/CD 배포
-# ===================================================================
-#
 # {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고 배포합니다.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
-# ENV_FILE: .env 파일 내용
-# DOCKERHUB_USERNAME: DockerHub 사용자명
-# DOCKERHUB_TOKEN: DockerHub 액세스 토큰
-# SERVER_HOST: 배포 서버 주소
-# SERVER_USER: SSH 사용자명
-# SERVER_PASSWORD: SSH 비밀번호
-# PROJECT_DEPLOY_PORT (선택): 배포 포트 (기본: 3000)
-# ===================================================================
+# GitHub Secrets
+#   ENV_FILE: .env 파일 내용
+#   DOCKERHUB_USERNAME: DockerHub 사용자명
+#   DOCKERHUB_TOKEN: DockerHub 액세스 토큰
+#   SERVER_HOST: 배포 서버 주소
+#   SERVER_USER: SSH 사용자명
+#   SERVER_PASSWORD: SSH 비밀번호
+#   PROJECT_DEPLOY_PORT (선택): 배포 포트 (기본: 3000)
 
 name: PROJECT-REACT-CICD
 
@@ -38,18 +32,15 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. Node.js 개발 환경 설정
       - name: Node.js 설정
         uses: actions/setup-node@v7
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'npm'
 
-      # 3. 환경변수 파일 생성
       - name: 환경변수 파일 생성 (${{ env.ENV_FILE_NAME }})
         run: |
           cat << 'EOF' > ./${{ env.ENV_FILE_NAME }}
@@ -57,7 +48,6 @@ jobs:
           EOF
           echo "✅ ${{ env.ENV_FILE_NAME }} 파일 생성 완료"
 
-      # 4. npm 의존성 캐싱
       - name: npm 의존성 캐싱
         uses: actions/cache@v6
         with:
@@ -66,7 +56,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      # 5. node_modules 캐싱
       - name: node_modules 캐싱
         id: node-modules-cache
         uses: actions/cache@v6
@@ -76,12 +65,10 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-node-modules-
 
-      # 6. 의존성 설치
       - name: 의존성 설치
         if: steps.node-modules-cache.outputs.cache-hit != 'true'
         run: npm ci
 
-      # 7. Next.js 빌드 캐싱
       - name: Next.js 빌드 캐싱
         uses: actions/cache@v6
         with:
@@ -91,22 +78,18 @@ jobs:
             ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
             ${{ runner.os }}-nextjs-
 
-      # 8. 프로젝트 빌드
       - name: Build with npm
         run: npm run build
 
-      # 9. Docker 빌드 환경 설정
       - name: Docker 빌드환경 설정
         uses: docker/setup-buildx-action@v3
 
-      # 10. DockerHub 로그인
       - name: DockerHub 로그인
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
-      # 11. Docker 레이어 캐싱
       - name: Cache Docker layers
         uses: actions/cache@v6
         with:
@@ -115,7 +98,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-buildx-
 
-      # 12. Docker 이미지 빌드 및 푸시
       - name: Docker 이미지 빌드 및 푸시
         uses: docker/build-push-action@v5
         with:
@@ -126,7 +108,6 @@ jobs:
           cache-from: type=local,src=/tmp/.buildx-cache
           cache-to: type=local,dest=/tmp/.buildx-cache-new,mode=max
 
-      # 13. Docker 캐시 정리
       - name: Move Docker cache
         run: |
           rm -rf /tmp/.buildx-cache
@@ -148,9 +129,7 @@ jobs:
           script: |
             set -e
 
-            # ============================================================
             # 배포 환경 변수 설정
-            # ============================================================
             echo "🔧 환경변수 설정.."
             export PATH=$PATH:/usr/local/bin
             export PW=${{ secrets.SERVER_PASSWORD }}
@@ -161,9 +140,7 @@ jobs:
             # 프로젝트 설정
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
 
-            # ============================================================
             # 브랜치별 포트 및 컨테이너명 설정
-            # ============================================================
             # 기본값 설정
             PORT=3000
             CONTAINER_NAME="${PROJECT_NAME}-front"
@@ -178,7 +155,7 @@ jobs:
               echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
 
             else
-              # ⚠️ 기타 브랜치 (예상치 못한 브랜치)
+              # 기타 브랜치 (예상치 못한 브랜치)
               echo "⚠️ 지원하지 않는 브랜치입니다: $BRANCH"
               echo "이 워크플로우는 {{MAIN_BRANCH}} 브랜치만 지원합니다."
               echo "on.push.branches에서 지원할 브랜치를 설정하세요."
@@ -193,15 +170,11 @@ jobs:
             echo "  - 포트: $PORT"
             echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
 
-            # ============================================================
             # Docker 이미지 풀 (Pull)
-            # ============================================================
             echo "⬇️ Docker 이미지 풀: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
             echo $PW | sudo -S docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # ============================================================
             # 기존 컨테이너 정리
-            # ============================================================
             echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
 
             # 동일한 이름의 컨테이너가 존재하는지 확인
@@ -213,9 +186,7 @@ jobs:
               echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
             fi
 
-            # ============================================================
             # 새 컨테이너 실행
-            # ============================================================
             echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
 
             echo $PW | sudo -S docker run -d \
@@ -225,9 +196,7 @@ jobs:
               -v /etc/localtime:/etc/localtime:ro \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # ============================================================
             # 배포 완료 확인
-            # ============================================================
             echo "✅ 배포가 성공적으로 완료되었습니다!"
             echo ""
             echo "📋 배포 결과 요약:"
@@ -239,9 +208,7 @@ jobs:
             echo ""
             echo "🔗 접속 URL: http://${{ secrets.SERVER_HOST }}:${PORT}"
 
-# ===================================================================
 # 사용 예시 - {{MAIN_BRANCH}} 브랜치 사용
-# ===================================================================
 #
 # 현재 설정: {{MAIN_BRANCH}} 브랜치에 push할 때 자동 배포
 #
@@ -252,5 +219,4 @@ jobs:
 # - REACT_ENV_FILE, DOCKERHUB_*, SERVER_* (필수)
 # - PROJECT_DEPLOY_PORT (선택, 기본값: 3000)
 #
-# ===================================================================