Skip to content

バックグラウンドジョブ ​

Edge の大半は訪問者に応答します。リクエストが届き、関数が最長 5 秒動き、訪問者がレスポンスを受け取ります。この形に収まらない処理もあります。毎晩のレポート、他サービスからの取り込み、応答の遅いモデル API の呼び出しは、訪問者がいないか、ページを待つには長すぎます。そうした処理を実行するのが バックグラウンドジョブ です。

訪問者のリクエストGET /_api/reportバックグラウンドジョブPOST /_jobs/cron/nightlyあなたの関数同じアーティファクトリクエストランナー5 s · 64 MiB · 4 callsバックグラウンドランナー300–840 s · 256 MiB · 100 calls訪問者に応答ジョブ実行履歴に記録
同じ関数が 2 つのランナーのどちらかで実行されます。訪問者のリクエストがバックグラウンドランナーに届くことはなく、ジョブが訪問者向けの予算を使うこともありません。

1 つのエンジン、複数の起動方法 ​

ジョブは 1 つの ターゲット の 1 回の実行です。たいていは関数ランタイムで、キャッシュ済みパスの無効化、最新の ready な deployment の promote、Webhook への イベント 送信といったプラットフォームの操作のこともあります。ジョブを 起動するもの と、ジョブが実行するものは別です。cron はスケジュールどおりにジョブを起動します。キュー は、コンシューマーに渡すメッセージのバッチごとにジョブを 1 つ起動します。ワークフロー はステップごとに 1 つ起動します。フック を使えば、他サービスの Webhook から直接キューやワークフローに渡せます。ランナー、再試行の規則、すべての実行の記録は共通です。

関数をジョブとして実行して試すことは、いまでもできます。関数をバックグラウンドジョブとして試す を参照してください。

ジョブには専用のランナーがある ​

ジョブは訪問者のリクエストと同じコンパイル済みの関数を、別の バックグラウンドランナー で実行します。ジョブには既定で 300 秒、関数が background_timeout_seconds で求めれば最大 840 秒が与えられます。メモリと外向き呼び出しも多めです。数値は 上限 にあります。

2 つのランナーは意図して分けています。訪問者のリクエストがバックグラウンドランナーに届くことはないので、公開の /_api パスから 14 分の計算を始めることはできません。ジョブが訪問者向けの処理能力を使うこともないので、バックグラウンドの処理が集中してもサイトは遅くなりません。組織ごとに同時に動くジョブは最大 4 つです。

ジョブは 2 回以上実行されることがある ​

Edge はジョブを実行する前に記録し、終わったあとに結果を記録します。ジョブを動かしているマシンが途中で止まった場合、Edge はジョブを失うのではなくもう一度実行します。つまり配信は 少なくとも 1 回(at least once) で、Webhook と同じ約束です。

ジョブのイベントには必ず job_id が入っていて、同じジョブは再実行されても同じ ID のままです。関数がカード決済、メール送信、レコードの書き込みを行うなら、その副作用を job_id をキーにして、2 回目の実行ではすでに済んでいるとわかるようにしてください。attempt で再試行かどうかがわかります。

再試行する価値のある失敗 ​

失敗したジョブがもう一度実行されるかどうかは、失敗の理由で決まります。タイムアウト、ランナーの混雑、関数が返した 5xx は次は成功するかもしれないので、ジョブを起動したものの規則に従って再試行されます。fuel やメモリの不足、トラップ、関数が返した 4xx は同じように失敗するだけなので、再試行されません。テスト実行は再試行されません。

すべての実行が記録される ​

1 回の実行は ジョブ実行(job run) として記録されます。何が起動したか、何を実行したか、状態、エラーコード、そしてかかったコスト(fuel、所要時間、外向き呼び出し)です。ジョブ実行は 30 日間保持されます。Web アプリの distribution パネルには最近のものが表示され、CLI と API ですべてを一覧できます。ジョブ中に関数が出した stdout と stderr は、ほかの実行と同じくランタイムログにあります。