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 等を次の打ち手として検討する。