Saltar al contenido

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>
  • forkCount es cuántas JVM inicia Surefire a la vez. 1C significa una por núcleo, y un número simple como 2 significa dos.
  • reuseForks=true (el valor por defecto) mantiene cada JVM para muchas clases de prueba, lo que evita arrancar una JVM por clase. Ponerlo en false aí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=true en junit-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 verify ya compila, prueba y empaqueta. Ejecutar mvn compile, mvn test y mvn package como comandos separados repite trabajo.
  • Omita lo que los PR no necesitan. -Dmaven.javadoc.skip=true y -DskipTests en los trabajos que solo necesitan un jar. Use -Dcheckstyle.skip solo si el linting se ejecuta en otro lugar.
  • Sin conexión tras el calentamiento. mvn -o falla cuando falta algo, lo que hace visibles los huecos de la caché. Úselo solo cuando la caché sea fiable.
  • Demonio de Maven. mvnd mantiene 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 -am compila un módulo y lo que necesita. En un reactor grande, -amd compila 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.

Ejecute este workflow en compiler.dev Sin tarjeta · 200 minutos gratuitos

Pruébelo gratis