GitHub ActionsでMavenを高速化する
最終更新
GitHub ActionsでMavenを高速化するには、~/.m2のローカルリポジトリをactions/setup-java経由でキャッシュし、-T 1Cでモジュールを並列にビルドし、SurefireのforkCountを調整して、compileとtestを別々のフルビルドとして実行しないようにしてください。キャッシュがない状態のMavenビルドでは、変更されることのないプラグインや依存関係のダウンロードに、思いのほか多くの時間が費やされます。
本ガイドは、GitHub Actionsを高速化する一般的なガイドのMavenバージョンです。
setup-javaで~/.m2をキャッシュする
actions/setup-javaにはcache入力があります。READMEによると、maven、gradle、sbtを受け付けます。cache-dependency-pathは、キーを構成するファイルを指定します(globや複数行に対応しています)。Mavenの場合、キーはpom.xmlファイルから生成されます。
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: 21
cache: maven
- run: mvn -B -ntp verify
CIでは2つのフラグが重要です。-B(バッチモード)は対話的なプロンプトと色付けを無効にし、-ntp(--no-transfer-progress)はログを巨大にして遅くしかねないダウンロード進捗表示を取り除きます。サブディレクトリにpomがあるマルチモジュールリポジトリでは、cache-dependency-path: '**/pom.xml'を指定すると、すべてのpomがキーに反映されます。
キャッシュサイズについて補足します。~/.m2/repositoryフォルダーは、これまでに使用したすべての依存関係バージョンの分だけ増えていく可能性があります。エントリーは7日間使用されないと期限切れになり、リポジトリには合計の上限もあるため、GitHub Actionsのキャッシュ制限を確認してください。target/はキャッシュしないでください。Mavenの増分検出は保守的であり、古いクラスファイルが原因で紛らわしい失敗が発生することがあります。
-Tによる並列ビルド
Mavenは、独立したモジュールを同時にビルドできます。
mvn -B -ntp -T 1C verify
-T 1CはCPUコア1つにつき1スレッドを意味します。-T 4はスレッド4本を意味します。これは、すべてのモジュールが連鎖的に依存していないマルチモジュールプロジェクトでのみ効果があります。mvn dependency:treeまたはリアクターのサマリーで確認してください。スレッドセーフでない古いプラグインもあり、Mavenは起動時にスレッドセーフとしてマークされていないプラグインについて警告を出します。-Tでランダムな失敗が発生する場合は、-T 1で試して原因を確認してください。
Surefire: forkCountとreuseForks
デフォルトでは、Surefireはすべてのテストクラスを1つのフォークされたJVMで実行します。コアをより多く使うための設定が2つあります。
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<forkCount>1C</forkCount>
<reuseForks>true</reuseForks>
</configuration>
</plugin>
forkCountは、Surefireが同時に起動するJVMの数です。1Cはコア1つにつき1つを意味し、2のような単純な数値は2つを意味します。reuseForks=true(デフォルト)は各JVMを多数のテストクラスで再利用し、クラスごとのJVM起動を避けます。falseに設定するとクラスは分離されますが、はるかに遅くなります。- JUnit 5では、
junit-platform.propertiesでjunit.jupiter.execution.parallel.enabled=trueを設定すると、1つのJVM内でテストを並列実行することもできます。これにはスレッドセーフなテストが必要です。
メモリに注意してください。各フォークは独自のヒープを持ち、-T 1Cでさらに掛け算されます。7 GBのホステッドランナーでは、両方を1Cにするより、-T 2とforkCount=2の方が安全です。メモリ不足によるkill(終了コード137)に注意してください。これはCIの終了コード137で扱っています。
統合テストとTestcontainers
Failsafe(mvn verify)は、パッケージ化の後に統合テストを実行します。それらでTestcontainersを使用している場合、コンテナの起動が大部分の時間を占めます。テストクラスごとに1つのコンテナを起動する代わりに、共有の基底クラスやシングルトンコンテナのパターンで、テストクラス階層ごとに1つのコンテナを再利用してください。新しいVMでは、Dockerイメージのpullにも時間がかかります。ホステッドランナーにはDockerがありますが、ランナーがDockerキャッシュを保持していない限り、イメージは毎回の実行でpullされます。CIにおけるDockerレイヤーキャッシュを参照してください。
作業の重複を避ける
- ビルドは1回にまとめる。
mvn verifyは、すでにコンパイル、テスト、パッケージ化を行います。mvn compile、mvn test、mvn packageを別々のコマンドで実行すると、同じ作業を繰り返すことになります。 - PRに不要な処理は省く。 jarだけが必要なジョブでは、
-Dmaven.javadoc.skip=trueと-DskipTestsを使用します。lintが別の場所で実行される場合にのみ、-Dcheckstyle.skipを使用してください。 - ウォームアップ後はオフラインで実行する。
mvn -oは何かが欠けている場合に失敗するため、キャッシュの不足が見えるようになります。キャッシュが信頼できるようになってから使用してください。 - Mavenデーモン。
mvndはJVMをウォームな状態で保持するため、ローカルでは有用です。新しいCI VMではデーモンはコールドで起動するため、得られる効果はわずかです。 - 変更されたモジュールだけをビルドする。
-pl :module -amは、1つのモジュールとその必要な依存関係をビルドします。大規模なリアクターでは、-amdで依存モジュールもビルドできます。パスフィルターと組み合わせると、残りをスキップできます。
完全なワークフロー
name: build
on:
pull_request:
push:
branches: [main]
concurrency:
group: build-${{ github.ref }}
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
jobs:
verify:
runs-on: ubuntu-latest
timeout-minutes: 25
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: 21
cache: maven
cache-dependency-path: "**/pom.xml"
- run: mvn -B -ntp -T 1C verify
- uses: actions/upload-artifact@v7
if: always()
with:
name: surefire-reports
path: "**/target/surefire-reports"
CPU コア数を増やす効果
Mavenの並列処理の効果はモジュールの依存関係グラフに左右され、Surefireのフォーク数はテスト数に左右されます。当社のベンチマークには、Testcontainersを使用したSpring Boot(Maven)+ Kafka + Postgresのプロジェクトが含まれており、2026年10月8日に計測した完全なCI実行では、GitHubホストランナーで1m54s、compiler.devで1m12s(1.6x)でした。同じセットにあるGradleスタックの効果(3.0x)より小さい結果ですが、これはTestcontainersの起動時間と短いモジュールチェーンが、追加のコアによる効果を制限するビルドであるためと考えられます。比較については、Gradleガイドをご覧ください。
自分のビルドで試すには、1行をruns-on: [self-hosted, Linux, compiler-ci]に変更します。料金は料金ページにあります。また、MavenテンプレートとJavaのキャッシュに関する解説もあります。
よくある質問
GitHub ActionsでMavenの依存関係をキャッシュするにはどうすればよいですか?
actions/setup-javaをcache: mavenとともに使用します。pom.xmlファイルのハッシュを使って~/.m2/repositoryをキャッシュします。
mvn -T 1Cは何をしますか?
CPUコア1つにつき1スレッドで、独立したモジュールを並列にビルドします。マルチモジュールプロジェクトに有効で、単一モジュールには効果がありません。
Mavenの並列ビルドは安全ですか?
ほとんどの最近のプラグインでは安全です。Mavenは、スレッドセーフでないプラグインについて警告します。ランダムな失敗が発生する場合は、-T 1で試してください。
CIでmvndを使うべきですか?
通常は推奨しません。デーモンの利点はビルド間でJVMがウォームに保たれることですが、新しいCI VMではコールドで起動します。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。
- GitHub Actionsで.NETを高速化するGitHub Actions で .NET のビルドを高速化する: setup-dotnet による NuGet キャッシュ、--no-restore、--no-build、並列の dotnet test、SQL Server サービス。