project-auto-wizard 0.11.0 → 0.12.1

package/payload/workflows/go/PROJECT-GO-SIMPLE-CICD.yaml

@@ -1,58 +1,27 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Go 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 액세스 토큰
-# SERVER_HOST: 배포 서버 주소
-# SERVER_USER: SSH 사용자명
+# DOCKERHUB_USERNAME / DOCKERHUB_TOKEN: DockerHub 사용자명 / 액세스 토큰
+# SERVER_HOST / SERVER_USER: 배포 서버 주소 / SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
-#
-# 🔧 환경변수 설정 (env 섹션에서 설정)
-# ===================================================================
 #
-# 🌐 포트 및 컨테이너:
-# CONTAINER_INTERNAL_PORT: Go 앱 내부 포트 (기본: 8080)
-# DEPLOY_PORT: 배포 포트
+# 환경변수 (env 섹션에서 설정)
+# CONTAINER_INTERNAL_PORT: Go 앱 내부 포트 (기본: 8080) / 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)
-#
-# ⏱️ 헬스체크:
+# ENABLE_VOLUME_MOUNT (true/false), VOLUME_HOST_PATH, VOLUME_CONTAINER_PATH: 볼륨 마운트
+# SSH_PORT (기본: 2022), SSH_COMMAND_TIMEOUT (기본: 600s), SSH_CONNECTION_TIMEOUT (기본: 60s)
 # HEALTHCHECK_WAIT_SECONDS: 초기화 대기 시간 (기본: 10초)
-# HEALTHCHECK_PATH: HTTP 엔드포인트 경로 (비어있으면 로그만 사용)
-# HEALTHCHECK_MAX_RETRIES: HTTP 재시도 횟수 (기본: 5회)
-# HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 (기본: 3초)
+# HEALTHCHECK_PATH: HTTP 엔드포인트 경로 (비어있으면 로그만 사용, 예: "/health", "/api/v1/health")
+# HEALTHCHECK_MAX_RETRIES: HTTP 재시도 횟수 (기본: 5회) / HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 (기본: 3초)
 # HEALTHCHECK_LOG_PATTERN: Fallback 로그 검색 패턴
-#
-# 💡 HEALTHCHECK_PATH 예시:
-#   Go (net/http 등): "/health"
-#   커스텀: "/api/v1/health"
-# ===================================================================
 
 name: PROJECT-GO-SIMPLE-CICD
 
-# ===================================================================
-# 트리거 설정
-# ===================================================================
 on:
   push:
     branches:
@@ -60,38 +29,32 @@ on:
     # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
   workflow_dispatch:  # 수동 실행 허용
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
   # 프로젝트 고유 식별자
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
 
-  # 🌐 포트 설정
   DEPLOY_PORT: "__DEPLOY_PORT__"  # @wizard ask:8080
 
-  # 🐳 컨테이너 이름 설정 (비워두면 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_PORT: "__SSH_PORT__"  # @wizard ask:2022
   SSH_COMMAND_TIMEOUT: "600s"  # SSH 명령 실행 타임아웃
   SSH_CONNECTION_TIMEOUT: "60s"  # SSH 연결 타임아웃
 
-  # 🌐 컨테이너 포트 설정
   CONTAINER_INTERNAL_PORT: "8080"  # Go 앱 내부 포트
 
-  # ⏱️ 헬스체크 설정
+  # 헬스체크 설정
   HEALTHCHECK_WAIT_SECONDS: "10"  # 컨테이너 초기화 대기 시간 (초)
   HEALTHCHECK_PATH: "/health"  # HTTP 엔드포인트 경로 (비어있으면 로그 패턴만 사용)
   HEALTHCHECK_MAX_RETRIES: "5"  # HTTP 재시도 횟수
@@ -99,19 +62,15 @@ env:
   HEALTHCHECK_LOG_PATTERN: "listening on"  # Fallback 로그 검색 패턴 (프로젝트 로그 문구에 맞게 조정)
 
 jobs:
-  # ===================================================================
-  # 빌드 작업
-  # ===================================================================
+  # Job: 빌드
   build:
     name: Go 애플리케이션 빌드
     runs-on: ubuntu-latest
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. 디스크 공간 확보
       - name: 디스크 공간 확보
         run: |
           echo "📊 빌드 전 디스크 사용량:"
@@ -129,7 +88,6 @@ jobs:
           echo "📊 정리 후 디스크 사용량:"
           df -h
 
