Cloudflare Cron Trigger, 예약 작업을 로컬 화면에서 미리 테스트합니다

매일 정해진 시각에 돌아가는 자동화라도, 테스트할 때까지 그 시각을 기다릴 필요는 없습니다. Cloudflare Workers의 Local Explorer에 Cron Trigger를 직접 실행하는 화면이 추가됐습니다. 날짜와 시간을 바꿔 같은 작업을 반복 점검하기 쉬워진 것이 핵심입니다.

Cloudflare가 2026년 10월 17일 공개한 기능입니다. 운영 서버의 예약 실행을 바꾼 소식은 아닙니다. 로컬 개발 중 Worker의 scheduled() 함수를 한 번씩 호출하고 결과를 살펴보는 도구입니다. 공식 발표

정해진 시각 대신 테스트할 시각을 고릅니다

Local Explorer에서 Worker를 선택한 뒤 Cron Triggers를 열면, 설정 파일에 등록한 예약식을 실행할 수 있습니다. 설정에 없는 예약식을 임시로 입력하는 것도 가능합니다. 예약식은 언제 실행할지를 나타내는 다섯 칸의 표현식이며, 시간 기준은 UTC입니다.

Scheduled time에는 현재 시각을 쓰거나 UTC 날짜·시각, 밀리초 단위 Unix 타임스탬프를 지정할 수 있습니다. 자주 확인할 시각은 프리셋으로 저장합니다. 실행이 끝나면 처리 결과와 noRetry() 호출 여부, 전달된 예약식·시각을 확인할 수 있습니다. 표시된 결과를 배포 환경에서의 실제 재시도 이력으로 해석하면 안 됩니다. Local Explorer 공식 문서

월말 집계나 날짜가 바뀌는 작업에 써볼 만합니다

예를 들어 하루 단위 보고서를 만드는 코드라면, 날짜가 바뀌기 직전과 직후의 시각을 각각 전달해 어느 날의 데이터를 선택하는지 살펴볼 수 있습니다. 매월 집계 작업이라면 짧은 달의 말일이나 연도가 바뀌는 시점을 테스트 사례로 둘 수 있습니다. 실제 성능을 측정한 사례가 아니라, 이 기능으로 구성할 수 있는 점검 방법입니다.

다만 지정한 scheduled time은 예약 이벤트에 전달되는 시각입니다. 프로그램 안의 모든 시간 조회나 외부 서비스까지 같은 시각으로 이동시킨다고 가정하면 안 됩니다. 날짜 계산이 이벤트의 시각을 사용하는지, 별도로 현재 시각을 읽는지 코드에서 함께 확인해야 합니다.

예약식의 29일·30일·31일은 해당 날짜가 없는 달에 실행되지 않을 수 있습니다. 반복 호출이 성공했다는 사실과 실제 예약식이 원하는 날을 가리킨다는 사실은 따로 점검하는 편이 안전합니다. 공식 문서도 날짜 범위에 따른 실행 제외를 안내합니다.

시작하기 전 버전과 실행 범위를 확인하세요

Cron Trigger 화면에는 Wrangler 4.139.0 이상 또는 Cloudflare Vite plugin 1.60.0 이상이 필요합니다. Worker에는 scheduled() 핸들러가 있어야 합니다. 설정된 예약식 목록을 사용하려면 현재 환경의 Cron 설정도 있어야 하지만, 임시 예약식으로 실행하는 데는 그 설정이 필수는 아닙니다.

개발 서버를 실행하고 /cdn-cgi/local/explorer를 연 다음, Worker의 Cron Triggers에서 예약식과 테스트 시각을 고르고 Trigger를 누릅니다. 자세한 로그와 추적 정보는 Observability를 켠 해당 Worker의 개발 세션에서 확인합니다.

여기서 세 가지 경계는 분명합니다.

• 로컬 개발 서버가 켜져 있어도 Cron 일정이 자동으로 실행되는 것은 아닙니다. 이 화면은 매번 수동으로 한 번씩 실행합니다.
• 임시 예약식과 시간 프리셋은 브라우저에 저장됩니다. Wrangler 설정이나 배포된 Cron 일정을 바꾸지 않습니다.
• 원격 바인딩을 연결했다면 실제 원격 리소스에 접근할 수 있습니다. 로컬 테스트라는 이름만 보고 외부 데이터에 영향이 없다고 단정하지 마세요.

자동화는 실행 버튼이 생기는 순간보다, 같은 조건을 다시 만들어 확인할 수 있을 때 관리하기 쉬워집니다. 이번 변화는 작은 개발 도구 개선이지만 예약 작업의 날짜 조건과 처리 결과를 한 화면에서 반복 점검하려는 팀에는 쓸모가 있습니다. 배포 전에는 이 로컬 결과에 더해 실제 예약 설정과 외부 연결 대상도 따로 검토해야 합니다.

관련 글: AI 코드 리뷰에서 검증 흐름을 설계하는 방법

기준일: 2026년 10월 19일. 공식 발표와 현재 문서를 바탕으로 정리했으며 실제 제품 사용 경험이나 성능 측정 결과를 담은 글은 아닙니다.