サーバーWorkers料金・無料枠初期設定

Cloudflare Cron Triggersとは?定期実行の書き方と制限

フレアはゆるフレアはゆる
こんな人におすすめ
・毎日決まった時刻に処理を自動で動かしたい
・cron式を日本時間でどう書くか迷っている
・WorkflowsやQueuesとの違いを知りたい

Cloudflare Cron Triggers は、cron 式で決めた時刻に Worker の scheduled() を呼び出し、Cloudflare Workers のプログラムを自動で動かす機能です。サーバーを用意せずに、外部 API からのデータ取得や保守のような定期の仕事を置けます。無料プランでも使えます。

この記事では、仕組み、cron 式の書き方、料金と上限、Workflows・Queues との使い分け、始め方、注意点を扱います。時刻は UTC で動くため、日本時間からの書き直し方を詳しく説明します。仕様は Cron Triggers の公式ドキュメント をもとにしています。

この記事のゴール(読了目安 約8分)

Cron Triggersの仕組みと上限を知り、cron式をUTCで正しく書いて定期処理を始められるようになる

Cron Triggersとは:定期実行の機能

Cron Triggers は、cron 式(「毎時0分」のように、動かす時刻を5つの欄で書く書き方)を Worker の scheduled() ハンドラーに対応付け、決まった予定で Worker を動かす仕組みです。予定1つ分を Cron Trigger と呼びます。

Cloudflare Workers は、Cloudflare のネットワークでアプリを動かすサーバーレスの基盤です。2020年9月に Cron Triggers が発表されるまで、Worker は HTTP リクエストが届いたときにしか動きませんでした。リクエストが届かなくても、決めた時刻に Worker が動きます。 Workers そのものの仕組みと料金は、Cloudflare Workers の記事で解説しています。

公式の説明や例に出てくる使い道は次の4つです。

  • 外部 API を呼び、最新のデータを集める
  • KV や Durable Objects に保存した値を更新する
  • 保守の作業や通知の送信
  • 予約公開やバックアップ(CMS「EmDash」の例)

集めた値の置き場所には Workers KV が使えます。KV の仕組みは Workers KVとは で解説しています。Vercel の Cron Jobs の移り先も、公式の移行ガイドでは Cron Triggers です。

仕組み:scheduled()が呼ばれる流れ

設定した時刻(UTC)になると、Cloudflare が Worker の scheduled() を呼び出します。scheduled() ハンドラー(予定の時刻に呼ばれる関数)は次のものを受け取ります。

受け取るもの中身
controller.cron起動した Cron Trigger の式
controller.scheduledTime予定の時刻(1970年からのミリ秒)
envKV などのバインディング
ctxwaitUntil() を持つ

1つの Worker に複数の予定を書くと、どれも同じ scheduled() を呼びます。どの予定で起きたかは controller.cron で見分けます。 値は設定に書いた文字列と空白まで同じです。

ランタイムは scheduled() の処理が終わるのを15分まで待ちます。処理が1つなら waitUntil() は要らず、複数を同時に走らせるときに使います。実行する場所は、Cloudflare の中で空いているマシンです。

予定(cron 式)の時刻(UTC)になると Worker の scheduled() が呼ばれ、バインディングで KV や D1 などの保存先を読み書きする。実行の記録は Cron Events に残る
UTC の予定時刻に scheduled() が呼ばれ、実行の記録は Cron Events に残ります。

cron式の書き方と日本時間の換算

cron 式は5つの欄で書き、時刻は UTC(協定世界時)です。日本時間は UTC より9時間進んでいるので、9時間引いて書きます。

欄値使える記号
分0-59* , - /
時0-23* , - /
日1-31* , - / L W
月1-12、JAN などの略称* , - /
曜日1-7、MON などの略称* , - / L #

曜日の数字は 1=日曜〜7=土曜で、0=日曜とする一部の cron とは違います。曜日は数字より SUN・MON のような略称で書くと紛れません。 公式の例から抜き出すと次のとおりです(時刻は UTC)。

