コンテンツへスキップ

成長するチームのCIコストを見積もり予測する

最終更新日

CI のコストは、人員の増加よりも速く膨らみます。開発者が増えて PR の数が増え、PR ごとに実行される回数が増え、コードベースのテストにも時間がかかるようになるためです。予測を立てておけば、請求書で驚くことを防げます。このガイドでは、スプレッドシートで 30 分ほどで作成できるモデルを紹介し、数値を左右する課金ルールも解説します。

モデル

月間の CI コストは、いくつかの測定可能な要素の積で求められます。

runs per month   = developers x PRs per dev per month x runs per PR  (+ main/nightly runs)
minutes per run  = sum over jobs of (job minutes, rounded up per job)
billed minutes   = runs per month x minutes per run
cost             = sum over runner types of (billed minutes x per-minute rate)
                   minus included free minutes (standard runners only)

ランナーの種類ごとに料金が約 10 倍違うため、それぞれ別々に計算してください。CI 分数予測ツールがこの計算を行い、Actions コスト計算ツールが結果の料金を算出します。

ステップ 1:実際の入力値を集める

推測せず、直近 4〜8 週間の実績を測定してください。

ワークフローとランナーごとの課金対象分数。GitHub の請求使用量レポート(組織の設定、Billing、Usage)から CSV をエクスポートし、ワークフロー、SKU、リポジトリごとに集計してください。

PR あたりの実行回数。再プッシュや再実行を含め、プルリクエストごとのワークフロー実行回数です。PR のサイズやテストの不安定さに応じて増える傾向があります。API から次のように算出できます。

gh api "repos/OWNER/REPO/actions/runs?event=pull_request&per_page=100" \
  --paginate --jq '.workflow_runs[] | [.head_branch, .run_attempt] | @tsv' | sort | uniq -c | sort -rn | head

実行あたりの分数。ワークフローごとの課金対象ジョブ時間の中央値と 90 パーセンタイル値です。

開発者あたりの PR 数。リポジトリの分析機能から、アクティブな開発者 1 人あたりの月間マージ済み PR 数を確認してください。

ステップ 2:課金ルールを適用する

以下は GitHub の課金ドキュメントとランナーの料金ページに基づいています。

  • 切り上げ。各ジョブは次の 1 分単位に切り上げられます。合計時間が同じでも、短いジョブを多数実行するほうが長いジョブ 1 つより高くつくことがあります。20 秒のジョブは 1 分として課金されます。
  • 分単価。Linux 2 コアは $0.006、Windows 2 コアは $0.010、macOS 3 コアは $0.062 です。大きい Linux ランナーは、4 コアが $0.012、8 コアが $0.022、16 コアが $0.042 です。
  • 無料枠の分数。Free は月 2,000 分、Pro と Team は 3,000 分、Enterprise Cloud は 50,000 分です。標準のホステッドランナーにのみ適用され、大きいランナーには適用されません。また、Windows は 2 倍、macOS は 10 倍の速度で消費されます。
  • 無料枠の分数はアカウント単位で付与され、開発者ごとではありません。そのため、規模が拡大すると急速に消費されます。たとえば Team プランの 3,000 分は、macOS の約 300 分に相当します。

ステップ 3:計算例

開発者 15 人のチームが、開発者 1 人あたり月 20 件の PR、PR あたり 3 回のワークフロー実行、実行あたり 12 分の Linux 課金分数で、Team プランを利用している場合を考えます。

runs            = 15 x 20 x 3          = 900 runs
billed minutes  = 900 x 12             = 10,800 minutes
included        = 3,000
chargeable      = 7,800 minutes x $0.006 = $46.80 per month

ここに iOS のパイプラインを追加します。実行あたり 25 分の macOS ジョブを月 300 回実行すると、7,500 分 × $0.062 = $465 になります。無料枠はその 10 分の 1 しかカバーしません。実行回数は Linux の 3 分の 1 にすぎませんが、macOS の費用は Linux の 10 倍になります。これらの数値はあくまで例であり、ベンチマークではありません。ご自身の実績値に置き換えてください。

ステップ 4:成長をモデル化する

