Fail-Fast vs Continue-on-Error: CIの停止方法を制御する
fail-fastは何かが失敗した瞬間に停止して時間を節約します。continue-on-errorは失敗を押し通してより多くの情報を集めます。両者は正反対の問いに答え - 適用されるレベルも異なります。
この2つの設定はpipelineが失敗にどう反応するかを形づくります。速度のために早期に打ち切るか、網羅性のために続行するかです。両者は異なるスコープで動作し、混同すると無駄な時間か隠れた失敗のどちらかにつながります。
Fail-fast(matrix/strategyレベル)
fail-fastは1つが失敗するとすぐに残りの並列jobをキャンセルします。どの失敗も変更全体がダメであることを意味する場合に分を節約します。欠点は、最初に失敗した組み合わせしか分からず、そのバグが特定のOSやバージョンに固有かどうかは分からないことです。pass/failの全グリッドが欲しいときは無効にしましょう。
Continue-on-error(step/jobレベル)
continue-on-errorはstepまたはjobにマークを付け、その失敗が実行を失敗させないようにします - pipelineは続行し、全体としては成功と報告します。重要でない、あるいは情報提供的なstep(オプションのlinter、実験的なmatrixのレッグ)で、結果は記録したいがgateにはしたくない場合に使います。
Non-gating step
- run: ./optional-linter.sh
continue-on-error: true両者は互いの反対ではない
よくある混乱です。fail-fastは失敗時に*兄弟job*がキャンセルされるかどうかを制御し、continue-on-errorは*特定のstep/jobの*失敗が実行にカウントされるかどうかを制御します。fail-fastを無効にして(すべての組み合わせを実行して)も、一部のstepをgateにし、他をそうしないことができます。
選び方
- どの失敗も変更全体を無効にするとき(高速なフィードバック)はfail-fastを使う。
- すべての組み合わせの結果を見る必要があるときはfail-fastを無効にする。
- 本当にオプションで情報提供的なstepにのみcontinue-on-errorを使う。
- 本来gateにすべきstepを取り繕うためにcontinue-on-errorを決して使わない。
重要なポイント
- fail-fastは最初の失敗で兄弟jobをキャンセルして時間を節約します。
- continue-on-errorはstep/jobの失敗が実行全体を失敗させないようにします。
- 両者は異なるスコープで動作し - 互いの逆ではありません。
- continue-on-errorはオプションのstep向けであり、本物のgateを隠すためではありません。
関連ガイド
What Is a Build Matrix? Testing Across Versions and PlatformsA build matrix runs the same job across many combinations - OS, language version, dependency set. Learn how m…
What Is Fan-Out / Fan-In in CI Pipelines?Fan-out splits work into many parallel jobs; fan-in collects their results into one. Learn this core pipeline…
Retries and Idempotency in CI: Retry Safely Without Side EffectsRetrying a failed step only helps if the step is idempotent - safe to run twice. Learn what idempotency means…