本文へ移動
KAIHATSU

定期処理の開発は、失敗通知と再実行まで含めて頼む

定期処理の開発を外注するなら、正常に動く条件だけでなく、重複起動、途中停止後の再開、遅延通知、実行履歴まで受入票で合意し、追加範囲を明確に分けて納品時に確認します。

執筆・確認株式会社adding 編集部

order-guide / contract

定期処理の開発を外注するときは、「毎晩集計する」「定期的にファイルを出力する」だけで見積もりを依頼しないことが大切です。失敗を何で判定し、誰に知らせ、どこから再実行し、重複した結果をどう防ぐかまで依頼範囲に含めます。

正常終了の確認だけでは、納品後に困る場面を取りこぼします。予定時刻を過ぎた処理、前回が終わらないまま次の時刻を迎えた処理、途中で止まった処理も受入対象です。ただし、すべてを自動復旧にすればよいわけではありません。業務上どこまでなら再実行でき、どこから人の判断が要るかを先に決める必要があります。

定期処理の開発を外注する前に、正常時の一文を分解する

「毎日、売上を集計して帳票を出す」という依頼には、まだ発注条件が足りません。日付の境界はどのタイムゾーンか、予定時刻に動けなかった回を後から開始してよいか、処理中に次の予定時刻が来たらどうするかが未確定だからです。

定期実行の基盤にも、こうした違いを扱う設定があります。2026年9月21日時点のKubernetes CronJob公式ドキュメントでは、実行スケジュールが必須で、タイムゾーンを専用フィールドで指定できます。指定しなければ、スケジュールはコントローラーのローカルタイムゾーンで解釈されます。また、開始が遅れた回に期限を設け、期限を過ぎた回をスキップして失敗扱いにする設定もあります。

これは特定製品の設定をそのまま発注書へ転記するという意味ではありません。外注先がどの実行基盤を選ぶ場合でも、業務側が期待結果を答えられる粒度まで依頼を分解するための材料です。前提全体の整理には、システム要件定義のチェック項目も併せて使えます。

見積依頼に添える「実行・復旧・記録」の判断表

以下は、運用上の提案です。見積依頼時に各行の「選ぶ条件」を発注者が記入し、外注先には実現方法と追加範囲を回答してもらいます。未確定の行を残す場合も、納品後に無償で決められる事項とは扱わず、誰がいつ決めるかを明記します。

判断欄見積依頼で選ぶ条件範囲を分ける問い納品時に見る結果
実行条件対象日、実行時刻、タイムゾーン、休日も実行するかカレンダーや対象日の判定は既存データで足りるか指定した日付境界と時刻で対象データが選ばれる
遅延した回遅れても開始する/業務上の締めを過ぎたら開始しない遅延の判定と通知は実行機能に含まれるか遅延時に開始またはスキップされ、その結果が残る
前回が実行中次回も許可する/次回を飛ばす/前回を止めて置き換える飛ばした回の対象を後から補う必要があるか選んだ方針どおりになり、対象回を識別できる
重複起動同じ対象を複数回処理しても二重計上・二重出力しない条件重複を防ぐ対象は集計、成果物、状態更新のどれか同じ対象で再度要求しても期待した結果になる
途中停止先頭からやり直す/処理済み地点から再開する/人が確認して選ぶ再開地点の保存や復旧操作が追加開発になるか一部処理済みの状態から指定した地点で復旧できる
失敗と再試行何を失敗とみなし、どの場合に再試行し、打ち切るか自動再試行と手動再実行の両方が必要か失敗、再試行、打ち切りの順序と結果を追える
通知遅延、失敗、打ち切りのどれを誰に知らせるか通知先や通知手段の設定変更を誰が行うか該当状態だけが決めた宛先へ通知される
実行履歴開始、終了、対象、結果、再実行との関係をどこで確認するか閲覧画面が必要か、既存の記録で確認できるか一連の処理を後からたどれる

この表の狙いは、機能名を並べることではなく、例外が起きたときの業務判断を発注前に表へ出すことです。たとえば「前回が実行中なら次回を飛ばす」を選んでも、飛ばした対象を翌回に含めるのか、未処理として担当者へ渡すのかは別の判断です。そこが決まらなければ、外注先は処理の終了条件も通知内容も確定できません。見積回答では各行に「含む」「追加範囲」「手動運用」のいずれかを記入してもらい、判断を保留した行だけを未確定事項として残します。

重複起動は、起こさない約束だけで受け入れない

定期処理では、「同じ時刻に一度だけ起動する設計」と「同じ対象が再度要求されても結果を壊さない設計」を分けて確認します。2026年9月21日時点のKubernetes公式資料では、同時実行について、許可する、前回実行中なら次回をスキップする、前回を置き換えるという方針が示されています。その一方で、同じ予定時刻に処理が複数作成されたり、一度も作成されなかったりする可能性を完全には排除できず、同じ要求を繰り返しても結果が壊れない「冪等」な処理にする必要があると説明されています。