コストは開発者数に比例して増えるわけではありません。次の要素を含めてください。

  1. 人員の増加。開発者数 × 開発者あたりの PR 数。
  2. PR あたりの実行回数の増加。チームが大きくなるほど、再実行やレビューに伴うプッシュが増えます。安定性への投資を行わない限り、増加すると想定してください。
  3. 実行あたりの分数の増加。テストスイートやビルドはコードベースとともに大きくなります。毎月 3 パーセントずつ増加すると、2 年で分数は 2 倍になります。
  4. 新しいワークフロー。セキュリティスキャン、エンドツーエンドテスト、プレビュー環境、複数 OS のマトリクスは、それぞれ新たな項目を追加します。
  5. マトリクスの掛け算。バージョンや OS を追加すると、ジョブ数は掛け算的に増えます。マトリクスビルドを正しく使う方法をご覧ください。
  6. マージキューの実行。マージのたびに追加の実行が発生します。GitHub のマージキューをご覧ください。

意思決定者への説明には、簡単なシナリオ表が役立ちます。

シナリオ開発者数PR あたりの実行回数実行あたりの分数月間の課金対象分数
現在1531210,800
6 か月後、変更なし253.31423,100
6 か月後、改善を実施252.5911,250

3 行目が示すポイントは、実行あたりの分数と PR あたりの実行回数を減らすことで、人員増加の影響の大部分を吸収できるということです。これらはActions の請求額を削減する方法と、ワークフローを高速化する方法で扱う施策です。

ステップ 5:その他のコストを数える

コストは分数だけではありません。

  • ストレージ:含まれる枠を超えたアーティファクトとキャッシュ(キャッシュはリポジトリあたりデフォルト 10 GB)。
  • 大きいランナーは、最初の 1 分から課金されます。
  • 待ち時間。 CIの待ち時間で失われる開発者の時間は、通常、CIの請求額より大きくなります。遅いCIのコスト計算ツールをご利用ください。開発者15人が1日4件のPR実行で毎回5分余計に待つと、その分の分数よりはるかに大きなコストになります。
  • 不安定なテストによる再実行は、純粋な無駄です。不安定なテストへの対処をご参照ください。
  • セルフホストのコスト:インスタンス、ディスク、データ転送、エンジニアの作業時間。セルフホストとGitHubホステッドの比較と、AWSのツール(EC2、データ転送)をご参照ください。

手順6:予算とアラートを設定する

GitHubの請求画面で、Actions用の予算を作成し、75%と100%でアラートを設定します。上限に達したときに利用を停止させるかどうかを決めてください。本番環境へのデプロイパイプラインでは、通常はアラートのみにとどめるほうが安全です。利用状況レポートは毎月確認し、コストの主な要因トップ3に担当者を割り当ててください。

追跡すると役立つ指標は、マージされたPRあたりのコスト(CIの支出をマージされたPR数で割った値)です。最適化すると下がり、パイプラインが肥大化すると上がります。チームの規模による違いも補正されます。

予測でよくある誤り

  • 分布に長い裾野がある場合に、実行あたりの平均分数を使うこと。実際の利用量の合計を使用してください。
  • 無料枠の分数に対するmacOSとWindowsの係数を考慮し忘れること。
  • 短時間のジョブや大規模なマトリックスでの切り上げを考慮し忘れること。
  • 無料枠が続くと想定すること。無料枠はアカウント全体で共有される固定の枠です。
  • PRがなくても実行されるスケジュール済みワークフローを含めないこと。GitHub Actionsのcronスケジュールをご参照ください。

よくある質問

開発者1人あたりのCIコストはどれくらいが適切ですか?

スタックやテストの深さによって大きく異なります。開発者1人あたりのコストとマージされたPRあたりのコストを自社で計測し、他社との比較ではなく推移を見てください。

GitHubホステッドのランナーから離れるのはどのような場合に有効ですか?

月々の支出が大きく、削減額がエンジニアリングの工数やプロバイダーの手数料を上回る場合です。セルフホストランナーとGitHubホステッドランナーの比較で説明しているとおり、実際のジョブについて、ワークフロー実行あたりのコストを比較してください。

失敗した実行も課金対象になりますか?

はい。ジョブが実行されたすべての分数に課金されます。

予測はどのくらいの頻度で更新すべきですか?

毎月、前月の実績値を使って更新してください。3か月以上前の予測は、通常は外れています。

別のランナーと比較する

基準値を把握したら、別のプロバイダーで実行あたりの料金を試してみてください。compiler.devの比較モードでは、既存のワークフローをより高速なマシンで実行し、GitHubホステッドの実行結果と並べて時間とコストを表示します。当社のベンチマークでは、18のスタックを計測した結果、GitHubの2コアランナーと比べて中央値で1.5倍高速でした(15件は高速、2件は同等、1件は低速)。料金は料金ページでご確認いただけます。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す