式意味
*/30 * * * *30分ごと
10 7 * * mon-fri平日の7:10
0 18 * * friL月の最後の金曜の18:00

L は月の最終日か最後の指定曜日、W は最も近い平日、# は何回目の曜日かを表します。29〜31日を指定すると、その日が無い月には動きません。

次の表は、日本時間の予定を UTC に直した編集部の計算例です(公式の例ではありません)。

日本時間UTCcron 式
毎朝9:00毎日0:000 0 * * *
毎日0:00前日の15:000 15 * * *
平日の朝8:00日〜木の23:000 23 * * SUN-THU
毎月1日の0:00前月の最終日15:000 15 L * *

9時間戻して日付をまたぐと、曜日や「1日」も前の日にずれます。 平日の朝なら曜日を日〜木に、月初なら日の欄を L にします。

左は動かしたい時刻の日本時間9:00、右はそれを UTC に直した cron 式 0 0 * * *。日本時間から9時間引いた UTC の0:00で書く
日本時間の毎朝9時に動かすなら、9時間引いた UTC の0時で書きます。

料金と無料プランの上限

2020年の発表時のブログは、Cron Triggers 自体に追加料金はかからないと説明しています。2026年11月時点の公式ページの上限と料金は次のとおりです。

項目Workers FreeWorkers Paid
Cron Triggers の数(アカウント)5250
1回の CPU 時間10ミリ秒30秒(間隔1時間以上は15分)
1回の経過時間15分15分
1回のサブリクエスト50既定10,000
リクエスト(Workers 全体)1日10万月1,000万込み、超過100万あたり0.30ドル
最低料金なし月5ドル

無料プランは Cron Triggers 5個、1回の CPU 時間10ミリ秒までです。 CPU 時間は計算している時間だけで、API や KV、データベースの応答待ちは数えません。経過時間(待ち時間を含めた始まりから終わりまで)は、どちらも15分が上限です。

料金ページには、有料プランで1時間に1回の Cron Trigger を動かし、レポートを作る Worker の試算例があります。実行1回を1リクエストとして月720リクエスト、1回の CPU 3分とした例で、月5ドルに CPU 時間の1.99ドルを足した月6.99ドルです。

Workflows・Queuesとの使い分け

時刻で Worker を短く動かすなら Cron Triggers で足ります。手順が多い、やり直したい、15分で終わらない定期処理は Workflows の schedules で組みます。

やりたいこと向く仕組み公式の説明
毎時・毎日の短い処理Cron Triggers1回の経過時間は15分まで
手順の多い定期処理Workflows の schedules失敗した処理を自動で再試行
利用者ごとに別の時刻を予約Durable Objects のアラームオブジェクトのコードから予約
1件の仕事を少し後に回すQueues の遅延最大24時間遅らせる

Workflows の schedules は2026年6月に加わり、cron 式を書くと時刻ごとに Workflow が起動します。公式はバックアップやレポートの集計を用途に挙げています。2026年11月時点の公式ページでは、schedules はアカウントあたり100個まで書けます。

手順ごとの再試行や待ち時間の仕組みは、Cloudflare Workflowsとは?手順を確実に進める仕組みと料金 で解説しています。キューにためて後から処理する流れは、Cloudflare Queuesとは で説明しています。

定期・予約の処理の4つの選択肢。決まった時刻に動かすなら Cron Triggers、手順と再試行が要るなら Workflows、対象ごとの予約は Durable Objects のアラーム、1件を少し後に回すなら Queues
時刻で動かすだけなら Cron Triggers、手順ややり直しが要るなら Workflows を選びます。

Cron Triggersの始め方

Cloudflare のアカウントと Node.js を用意し、Wrangler(Cloudflare の CLI)で次の5段を進めます。

  1. npm create cloudflare@latest -- my-first-worker でプロジェクトを作る(Hello World example → Worker only)
  2. コードに scheduled() を書く
  3. 設定ファイルの triggers に crons を書く
  4. 手元で scheduled() を呼んで試す
  5. npx wrangler deploy で公開し、Cron Events で確かめる

