workflow-builder

ワークフロービルダー — 単発のアダプター作成

呼び出し元が明示的に指定した独立した操作一式をディスパッチする必要がある場合に限り、薄いアダプターを構築してください。ワークフローは利便性のためのコードであり、正しさやライフサイクルを決定する権限を持つものではありません。

明示的な入力に対する最大1回のディスパッチだけが、安全性の根拠です。再試行や作業の選択ができないワークフローでは、障害が連鎖的に拡大しないため、最悪の場合でも各操作につきエラーが1件報告されるだけです。

失敗モードの名称 — フレームワークの引力：単発スクリプトが、要求されていないオーケストレーターになるまで、設定ファイル、プラグインフック、状態ストアを次々に追加してしまうことです。

アンチパターン：「堅牢性のためだけ」として、失敗時の再試行を追加することです。是正策：操作ごとのエラーを報告して停止します。その後もう一度実行するかどうかは、呼び出し元が決めます。

契約

• 入力、実行器、書き込み範囲、出力は明示的に指定します。
• 各操作は最大1回だけディスパッチします。
• 並列操作では、書き込み範囲が重複しないことを呼び出し元が確認している必要があります。
• ワークフローは操作ごとの出力またはエラーを報告してから停止します。
• 作業の選択、再試行、予算、キュー、追跡、検証、Git、統合、クローズ、リリース、配信に関するロジックは含めません。
• オプションの基盤状態をRPI状態や判定状態に変換することはできません。

対象の実行環境で動作する最小限のスクリプトを優先してください。ディスパッチ回数とエラー報告を正確に示すドライランまたはフィクスチャを含めてください。呼び出し元から明示的に依頼されない限り、新たなフレームワークやSDKの抽象化を作成しないでください。