Zum Inhalt springen

Maven in GitHub Actions beschleunigen

Zuletzt aktualisiert am

Um Maven in GitHub Actions zu beschleunigen, cachen Sie das lokale Repository in ~/.m2 über actions/setup-java, bauen Sie Module parallel mit -T 1C, passen Sie Surefires forkCount an und hören Sie auf, compile und test als getrennte vollständige Builds auszuführen. Ein kalter Maven-Build verbringt erstaunlich viel Zeit mit dem Herunterladen von Plugins und Abhängigkeiten, die sich nie ändern.

Dieser Leitfaden ist die Maven-Version unseres allgemeinen Leitfadens zur Beschleunigung von GitHub Actions.

~/.m2 mit setup-java cachen

actions/setup-java verfügt über die Eingabe cache. Laut README akzeptiert sie maven, gradle oder sbt, und cache-dependency-path legt fest, welche Dateien den Schlüssel bilden (Globs und mehrere Zeilen werden unterstützt). Bei Maven stammt der Schlüssel aus Ihren pom.xml-Dateien.

- uses: actions/checkout@v7
- uses: actions/setup-java@v6
  with:
    distribution: temurin
    java-version: 21
    cache: maven
- run: mvn -B -ntp verify

In der CI sind zwei Optionen wichtig. -B (Batch-Modus) schaltet interaktive Abfragen und Farben ab, und -ntp (--no-transfer-progress) entfernt die Download-Fortschrittsanzeige, die Logs unnötig groß und langsam machen kann. Bei einem Multi-Modul-Repository mit POMs in Unterverzeichnissen sorgt cache-dependency-path: '**/pom.xml' dafür, dass alle in den Schlüssel einfließen.

Ein Hinweis zur Cache-Größe: Der Ordner ~/.m2/repository kann mit jeder jemals verwendeten Abhängigkeitsversion wachsen. Einträge verfallen nach sieben Tagen ohne Nutzung, und das Repository hat ein Gesamtlimit. Details finden Sie unter Cache-Limits von GitHub Actions. Cachen Sie target/ nicht; Mavens inkrementelle Erkennung ist konservativ, und veraltete Class-Dateien verursachen verwirrende Fehler.

Parallele Builds mit -T

Maven kann unabhängige Module gleichzeitig bauen:

mvn -B -ntp -T 1C verify

-T 1C bedeutet einen Thread pro CPU-Kern, -T 4 bedeutet vier Threads. Das hilft nur bei Multi-Modul-Projekten, deren Module nicht alle in einer Kette voneinander abhängen. Prüfen Sie dies mit mvn dependency:tree oder der Reactor-Zusammenfassung. Beachten Sie, dass manche älteren Plugins nicht thread-sicher sind; Maven gibt beim Start eine Warnung für Plugins aus, die nicht als thread-sicher markiert sind. Treten mit -T zufällige Fehler auf, testen Sie mit -T 1, um die Ursache zu bestätigen.

Surefire: forkCount und reuseForks

Standardmäßig führt Surefire alle Testklassen in einer geforkten JVM aus. Zwei Einstellungen nutzen mehr Kerne:

<plugin>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <forkCount>1C</forkCount>
    <reuseForks>true</reuseForks>
  </configuration>
</plugin>
  • forkCount legt fest, wie viele JVMs Surefire gleichzeitig startet. 1C bedeutet eine pro Kern, eine einfache Zahl wie 2 bedeutet zwei.
  • reuseForks=true (der Standard) behält jede JVM für viele Testklassen bei, was den JVM-Start pro Klasse vermeidet. Wenn Sie es auf false setzen, werden Klassen isoliert, das ist aber deutlich langsamer.
  • JUnit 5 kann Tests auch innerhalb einer JVM parallel ausführen, mit junit.jupiter.execution.parallel.enabled=true in junit-platform.properties. Dafür müssen die Tests thread-sicher sein.