最小の形は次のとおりで、"0 * * * *" は毎時0分です。

export default {
	async scheduled(controller, env, ctx) {
		console.log("cron processed");
	},
};
{
  "triggers": {
    "crons": ["0 * * * *"]
  }
}

手元では予定の時刻が来ても動かないので、URL を呼んで1回ずつ試します。 公式の例ページの手順は次のとおりです。

npx wrangler dev --test-scheduled
curl "http://localhost:8787/cdn-cgi/local/scheduled?cron=*+*+*+*+*"

Wrangler 4.139.0 以上なら、Local Explorer(手元の開発中にブラウザで開く画面)からも試せます。ダッシュボードの Settings → Triggers → Cron Triggers からも予定を足せます。

使う前の注意点

本番で困りやすいのは、設定の反映・管理の場所・止め方・失敗の見つけ方の4つです。

  • 予定の追加・変更・削除が世界中の拠点に行き渡るまで、最大15分かかります。その間の実行は抜けることがあり、行き渡った後の次の時刻から動きます
  • Wrangler でデプロイすると、それまでの予定は設定ファイルの triggers の内容に置き換わります。Wrangler で管理するなら、予定は設定ファイルだけに書きます
  • 止めるときは crons を空の配列([])にしてデプロイします。crons の行をコメントアウトしても、Cron Trigger は止まりません
  • 失敗に気づく場所を公開前に確かめます。新しい Worker は、実行の記録が出るまで最大30分かかります

よくある質問

1分より短い間隔で動かせますか?

cron 式の5つの欄は「分」から始まり、公式の例で最も細かいのは毎分(* * * * *)です。1分より短い間隔を指定できるかは、公式ページで確認してください。

Cloudflare Pagesでも使えますか?

Pages Functions は Cron Triggers に対応していません。公式の機能の比較表でも Pages は対象外なので、定期処理は Workers で作ります。

1つのWorkerにいくつまで設定できますか?

Worker ごとに3つまでの上限は2023年10月に撤廃されました。複数の予定は controller.cron で分けます。2026年11月時点の公式ページでは、上限はアカウント全体で Free 5個、Paid 250個です。

実行に失敗したかはどこで確かめますか?

Worker の Settings → Trigger Events → View events で開く Cron Events に、直近100回分が残ります。それより前は Workers Logs で探します。waitUntil() を使う場合は、最初に失敗したものが状態として記録されます。

Pythonでも書けますか?

書けます。2025年4月から Python の Worker でも使え、WorkerEntrypoint を継承したクラスに scheduled メソッドを書きます。

この記事のポイント

  • cron式で決めた時刻にWorkerのscheduled()が呼ばれる仕組み
  • 時刻はUTC。日本時間から9時間引き、曜日や月末のずれにも注意
  • 無料プランは5個・CPU 10ミリ秒まで。1回の実行は最長15分
  • 手順が多くやり直しが要る定期処理はWorkflowsのschedulesへ

まとめ

Cron Triggers は、cron 式で決めた時刻に Worker の scheduled() を呼ぶ機能です。時刻は UTC なので、日本時間から9時間引き、曜日や月末のずれも確かめて書きます。2026年11月時点の公式ページでは、無料プランでもアカウントで5個まで使え、1回の実行は15分までです。

まずは1時間ごとの短い処理で scheduled() を書き、手元で /cdn-cgi/local/scheduled を呼んで試してから公開します。公開後は Cron Events で記録を見てください。手順が多くやり直しが要る定期処理は、Workflows の記事で仕組みを確かめてから選びます。

無料ダウンロード資料「Cloudflareが漫画でわかる」資料を受け取る

この記事を書いた人

フレアはゆる

編集長

フレアはゆるフレア ハユル

Cloudflare を知り尽くした(未来形)、フレアはゆるの編集長。Webサイト制作とサーバー運用の現場で Cloudflare を使い、迷ったところ・つまずいたところをそのまま記事にしています。

フレアはゆるについて詳しく見る →

サーバーの記事一覧へ戻る
フレアはゆるとははゆるに相談