関数をスケジュールで実行する
cron は 1 つのターゲットをスケジュールどおりに実行します。ターゲットは関数ランタイム、キャッシュの無効化、最新の ready な deployment の promote、Webhook 向けの cron.fired イベントのいずれかです。このページでは毎晩のレポートジョブを作り、確認、監視、一時停止、実行の方法を示します。
関数を実行する cron は、それだけではライブサイトを変えません。ターゲットが promote_latest か invalidate の cron は、実行されるたびにライブサイトを 変えます。
以降、distribution は acme-marketing(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)、関数ランタイムは 01JBQZ8XKT4A9WN2CDEFGH5RM7 とします。関数はジョブイベントを扱えるようになっている前提です。関数をバックグラウンドジョブとして試す を参照してください。
1. スケジュールを確かめる
何かを作る前に、スケジュールがいつ実行されるかを確認します。
acme-marketing で Asia/Tokyo の "0 2 * * *" はいつ実行される?次の 5 回を見せて。edge crons check acme-marketing --schedule '0 2 * * *' --tz Asia/Tokyocurl -s -X POST https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/crons/check \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"schedule": "0 2 * * *", "timezone": "Asia/Tokyo"}'エージェントは edge_cron_check を実行します。各実行時刻が UTC と東京時間で返ります。
{
"schedule": "0 2 * * *",
"timezone": "Asia/Tokyo",
"next_runs": [
{ "at": "2026-10-19T17:00:00+00:00", "local": "2026-10-20T02:00:00+09:00" },
…
]
}フィールド、エイリアス、タイムゾーンの規則は cron の書式 にあります。
2. cron を作る
acme-marketing に nightly-report という cron を作って。関数 01JBQZ8XKT4A9WN2CDEFGH5RM7 を
毎日東京時間の 02:00 に実行し、失敗したら 1 回だけ再試行して。edge crons create acme-marketing --name nightly-report --schedule '0 2 * * *' \
--tz Asia/Tokyo --function 01JBQZ8XKT4A9WN2CDEFGH5RM7 --retries 1curl -s -X POST https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/crons \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "nightly-report",
"schedule": "0 2 * * *",
"timezone": "Asia/Tokyo",
"target": {"type": "wasm", "script_id": "01JBQZ8XKT4A9WN2CDEFGH5RM7"},
"retries": 1
}'エージェントは edge_cron_create を実行します。応答には cron_id と次回の実行時刻があります。
{
"cron_id": "crn_01M4XA2B3C4D5E6F7G8H9J0K1M",
"name": "nightly-report",
"enabled": true,
"next_run_at": "2026-10-19T17:00:00+00:00",
"next_run_local": "2026-10-20T02:00:00+09:00",
…
}実行のたびに、バックグラウンドランナー上の関数に /_jobs/cron/nightly-report への POST が届き、関数のバックグラウンドタイムアウトまで処理できます。
既定では、前回の実行がまだ続いていると今回の実行は スキップ されます。並行して実行させるには overlap を allow にします。ほかのターゲットは --emit(cron.fired イベント)、--invalidate /news/*(キャッシュ済みパスの更新)、--promote-latest、--enqueue orders(キュー にメッセージを 1 件送る)、--start-workflow 01JBQZ8XKT4A9WN2CDEFGH5RM7(ワークフロー の実行を開始する)です。
3. 実行を見守る
Web アプリで Distributions を開き、acme-marketing を選びます。Crons には各 cron のスケジュール、cron のタイムゾーンでの次回実行時刻、前回の結果が表示されます。Background jobs には実行そのものが並びます。
acme-marketing の nightly-report cron の最近の実行を見せて。edge crons runs crn_01M4XA2B3C4D5E6F7G8H9J0K1Mcurl -s https://api.edge.deca-dev.com/v1/crons/crn_01M4XA2B3C4D5E6F7G8H9J0K1M/runs \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_cron_runs を実行します。実行の status は queued、running、succeeded、failed、skipped(前回の実行が続いていた)、missed(1 日以上遅れて到達した)のいずれかです。再試行できる失敗は、cron の retries の範囲で 30 秒後、2 分後、10 分後にもう一度実行されます。
4. 今すぐ実行する、一時停止する、再開する
Web アプリの Crons 一覧には Run now と Pause / Resume があります。Run now はスケジュールを変えずに 1 回の実行をすぐに予約します。
nightly-report cron を今すぐ実行して、そのあと一時停止して。edge crons trigger crn_01M4XA2B3C4D5E6F7G8H9J0K1M
edge crons update crn_01M4XA2B3C4D5E6F7G8H9J0K1M --enabled falsecurl -s -X POST https://api.edge.deca-dev.com/v1/crons/crn_01M4XA2B3C4D5E6F7G8H9J0K1M/trigger \
-H "Authorization: Bearer $EDGE_TOKEN"
curl -s -X PATCH https://api.edge.deca-dev.com/v1/crons/crn_01M4XA2B3C4D5E6F7G8H9J0K1M \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"enabled": false}'エージェントは edge_cron_trigger と edge_cron_update を実行します。一時停止した cron には次回実行がありません。再開すると、今から数えて次の実行が予約されます。停止中にスキップした分を取り戻すことはしません。
5. 失敗を知らせてもらう
Webhook を cron.run.failed(再試行も残っていない失敗)と cron.run.missed に購読させます。Edge のイベントを Webhook に送る を参照してください。
次に
実行が 2 回起こりうる理由と、関数を再実行しても安全にする方法は バックグラウンドジョブ を読んでください。