運用上の提案として、受入票の「重複起動」には、単に「二重起動しない」と書かず、二重になってはいけない業務結果を書きます。集計なら同じ対象を二重計上しないこと、出力なら同じ対象の成果物が重複して後続へ渡らないこと、状態更新なら完了済みの対象をどう扱うかです。これは実装方式の指定ではなく、発注者が受け入れられる結果の指定です。

前回の処理が終わらないケースも、重複だけ見れば済む問題ではありません。2026年9月21日時点のGoogle Cloud Scheduler公式トラブルシューティングでは、処理が実行中または応答待ちの間、後続の予定実行は完了またはタイムアウトまでスキップされると説明されています。また、まれに同一処理の複数インスタンスが要求されるため、要求先には冪等性が求められます。

したがって納品時には、前回が残る条件と重複要求の条件を別々に作り、判断表で選んだ期待結果を確認します。どちらも「エラーにならない」だけでは不十分です。処理対象の欠損や重複がなく、履歴からどの回が実行・スキップ・再実行されたかを判別できるところまでが確認範囲です。

途中停止からの再開地点を、追加範囲かどうか判断する

途中停止後の復旧には、少なくとも三つの選択があります。先頭から全体をやり直す、処理済み地点を記録して続きから再開する、担当者が状態を確認して再開方法を選ぶ、です。どれが適切かは、同じ対象を再処理できるか、途中成果物を取り消せるか、処理済み地点を確実に特定できるかで変わります。

ここも運用上の提案です。見積依頼では、通常実行とは別に「途中停止後の再開」を一行で切り出し、外注先へ次の区分を回答してもらいます。

  • 通常の開発範囲に含む
  • 再開地点の保存や操作画面を含む追加範囲とする
  • 自動再開は含めず、手動復旧の手順を納品物にする

この区分があれば、再実行という言葉の中に、自動リトライ、続きからの再開、担当者によるやり直しが混在しません。見積条件をそろえる観点は、システム開発の見積もりで確認する項目にもつながります。

Google Cloud Schedulerの公式資料は、各実行の開始時と終了時にログが発行され、対象サービスから確認応答がない場合は失敗と判定し、設定した指数バックオフに従って再試行すると説明しています(2026年9月21日時点)。ただし、この挙動から「途中のどこから再開するか」まで自動的に決まるわけではありません。開始要求の再試行と、業務処理の再開地点を分けて発注条件にする必要があります。

失敗通知と実行履歴を同じものとして扱わない

通知は、担当者が対応を始めるきっかけです。実行履歴は、何が起きたかを後から確かめる台帳です。通知メールが残るから履歴は不要、監視画面に件数が出るから処理結果も追える、とは限りません。

2026年9月21日時点のAmazon EventBridge Scheduler公式ドキュメントでは、実行試行、対象エラー、再試行方針を使い切った後の打ち切り、デッドレターキューへの送信をメトリクスで区別し、しきい値アラームから通知できるとされています。一方、そのメトリクス配信はベストエフォートで、完全な実行記録を目的としたものではありません。

運用上の提案として、通知と履歴は受入票でも行を分けます。通知では、遅延・失敗・再試行打ち切りのどれを対象にし、誰が受け取った後に何を判断できるかを確認します。履歴では、少なくとも開始、終了、対象、結果、再実行との関係をたどれるかを確認します。監視メトリクスだけを完全な台帳とみなさず、業務上必要な追跡情報がどこに残るかを外注先と合意します。

納品時は判断表をそのまま受入票にする

運用上の提案として、見積依頼に使った判断表へ、外注先が採用した方式、確認に使う入力や状態、期待結果、確認結果を追記します。確認結果には合否だけでなく、実行履歴の識別情報と、通知を確認した場所を残します。これなら発注条件と受入条件が離れません。正常実行だけでなく、遅延、前回未完了、重複要求、途中停止、再試行打ち切りを確認対象にします。

定期処理の外注で最後に残すべきなのは、「毎晩動いた」という一度の確認ではありません。予定どおり開始できない回でも、表で選んだ条件に従って開始・スキップ・再実行が決まり、通知を受けた担当者が履歴から対象と結果を追える状態です。途中停止後の再開地点まで通常範囲に含むのか、追加開発にするのか、手動手順で引き渡すのかを見積もり前に分けておけば、失敗時の運用を納品後の相談へ先送りせずに済みます。

費用、期間、契約、法務・税務上の扱いは条件により異なります。記事の確認日とリンク先の一次情報を確認し、個別判断は専門家へご相談ください。

システム開発・発注ガイドへ戻る