-      # 3. .env 파일 생성
       - name: .env 파일 생성
         run: |
           cat > .env << 'EOF'
@@ -137,18 +95,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 +115,6 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-      # 7. 빌드 후 정리
       - name: 빌드 후 정리
         if: always()
         run: |
@@ -169,16 +123,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 +146,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 +162,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 +179,6 @@ jobs:
 
             echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
 
-            # 설정 정보 출력
             echo "📋 배포 설정 정보:"
             echo "  - 브랜치: $BRANCH"
             echo "  - 프로젝트: $PROJECT_NAME"
@@ -243,18 +186,13 @@ jobs:
             echo "  - 포트: $PORT"
             echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}"
 
-            # ============================================================
-            # Docker 이미지 풀 (Pull)
-            # ============================================================
+            # Docker 이미지 풀
             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 +201,17 @@ 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 +229,7 @@ jobs:
               $VOLUME_OPTS \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}
 
-            # ============================================================
             # 컨테이너 헬스체크
-            # ============================================================
             echo "⏳ 컨테이너 초기화 대기 중... (${{ env.HEALTHCHECK_WAIT_SECONDS }}초)"
             sleep ${{ env.HEALTHCHECK_WAIT_SECONDS }}
 
@@ -364,14 +296,11 @@ jobs:
               fi
             fi
 
-            # 최종 성공 메시지
             if [ "$HEALTHCHECK_SUCCESS" = "true" ]; then
               echo "✅ 헬스체크 완료: 컨테이너 $CONTAINER_NAME 이(가) 정상적으로 실행 중입니다"
             fi
 
-            # ============================================================
             # 배포 완료 확인
-            # ============================================================
             echo "✅ 배포가 성공적으로 완료되었습니다!"
             echo ""
             echo "📋 배포 결과 요약:"

package/payload/workflows/next/PROJECT-NEXT-CI.yaml

@@ -1,30 +1,14 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
-# Next.js CI (코드 분석 및 빌드 검증)
-# ===================================================================
+# Next.js CI (빌드 검증)
+# {{MAIN_BRANCH}} 브랜치 푸시 시 npm ci와 npm run build로 빌드를 검증합니다. node_modules와 .next/cache를 캐싱합니다.
 #
-# {{MAIN_BRANCH}} 브랜치 푸시 시 Next.js 애플리케이션의 빌드를 검증합니다.
+# GitHub Secrets
+#   ENV_FILE (선택): .env 파일 내용. CI는 빌드 검증 목적이므로 배포 관련 Secrets는 불필요
 #
-# 주요 특징:
-# - npm ci로 의존성 설치
-# - npm run build로 빌드 검증
-# - Next.js 증분 빌드 캐싱 (.next/cache)
-# - 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-NEXT-CI
 
@@ -46,9 +30,7 @@ permissions:
   issues: write
 
 jobs:
-  # ===================================================================
-  # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
-  # ===================================================================
+  # Job: 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -77,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:
@@ -103,7 +81,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      # 5. node_modules 캐싱
       - name: node_modules 캐싱
         id: node-modules-cache
         uses: actions/cache@v6
@@ -113,7 +90,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-node-modules-
 
-      # 6. 의존성 설치
       - name: 의존성 설치
         if: steps.node-modules-cache.outputs.cache-hit != 'true'
         run: |
@@ -121,7 +97,7 @@ jobs:
           npm ci
           echo "✅ 의존성 설치 완료"
 
-      # 7. Next.js 빌드 캐싱 (.next/cache)
+      # Next.js 빌드 캐싱 (.next/cache)
       # 증분 빌드를 위해 .next/cache 폴더를 캐싱합니다
       - name: Next.js 빌드 캐싱
         uses: actions/cache@v6
@@ -132,7 +108,6 @@ jobs:
             ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
             ${{ runner.os }}-nextjs-
 
-      # 8. 프로젝트 빌드 (SSR/SSG)
       - name: 프로젝트 빌드
         id: build
         run: |
@@ -162,7 +137,6 @@ jobs:
             du -sh .next/ || true
           fi
 
-      # 9. 빌드 실패 시 에러 로그 출력
       - name: 빌드 에러 로그 출력
         if: steps.build.outputs.build_failed == 'true'
         run: |
@@ -181,7 +155,6 @@ jobs:
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
           exit 1
 
-      # 10. 빌드 로그 아티팩트 업로드
       - name: 빌드 로그 업로드
         if: always()
         uses: actions/upload-artifact@v7
