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