GitHub Actions 無料枠を延命するCI戦略
GitHub Actions の無料枠を使い切ってしまう問題への対策を整理。concurrency・paths-ignore・間引き実行等の有効手段と、今回採用するハイブリッド構成(重いCIは3回に1回)を記録する。
背景
mainブランチへのpushごとにCIがフル実行され、約4日で月の無料枠を使い切る状態になっていた。開発者側で「pushする/しない」を判断する運用はストレスが大きく避けたいので、ワークフロー側で消費量を抑える方針を検討する。
有効な手段の一覧
寿命延長に効く手段を効果の大きい順に整理する。
1. concurrency で古い実行をキャンセル
連続pushされた際、進行中の古いジョブを自動キャンセルする。実装コストが低く効果が大きい定番。
concurrency: group: ${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true2. paths-ignore で対象外ファイルを除外
ドキュメントや .gitignore 等の変更ではCIを走らせない。
on: push: paths-ignore: - '**.md' - 'docs/**'3. ジョブの分割と軽量/重量の階層化
Lint等の軽量チェックは毎回、テスト・ビルド等の重い処理は条件付きにする。
4. 実行回数の間引き(N回に1回)
コミット数ベースで重いジョブの実行頻度を落とす。開発者は何も意識しなくて良いのが利点。Nが大きいほど節約効果は高いが、障害検知の遅延も比例して大きくなる。
N=$(git rev-list --count HEAD)[ $((N % 3)) -eq 0 ] && echo "run=true" || echo "run=false"5. スケジュール化(nightly等)
E2E等の重テストは schedule で1日1回に切り替える選択肢もある。
6. キャッシュの活用
actions/cache で依存解決を省略すれば、1回あたりの実行時間を短縮できる。
7. その他
workflow_dispatchで手動実行の逃げ道を確保- マトリクスの刈り込み(OS × 言語バージョンの組み合わせ最小化)
- テスト棚卸し(flaky・重複・価値の低いテストの削除)も有効手段の一つ
- self-hosted runner の導入(無料枠を消費しない)
今回取る選択: ハイブリッド構成
「開発者はバンバンpushするだけ」という前提を守りつつ、以下を組み合わせる。
| 層 | 内容 | 頻度 |
|---|---|---|
| 軽量チェック | Lint・構文チェック | 毎push |
| 重いCI | テスト・ビルド | 3回に1回 + PR + 手動 |
| 共通 | concurrency キャンセル・paths-ignore | 常時 |
間引き頻度は当初5回に1回を検討したが、障害検知が最大4コミット遅れるのは体感リスクが大きいため、バランスを取って3回に1回とした。
採用理由
- 開発フローを変えない(判断不要)
- Lintは毎push走るので壊れたコードはすぐ気付ける
- 重いテストは1/3に間引くので消費量を大きく下げられる
- PRでは必ずフル実行 → マージ前の安全性は担保
[ci]コミットメッセージとworkflow_dispatchで緊急時の逃げ道あり
実装
name: CI
on: push: branches: [main] paths-ignore: - '**.md' - 'docs/**' pull_request: branches: [main] workflow_dispatch:
concurrency: group: ${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true
jobs: lint: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Lint run: echo "軽量チェック"
gate: runs-on: ubuntu-latest outputs: run_heavy: ${{ steps.c.outputs.run }} steps: - uses: actions/checkout@v4 - id: c run: | if [ "${{ github.event_name }}" != "push" ]; then echo "run=true" >> $GITHUB_OUTPUT exit 0 fi MSG="${{ github.event.head_commit.message }}" if echo "$MSG" | grep -q '\[ci\]'; then echo "run=true" >> $GITHUB_OUTPUT exit 0 fi N=$(git rev-list --count HEAD) if [ $((N % 3)) -eq 0 ]; then echo "run=true" >> $GITHUB_OUTPUT else echo "run=false" >> $GITHUB_OUTPUT fi
test: needs: [lint, gate] if: needs.gate.outputs.run_heavy == 'true' runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Test & Build run: echo "重いCI本体"運用後の確認
導入後1週間ほど様子を見て、以下で効果測定する。
- Settings → Billing and plans → Plans and usage で月の消費分数を確認
- Actions タブ でワークフローごとの実行時間を確認
- 消費ペースが従来比1/2以下に収まっているかチェック(Lint分が毎回残るため、1/3にはならない想定)
効果が足りなければ、キャッシュ強化・マトリクス削減・テスト棚卸し等を順次追加していく。