@@ -190,7 +163,6 @@ jobs:
           path: build_log.txt
           retention-days: 7
 
-      # 11. 빌드 결과 요약
       - name: 빌드 결과 요약
         if: always()
         run: |
@@ -213,9 +185,7 @@ jobs:
           echo ""
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-  # ===================================================================
-  # CI Gate (required check로 등록할 단일 job)
-  # ===================================================================
+  # Job: CI Gate (required check로 등록할 단일 job)
   ci-gate:
     name: CI Gate
     if: ${{ always() }}

package/payload/workflows/next/PROJECT-NEXT-CICD.yaml

@@ -1,22 +1,15 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Next.js CI/CD 배포
-# ===================================================================
+# {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고 배포합니다. SSR 지원을 위해 Node.js 런타임 컨테이너로 배포됩니다.
 #
-# {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고 배포합니다.
-# SSR 지원을 위해 Node.js 런타임 컨테이너로 배포됩니다.
-#
-# ===================================================================
-# 🔑 필수 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-NEXT-CICD
 
@@ -39,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 }}
@@ -58,7 +48,6 @@ jobs:
           EOF
           echo "✅ ${{ env.ENV_FILE_NAME }} 파일 생성 완료"
 
-      # 4. npm 의존성 캐싱
       - name: npm 의존성 캐싱
         uses: actions/cache@v6
         with:
@@ -67,7 +56,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      # 5. node_modules 캐싱
       - name: node_modules 캐싱
         id: node-modules-cache
         uses: actions/cache@v6
@@ -77,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 빌드 캐싱 (.next/cache)
       - name: Next.js 빌드 캐싱
         uses: actions/cache@v6
         with:
@@ -92,22 +78,18 @@ jobs:
             ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
             ${{ runner.os }}-nextjs-
 
-      # 8. 프로젝트 빌드 (SSR/SSG)
       - 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:
@@ -116,7 +98,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-buildx-
 
-      # 12. Docker 이미지 빌드 및 푸시
       - name: Docker 이미지 빌드 및 푸시
         uses: docker/build-push-action@v5
         with:
@@ -127,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
@@ -149,9 +129,7 @@ jobs:
           script: |
             set -e
 
-            # ============================================================
             # 배포 환경 변수 설정
-            # ============================================================
             echo "🔧 환경변수 설정.."
             export PATH=$PATH:/usr/local/bin
             export PW=${{ secrets.SERVER_PASSWORD }}
@@ -159,9 +137,7 @@ jobs:
             BRANCH=${{ github.ref_name }}
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
 
-            # ============================================================
             # 브랜치별 포트 및 컨테이너명 설정
-            # ============================================================
             PORT=3000
             CONTAINER_NAME="${PROJECT_NAME}-nextjs"
 
@@ -181,15 +157,11 @@ jobs:
             echo "  - 포트: $PORT"
             echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
 
-            # ============================================================
             # Docker 이미지 풀 (Pull)
-            # ============================================================
             echo "⬇️ Docker 이미지 풀..."
             echo $PW | sudo -S docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # ============================================================
             # 기존 컨테이너 정리
-            # ============================================================
             echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
 
             if sudo docker ps -a --format '{{.Names}}' | grep -Eq "^${CONTAINER_NAME}\$"; then
@@ -200,9 +172,7 @@ jobs:
               echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
             fi
 
-            # ============================================================
             # 새 컨테이너 실행
-            # ============================================================
             echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
 
             # Next.js는 SSR을 위해 Node.js 서버가 필요합니다
@@ -216,9 +186,7 @@ jobs:
               --restart unless-stopped \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # ============================================================
             # 배포 완료 확인
-            # ============================================================
             echo "✅ 배포가 성공적으로 완료되었습니다!"
             echo ""
             echo "📋 배포 결과 요약:"
@@ -230,9 +198,7 @@ jobs:
             echo ""
             echo "🔗 접속 URL: http://${{ secrets.SERVER_HOST }}:${PORT}"
 
-# ===================================================================
 # Next.js Dockerfile 예시 (standalone 모드)
-# ===================================================================
 #
 # # Stage 1: Dependencies
 # FROM node:20-alpine AS deps
@@ -264,9 +230,7 @@ jobs:
 # ENV PORT 3000
 # CMD ["node", "server.js"]
 #
-# ===================================================================
 # next.config.js에 standalone 설정 추가:
 # module.exports = {
 #   output: 'standalone',
 # }
-# ===================================================================