decisiondecided

CIをハイブリッド構成で間引き実行する

GitHub Actions の無料枠を約4日で使い切る問題に対し、軽量チェックは毎push・重いCIは3回に1回+PR+手動のハイブリッド構成を採用する。

コンテキスト

mainブランチへのpushごとにCIがフル実行され、月の無料枠を約4日で使い切る状態になっている。開発を止めずに消費量を下げたい。

制約と前提:

  • 開発者は「pushする/しない」を判断したくない(バンバンpushしたい)
  • マージ前の安全性は担保したい
  • 緊急時にフルCIを即実行できる逃げ道が欲しい

選択肢

選択肢A: 現状維持 + concurrency キャンセルのみ

連続pushの古い実行をキャンセルする最小構成。

  • ○ 実装が最も簡単
  • ○ バグ発見が遅れない
  • × 単発pushが多いと効果が薄く、4日→1〜2週間程度の延命にとどまる見込み

選択肢B: 全CIを一律に間引く(N回に1回)

コミット数ベースで全CIを間引く。

  • ○ 消費量が1/N近くまで下がる
  • ○ 開発者は何も意識しない
  • × Lintレベルのミスも間引かれて気付けない
  • × PR時の安全確認まで間引かれる危険

選択肢C: スケジュール実行(nightly化)

毎pushをやめて1日1回にする。

  • ○ 消費量を劇的に削減できる
  • × pushと実行がかけ離れ、原因特定が困難
  • × 開発フィードバックループが悪化

選択肢D: ハイブリッド構成(軽量=毎回 / 重量=間引き)★採用

Lint等の軽量チェックは毎push、テスト・ビルド等の重い処理は3回に1回+PR+手動実行。

  • ○ 消費量が大きく下がる(重い処理が1/3)
  • ○ 壊れたコードは毎pushで検出できる
  • ○ PRでは必ずフル実行されマージ前の安全性を担保
  • ○ [ci] コミットメッセージと workflow_dispatch で逃げ道あり
  • △ ワークフロー定義がやや複雑になる

決定

選択肢D(ハイブリッド構成)を採用する。

構成:

層内容頻度
軽量チェックLint・構文チェック毎push
重いCIテスト・ビルド3回に1回 + PR + 手動
共通concurrency キャンセル・paths-ignore常時

間引き頻度は当初5回に1回も検討したが、障害検知が最大4コミット遅れるのはリスクが大きいと判断し、節約効果と検知遅延のバランスを取って3回に1回とした。

実装詳細とサンプルコードは GitHub Actions 無料枠を延命するCI戦略 を参照。

根拠

  • 「開発フローを変えない」制約を満たす唯一の案
  • 消費量削減と安全性のバランスが最も良い
  • 効果が不足した場合、キャッシュ強化・マトリクス削減・テスト棚卸し等を段階的に追加できる余地がある

影響

  • .github/workflows/ 配下のCI定義を書き換える
  • PRマージ前は従来通りフルCIが走るため、レビュー運用への影響なし
  • 重いテストの失敗検知が最大2コミット分遅れる可能性がある(PRで最終確認されるため許容)

見直し条件

導入後1週間を目安に以下を確認し、未達なら再検討する。

  • Billing画面で月の消費ペースが従来比1/2以下になっているか(Lint分が毎回残るため1/3にはならない想定)
  • 重いCIの間引きによる障害見逃しが発生していないか

未達の場合は、キャッシュ戦略・マトリクス削減・テスト棚卸し・self-hosted runner 等を次の打ち手として検討する。