Acelere Maven en GitHub Actions
Última actualización
Para acelerar Maven en GitHub Actions, almacene en caché el repositorio local en ~/.m2 mediante actions/setup-java, compile los módulos en paralelo con -T 1C, ajuste forkCount de Surefire y deje de ejecutar compile y test como compilaciones completas por separado. Una compilación de Maven en frío dedica un tiempo considerable a descargar plugins y dependencias que nunca cambian.
Esta guía es la versión para Maven de nuestra guía general para acelerar GitHub Actions.
Almacenar ~/.m2 en caché con setup-java
actions/setup-java tiene una entrada cache. Según su README, acepta maven, gradle o sbt, y cache-dependency-path controla qué archivos forman la clave (admite globs y varias líneas). En Maven, la clave se genera a partir de sus archivos pom.xml.
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: 21
cache: maven
- run: mvn -B -ntp verify
En CI importan dos opciones. -B (modo por lotes) desactiva las preguntas interactivas y los colores, y -ntp (--no-transfer-progress) elimina el progreso de descarga, que puede hacer que los registros crezcan mucho y se ralenticen. En un repositorio multimódulo con poms en subdirectorios, cache-dependency-path: '**/pom.xml' garantiza que todos ellos formen parte de la clave.
Un apunte sobre el tamaño de la caché. La carpeta ~/.m2/repository puede crecer con cada versión de dependencia que haya usado. Las entradas caducan tras siete días sin uso, y el repositorio tiene un límite total; consulte límites de caché de GitHub Actions. No almacene en caché target/: la detección incremental de Maven es conservadora y los archivos de clase obsoletos provocan fallos confusos.
Compilaciones en paralelo con -T
Maven puede compilar módulos independientes al mismo tiempo:
mvn -B -ntp -T 1C verify
-T 1C significa un hilo por núcleo de CPU. -T 4 significa cuatro hilos. Solo ayuda en proyectos multimódulo en los que los módulos no dependen unos de otros en cadena. Compruébelo con mvn dependency:tree o con el resumen del reactor. Tenga en cuenta que algunos plugins antiguos no son thread-safe; Maven muestra una advertencia al inicio para los plugins que no están marcados como thread-safe. Si ve fallos aleatorios con -T, pruebe con -T 1 para confirmar la causa.
Surefire: forkCount y reuseForks
Por defecto, Surefire ejecuta todas las clases de prueba en una única JVM bifurcada. Dos ajustes usan más núcleos:
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<forkCount>1C</forkCount>
<reuseForks>true</reuseForks>
</configuration>
</plugin>
forkCountes cuántas JVM inicia Surefire a la vez.1Csignifica una por núcleo, y un número simple como2significa dos.reuseForks=true(el valor por defecto) mantiene cada JVM para muchas clases de prueba, lo que evita arrancar una JVM por clase. Ponerlo enfalseaísla las clases, pero es mucho más lento.- JUnit 5 también puede ejecutar pruebas en paralelo dentro de una JVM con
junit.jupiter.execution.parallel.enabled=trueenjunit-platform.properties. Para ello, las pruebas deben ser thread-safe.
Cuidado con la memoria. Cada bifurcación tiene su propio heap, y -T 1C lo multiplica de nuevo. En un runner alojado de 7 GB, -T 2 y forkCount=2 son más seguros que ambos en 1C. Vigile los cierres por falta de memoria (código de salida 137), tratados en código de salida 137 en CI.
Pruebas de integración y Testcontainers
Failsafe (mvn verify) ejecuta las pruebas de integración tras el empaquetado. Si estas usan Testcontainers, el arranque de los contenedores domina el tiempo. Reutilice un contenedor por jerarquía de clases de prueba mediante una clase base compartida o el patrón de contenedor singleton, en lugar de uno por clase. La descarga de imágenes de Docker también consume tiempo en una VM nueva; el runner alojado incluye Docker y las imágenes se descargan en cada ejecución salvo que sus runners mantengan una caché de Docker. Consulte caché de capas de Docker en CI.
Evite hacer el trabajo dos veces
- Una compilación, no tres.
mvn verifyya compila, prueba y empaqueta. Ejecutarmvn compile,mvn testymvn packagecomo comandos separados repite trabajo. - Omita lo que los PR no necesitan.
-Dmaven.javadoc.skip=truey-DskipTestsen los trabajos que solo necesitan un jar. Use-Dcheckstyle.skipsolo si el linting se ejecuta en otro lugar. - Sin conexión tras el calentamiento.
mvn -ofalla cuando falta algo, lo que hace visibles los huecos de la caché. Úselo solo cuando la caché sea fiable. - Demonio de Maven.
mvndmantiene una JVM caliente, útil en local. En una VM de CI nueva el demonio arranca en frío, así que aporta poco. - Compile solo los módulos modificados.
-pl :module -amcompila un módulo y lo que necesita. En un reactor grande,-amdcompila también los dependientes. Combínelo con un filtro de rutas para omitir el resto.
Un workflow completo
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"
Lo que aportan más núcleos de CPU
El paralelismo de Maven depende del grafo de módulos de su proyecto, y los forks de Surefire dependen del número de pruebas. Nuestros benchmarks incluyen un proyecto Spring Boot (Maven) + Kafka + Postgres que usa Testcontainers: 1m54s en un runner alojado en GitHub y 1m12s en compiler.dev (1.6x), medido en una ejecución completa de CI el 8 de octubre de 2026. La mejora es menor que la del stack de Gradle del mismo conjunto (3.0x), lo que encaja con una compilación en la que el arranque de Testcontainers y una cadena corta de módulos limitan lo que aportan núcleos adicionales. Consulte la guía de Gradle para comparar.
Para probar su propia compilación, cambie una línea a runs-on: [self-hosted, Linux, compiler-ci]. Los precios están en la página de precios; además hay una plantilla de Maven y una guía de caché para Java.
Preguntas frecuentes
¿Cómo almaceno en caché las dependencias de Maven en GitHub Actions?
Use actions/setup-java con cache: maven. Almacena en caché ~/.m2/repository usando un hash de sus archivos pom.xml.
¿Qué hace mvn -T 1C?
Compila módulos independientes en paralelo con un hilo por núcleo de CPU. Ayuda en proyectos multimódulo y no tiene efecto en un único módulo.
¿Es segura la compilación en paralelo de Maven?
En la mayoría de plugins modernos, sí. Maven advierte sobre los plugins que no son thread-safe. Pruebe con -T 1 si ve fallos aleatorios.
¿Debo usar mvnd en CI?
Normalmente no. La ventaja del demonio es una JVM caliente entre compilaciones, y una VM de CI nueva arranca en frío.
Relacionado
- Acelere un monorepo de TypeScript en GitHub ActionsAcelere la comprobación de tipos y el linting en un monorepo TypeScript con GitHub Actions: tsc incremental, referencias de proyecto y cachés.
- Acelere Playwright en un monorepo con GitHub ActionsAcelere las pruebas e2e de Playwright en un monorepo Node con GitHub Actions: compile la app una vez y omita e2e si no cambió.
- Añada una insignia de velocidad de CI a su READMEMuestre la velocidad de su CI con una insignia en el README: el tiempo mediano de ejecución en GitHub Actions, actualizado automáticamente. Gratis.
- Acelere .NET en GitHub ActionsAcelere las compilaciones de .NET en GitHub Actions: caché de NuGet con setup-dotnet, --no-restore, --no-build, dotnet test en paralelo y servicios SQL.