GitHub Actions matrix 展開ツール
マトリックスの軸、include と exclude の項目を定義すると、GitHub が作成するジョブの内容と数、そしてそれにかかる分数を確認できます。
- Jobs
- 9
- limit is 256
- Runner minutes per run
- 72
- Axes
- 2
| # | os | node | coverage | experimental |
|---|---|---|---|---|
| 1 | ubuntu-latest | 18 | ||
| 2 | ubuntu-latest | 20 | ||
| 3 | ubuntu-latest | 22 | true | |
| 4 | windows-latest | 18 | ||
| 5 | windows-latest | 20 | ||
| 6 | windows-latest | 22 | ||
| 7 | macos-latest | 20 | ||
| 8 | macos-latest | 22 | ||
| 9 | ubuntu-latest | 23 | true |
すべての処理はお使いのブラウザー内で行われます。入力した内容が外部に送信されることはありません。
使い方
- 軸は1行につき1つ、名前: 値, 値, 値 の形式で記入してください。
- include の項目(1行につき、カンマ区切りの key=value ペア)でジョブや追加の変数を加えられます。exclude の項目では組み合わせを除外できます。
- ジョブの表とジョブ数を確認してください。ジョブごとの分数を入力すると、ランナーの合計時間を見積もれます。
よくある質問
マトリックスで作成できるジョブは何個までですか?
GitHub では、1回のワークフロー実行で1つのマトリックスから最大256個のジョブを作成できます。それを超えるとワークフローの検証に失敗します。
include はどのように動作しますか?
元の軸に既存の組み合わせと一致する include の項目は、その追加キーを既存の組み合わせに加えます。一致する組み合わせがない場合は、新しいジョブになります。include で指定した値が、元の軸の値を上書きすることはありません。
exclude はどのように動作しますか?
指定したすべてのキーに一致する組み合わせをすべて削除します。たとえば os=windows のような一部だけの項目を指定すると、Windows のジョブがすべて削除されます。
マトリックスによって CI の料金は増えますか?
はい。各組み合わせは独立したジョブとなり、それぞれ分単位で課金されます。たとえば、12個の組み合わせがそれぞれ8分かかる場合、1回の実行で96ランナー分になります。
関連ガイド
この計算ツールをサイトに埋め込む
ブログやドキュメントへの埋め込みは無料です。表示させたい場所に次の HTML を貼り付けてください:
<iframe src="https://compiler.dev/embed/github-actions-matrix-expander" title="GitHub Actions matrix expander" width="100%" height="560" style="border:1px solid #e5e7eb;border-radius:12px" loading="lazy"></iframe>
<p style="font-size:12px">Calculator by <a href="https://compiler.dev/tools/github-actions-matrix-expander">compiler.dev</a></p>関連ツール
- GitHub Actions コスト計算ツールLinux、Windows、macOS のランナー種別ごとの月間分数と無料分の枠、分単価から、GitHub Actions の月額料金を見積もれます。
- テストシャーディング・プランナーテストの実行時間を貼り付けると、バランスの取れたシャードに分割できます。各シャードのテスト内容、想定される実行時間、高速化の度合いを、CI を変更する前に確認できます。
- CI 分数予測ツール1 日あたりのプルリクエスト数、PR ごとのプッシュ数、実行ごとのジョブ数、ジョブごとの分数から、月間の CI 分数と GitHub Actions の料金を予測します。プランとランナーを考慮します。
- GitHub Actions ワークフロー YAML チェッカーGitHub Actions のワークフローを貼り付けると、runs-on の指定漏れ、固定されていないアクション、pull_request_target のリスク、permissions の未設定、不正な needs を検出します。