Vercel 크론(Cron) 설정 완전 정리

1️⃣ 기본 구조 및 문법

Vercel은 표준 Cron 표현식 (* * * * *)을 그대로 사용합니다.

          ┌───────────── 분 (minute, 0–59)
          │ ┌───────────── 시 (hour, 0–23)
          │ │ ┌───────────── 일 (day of month, 1–31)
          │ │ │ ┌───────────── 월 (month, 1–12)
          │ │ │ │ ┌───────────── 요일 (day of week, 0–6, 일요일=0)
          │ │ │ │ │
          * * * * *
          

💡 예시표

🔹 특수기호 정리

2️⃣ 자주 사용하는 주기별 설정 예시

🕒 3시간 간격으로 실행

{
           "crons": [
             {
               "path": "/api/naver-ads-keyword-cpc-adjuster-cron-version",
               "schedule": "0 */3 * * *"
             }
           ]
          }
          

🗓 특정 요일·시간대 예시

• 0 9-18 * * 1-5 → 월~금 9시~18시, 매시간 정각 실행
• */15 14-16 * * 3 → 수요일 14~16시, 15분마다 실행

🕗 특정 시간 범위만 제어

• */30 8-20 * * * → 매일 8시~20시, 30분마다 실행
• * * * * * → 매일, 매분 실행

3️⃣ 크론 중단 및 비활성화 방법

Vercel의 vercel.json은 주석 처리나 비활성화 속성을 직접 지원하지 않습니다. 대신 다음 세 가지 방법 중 하나를 사용해야 합니다.

방법 ①: Dashboard에서 크론 항목 삭제

가장 확실하고 안전한 방법입니다. Vercel 프로젝트 대시보드에서 Cron 항목을 삭제하면 즉시 비활성화됩니다.

방법 ②: .env 설정으로 내부 제어

API 내부에서 ENABLE_CRON 값을 조건으로 확인하여 동작을 제어할 수 있습니다.

          export default async function handler(req, res) {
            const ENABLE_CRON = process.env.ENABLE_CRON === 'true';
            if (!ENABLE_CRON) {
              return res.status(200).send("Cron is temporarily disabled.");
            }
          
            // 실제 작업 수행
          }
          

# .env
          ENABLE_CRON=false
          

방법 ③: JSON 속성명 변경 (비권장)

"schedule" 키를 "schedule_"처럼 임의 변경하면 Vercel이 이를 인식하지 못해 실행되지 않지만, 이는 임시방편에 불과합니다.

4️⃣ 결론

• “* * * * *” 형식은 분·시·일·월·요일을 의미한다.
• 주기, 범위, 요일 조합으로 매우 정밀한 실행 주기 설정 가능.
• 주석으로 크론을 끄는 것은 불가능 → Dashboard 또는 ENABLE_CRON 변수로 제어.
• 3시간마다 실행하려면 → "schedule": "0 */3 * * *"