Skip to content

関数をスケジュールで実行する ​

cron は 1 つのターゲットをスケジュールどおりに実行します。ターゲットは関数ランタイム、キャッシュの無効化、最新の ready な deployment の promote、Webhook 向けの cron.fired イベントのいずれかです。このページでは毎晩のレポートジョブを作り、確認、監視、一時停止、実行の方法を示します。

関数を実行する cron は、それだけではライブサイトを変えません。ターゲットが promote_latest か invalidate の cron は、実行されるたびにライブサイトを 変えます。

以降、distribution は acme-marketing(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)、関数ランタイムは 01JBQZ8XKT4A9WN2CDEFGH5RM7 とします。関数はジョブイベントを扱えるようになっている前提です。関数をバックグラウンドジョブとして試す を参照してください。

1. スケジュールを確かめる ​

何かを作る前に、スケジュールがいつ実行されるかを確認します。

text
acme-marketing で Asia/Tokyo の "0 2 * * *" はいつ実行される?次の 5 回を見せて。
bash
edge crons check acme-marketing --schedule '0 2 * * *' --tz Asia/Tokyo
bash
curl -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 と東京時間で返ります。

json
{
  "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 を作る ​

text
acme-marketing に nightly-report という cron を作って。関数 01JBQZ8XKT4A9WN2CDEFGH5RM7 を
毎日東京時間の 02:00 に実行し、失敗したら 1 回だけ再試行して。
bash
edge crons create acme-marketing --name nightly-report --schedule '0 2 * * *' \
  --tz Asia/Tokyo --function 01JBQZ8XKT4A9WN2CDEFGH5RM7 --retries 1
bash
curl -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 と次回の実行時刻があります。

json
{
  "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 には実行そのものが並びます。

text
acme-marketing の nightly-report cron の最近の実行を見せて。
bash
edge crons runs crn_01M4XA2B3C4D5E6F7G8H9J0K1M
bash
curl -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 回の実行をすぐに予約します。

text
nightly-report cron を今すぐ実行して、そのあと一時停止して。
bash
edge crons trigger crn_01M4XA2B3C4D5E6F7G8H9J0K1M
edge crons update crn_01M4XA2B3C4D5E6F7G8H9J0K1M --enabled false
bash
curl -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 回起こりうる理由と、関数を再実行しても安全にする方法は バックグラウンドジョブ を読んでください。