크론 작업

배포 루트의 nitroship.json 또는 vercel.json에 crons를 선언하면 현재 프로덕션 배포의 경로로 예약된 GET 요청을 보냅니다. 프리뷰 배포는 실행하지 않습니다.

{
  "crons": [
    {"path": "/api/cron?source=scheduled", "schedule": "0 5 * * *"}
  ]
}

시간은 UTC이고 5개 필드(분·시·일·월·요일)를 사용합니다. 숫자, *, 범위, 목록, 간격 표현식을 지원합니다. 월·요일 이름, @daily 같은 별칭, 초를 포함한 6개 필드는 지원하지 않습니다. 일과 요일을 모두 * 이외 값으로 제한할 수 없습니다. 경로는 /로 시작해야 하며 쿼리 문자열을 포함할 수 있습니다. 최대 100개까지 선언할 수 있습니다.

작업이 실행되지 못한 시각은 건너뛰며 자동 재시도하지 않습니다. 요청의 User-Agent는 nitroship-cron/1.0이지만 이를 인증 수단으로 사용하지 않습니다. 프로덕션 환경 변수에 CRON_SECRET을 설정하면 예약 요청은 Authorization: Bearer <CRON_SECRET>을 전달합니다. 엔드포인트에서 이 값을 검사하고, 환경 변수를 설정한 후 새 배포를 생성합니다. GET /v1/apps/{appId}/crons에서 현재 프로덕션 배포의 일정을 조회할 수 있습니다.