referencegrowing

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: true

2. paths-ignore で対象外ファイルを除外

ドキュメントや .gitignore 等の変更ではCIを走らせない。

on:
push:
paths-ignore:
- '**.md'
- 'docs/**'

3. ジョブの分割と軽量/重量の階層化

Lint等の軽量チェックは毎回、テスト・ビルド等の重い処理は条件付きにする。

4. 実行回数の間引き(N回に1回)

コミット数ベースで重いジョブの実行頻度を落とす。開発者は何も意識しなくて良いのが利点。Nが大きいほど節約効果は高いが、障害検知の遅延も比例して大きくなる。

Terminal window
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にはならない想定)

効果が足りなければ、キャッシュ強化・マトリクス削減・テスト棚卸し等を順次追加していく。