Achten Sie auf den Speicher. Jeder Fork hat seinen eigenen Heap, und -T 1C multipliziert ihn erneut. Auf einem gehosteten Runner mit 7 GB ist -T 2 mit forkCount=2 sicherer als beides mit 1C. Achten Sie auf Out-of-Memory-Abbrüche (Exit-Code 137), die unter CI-Exit-Code 137 behandelt werden.

Integrationstests und Testcontainers

Failsafe (mvn verify) führt Integrationstests nach dem Paketieren aus. Verwenden diese Testcontainers, dominiert der Container-Start die Laufzeit. Nutzen Sie einen Container pro Testklassenhierarchie über eine gemeinsame Basisklasse oder das Singleton-Container-Muster, statt einen pro Klasse. Docker-Image-Pulls kosten auf einer frischen VM ebenfalls Zeit; der gehostete Runner hat Docker, und Images werden bei jedem Lauf neu gezogen, sofern Ihre Runner keinen Docker-Cache haben. Siehe Docker-Layer-Caching in der CI.

Doppelte Arbeit vermeiden

  • Ein Build, nicht drei. mvn verify kompiliert, testet und paketiert bereits. Wenn Sie mvn compile, mvn test und mvn package als getrennte Befehle ausführen, wiederholen Sie Arbeit.
  • Überspringen Sie, was PRs nicht brauchen. -Dmaven.javadoc.skip=true und -DskipTests in Jobs, die nur ein JAR benötigen. Verwenden Sie -Dcheckstyle.skip nur, wenn Linting woanders läuft.
  • Offline nach dem Aufwärmen. mvn -o schlägt fehl, wenn etwas fehlt, sodass Cache-Lücken sichtbar werden. Verwenden Sie es erst, wenn der Cache zuverlässig ist.
  • Maven-Daemon. mvnd hält eine warme JVM vor, was lokal nützlich ist. Auf einer frischen CI-VM startet der Daemon kalt und bringt wenig.
  • Nur geänderte Module bauen. -pl :module -am baut ein Modul und seine Abhängigkeiten. Bei einem großen Reactor baut -amd zusätzlich die Abhängigen. Kombinieren Sie dies mit einem Pfadfilter, um den Rest zu überspringen.

Ein vollständiger Workflow

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"

Was mehr CPU-Kerne bringen

Die Parallelisierung in Maven hängt von Ihrem Modulgraphen ab, und die Surefire-Forks hängen von Ihrer Testanzahl ab. Unsere Benchmarks umfassen ein Spring-Boot-Projekt (Maven) mit Kafka und Postgres unter Verwendung von Testcontainers: 1m54s auf einem GitHub-gehosteten Runner und 1m12s auf compiler.dev (1.6x), gemessen in einem vollständigen CI-Lauf am 8. Oktober 2026. Der Gewinn fällt kleiner aus als beim Gradle-Stack im selben Set (3.0x), was zu einem Build passt, bei dem der Start von Testcontainers und eine kurze Modulkette begrenzen, wie viel zusätzliche Kerne bewirken können. Den Vergleich finden Sie im Gradle-Guide.

Um Ihren eigenen Build zu testen, ändern Sie eine Zeile auf runs-on: [self-hosted, Linux, compiler-ci]. Preise finden Sie auf der Preisseite, dazu gibt es eine Maven-Vorlage und eine Anleitung zum Java-Caching.

FAQ

Wie cache ich Maven-Abhängigkeiten in GitHub Actions?

Verwenden Sie actions/setup-java mit cache: maven. Es cacht ~/.m2/repository anhand eines Hashs Ihrer pom.xml-Dateien.

Was macht mvn -T 1C?

Es baut unabhängige Module parallel mit einem Thread pro CPU-Kern. Das hilft bei Multi-Modul-Projekten und bringt bei einem einzelnen Modul nichts.

Ist der parallele Maven-Build sicher?

Für die meisten modernen Plugins ja. Maven warnt vor Plugins, die nicht thread-sicher sind. Testen Sie mit -T 1, wenn zufällige Fehler auftreten.

Sollte ich mvnd in der CI verwenden?

Normalerweise nicht. Der Vorteil des Daemons ist eine warme JVM über mehrere Builds hinweg, und eine frische CI-VM startet kalt.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen