Maven@2: tarea maven v2

Use esta tarea para compilar, probar e implementar con Apache Maven.

Syntax

# Maven v2
# Build, test, and deploy with Apache Maven.
- task: Maven@2
  inputs:
    mavenPOMFile: 'pom.xml' # string. Required. Maven POM file. Default: pom.xml.
    #goals: 'package' # string. Goal(s). Default: package.
    #options: # string. Options. 
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
    #allowBrokenSymlinks: true # boolean. Alias: allowBrokenSymbolicLinks. Optional. Use when publishJUnitResults = true. Allow broken symbolic links. Default: true.
  # Code Coverage
    #codeCoverageToolOption: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageClassFilesDirectories: # string. Alias: classFilesDirectories. Optional. Use when codeCoverageTool = JaCoCo. Class files directories. 
    #codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool = JaCoCo. Source files directories. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
    #codeCoverageRestoreOriginalPomXml: false # boolean. Alias: restoreOriginalPomXml. Optional. Use when codeCoverageTool != None. Restore original pom.xml after task execution. Default: false.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.17' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.
    mavenVersionOption: 'Default' # 'Default' | 'Path'. Alias: mavenVersionSelection. Required. Maven version. Default: Default.
    #mavenDirectory: # string. Alias: mavenPath. Required when mavenVersionSelection = Path. Maven path. 
    #mavenSetM2Home: false # boolean. Optional. Use when mavenVersionSelection = Path. Set M2_HOME variable. Default: false.
    #mavenOptions: '-Xmx1024m' # string. Alias: mavenOpts. Set MAVEN_OPTS to. Default: -Xmx1024m.
    #mavenAuthenticateFeed: true # boolean. Alias: mavenFeedAuthenticate. Authenticate with Artifacts feeds. Default: true.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud analysis. Default: false.
    #isJacocoCoverageReportXML: false # boolean. Optional. Use when sqAnalysisEnabled = true && codeCoverageTool = JaCoCo. Use XML Jacoco reports for SonarQube analysis. Default: false.
    #sqMavenPluginVersionChoice: 'latest' # 'latest' | 'pom'. Required when sqAnalysisEnabled = true. SonarQube scanner for Maven version. Default: latest.
    #checkStyleRunAnalysis: false # boolean. Alias: checkstyleAnalysisEnabled. Run Checkstyle. Default: false.
    #pmdRunAnalysis: false # boolean. Alias: pmdAnalysisEnabled. Run PMD. Default: false.
    #findBugsRunAnalysis: false # boolean. Alias: findbugsAnalysisEnabled. Run FindBugs. Default: false.

Entradas

mavenPOMFile - Archivo POM de Maven
string. Obligatorio. Valor predeterminado: pom.xml.

Especifica la ruta de acceso relativa de la raíz del repositorio al archivo POM de Maven.

goals - Objetivos
string. Valor predeterminado: package.

options - Opciones
string.

publishJUnitResults - Publicación en Azure Pipelines
boolean. Valor predeterminado: true.

Especifica la opción de publicar los resultados de prueba de JUnit generados por la compilación de Maven en Azure Pipelines. Cada archivo de resultados de prueba que coincida con Test Results Files se publicará como una serie de pruebas en Azure Pipelines.

testResultsFiles - Archivos de resultados de pruebas
string. Necesario cuando publishJUnitResults = true. Valor predeterminado: **/TEST-*.xml.

Especifica la ruta de acceso y el patrón de los archivos de resultados de pruebas que se van a publicar. Se pueden usar caracteres comodín. Más información sobre los patrones de coincidencia de archivos.
Por ejemplo, **/TEST-*.xml para todos los archivos XML cuyo nombre comienza por TEST-.
Si no se especifica ninguna ruta de acceso raíz, los archivos coinciden debajo del directorio de trabajo predeterminado, el valor de que está disponible en la variable $(System.DefaultWorkingDirectory). Por ejemplo, un valor de **/TEST-*.xml dará lugar realmente a archivos coincidentes de $(System.DefaultWorkingDirectory)/**/TEST-*.xml.

testRunTitle - Título de la ejecución de pruebas
string. Opcional. Use cuando publishJUnitResults = true.

Especifica un nombre para la ejecución de pruebas.

allowBrokenSymlinks - Permitir vínculos simbólicos rotos
Alias de entrada: allowBrokenSymbolicLinks. boolean. Opcional. Use cuando publishJUnitResults = true. Valor predeterminado: true.

Cuando se establece falseen , se produce un error en la compilación cuando la tarea encuentra un vínculo simbólico roto mientras publica el resultado de las pruebas.

codeCoverageToolOption - Herramienta de cobertura de código
Alias de entrada: codeCoverageTool. string. Valores permitidos: None, Cobertura y JaCoCo. Valor predeterminado: None.

Especifica la herramienta de cobertura de código.

codeCoverageClassFilter - Filtros de inclusión y exclusión de clases
Alias de entrada: classFilter. string. Opcional. Use cuando codeCoverageTool != None.

Especifica una lista separada por comas de filtros para incluir o excluir clases de recopilación de cobertura de código. Por ejemplo, +:com.*,+:org.*,-:my.app*.*.

codeCoverageClassFilesDirectories - Directorios de archivos de clase
Alias de entrada: classFilesDirectories. string. Opcional. Use cuando codeCoverageTool = JaCoCo.

Este campo es necesario para un proyecto de varios módulos.
Especifica una lista separada por comas de rutas de acceso relativas del archivo POM de Maven a directorios que contienen archivos de clase y archivos de archivo (JAR, WAR, etc.). La cobertura de código se notifica para los archivos de clase que están en estos directorios. Por ejemplo, target/classes,target/testClasses.

codeCoverageSourceDirectories - Directorios de archivos de origen
Alias de entrada: srcDirectories. string. Opcional. Use cuando codeCoverageTool = JaCoCo.

Este campo es necesario para un proyecto de varios módulos.
Especifica una lista separada por comas de rutas de acceso relativas del archivo POM de Maven a los directorios de código fuente. Los informes de cobertura de código los usan para resaltar el código fuente. Por ejemplo, src/java,src/Test.

codeCoverageFailIfEmpty - Error cuando faltan resultados de cobertura de código
Alias de entrada: failIfCoverageEmpty. boolean. Opcional. Use cuando codeCoverageTool != None. Valor predeterminado: false.

Se produce un error en la compilación si la cobertura de código no ha generado ningún resultado para publicar.

codeCoverageRestoreOriginalPomXml - Restaurar la pom.xml original después de la ejecución de la tarea
Alias de entrada: restoreOriginalPomXml. boolean. Opcional. Use cuando codeCoverageTool != None. Valor predeterminado: false.

La cobertura de pom.xml código modifica para generar resultados. Use esta opción si necesita mantener el original pom.xml.

javaHomeOption - Establecer JAVA_HOME por
Alias de entrada: javaHomeSelection. string. Obligatorio. Valores permitidos: JDKVersion (versión de JDK), Path. Valor predeterminado: JDKVersion.

Establece JAVA_HOME seleccionando una versión de JDK que se detectará durante las compilaciones o escribiendo manualmente una ruta de acceso de JDK.

jdkVersionOption - Versión de JDK
Alias de entrada: jdkVersion. string. Opcional. Use cuando javaHomeSelection = JDKVersion. Valores permitidos: default, 1.17 (JDK 17), 1.11 (JDK 11), 1.10 (JDK 10 (fuera de soporte)), 1.9 (JDK 9 (fuera de soporte)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (fuera de soporte)). Valor predeterminado: default.

Intenta detectar la ruta de acceso a la versión de JDK seleccionada y establece JAVA_HOME en consecuencia.

jdkDirectory - Ruta de acceso de JDK
Alias de entrada: jdkUserInputPath. string. Necesario cuando javaHomeSelection = Path.

Establece JAVA_HOME en la ruta de acceso especificada.

jdkArchitectureOption - Arquitectura de JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use cuando jdkVersion != default. Valores permitidos: x86, x64. Valor predeterminado: x64.

Proporciona la arquitectura (x86, x64) del JDK.

mavenVersionOption - Versión de Maven
Alias de entrada: mavenVersionSelection. string. Obligatorio. Valores permitidos: Default, Path (Ruta de acceso personalizada). Valor predeterminado: Default.

Usa la versión predeterminada de Maven o la versión de la ruta de acceso personalizada especificada.

mavenDirectory - Ruta de acceso de Maven
Alias de entrada: mavenPath. string. Necesario cuando mavenVersionSelection = Path.

Especifica la ruta de acceso personalizada a la instalación de Maven (por ejemplo: /usr/share/maven).

mavenSetM2Home - Establecer M2_HOME variable
boolean. Opcional. Use cuando mavenVersionSelection = Path. Valor predeterminado: false.

Establece la M2_HOME variable en una ruta de instalación personalizada de Maven.

mavenOptions - Establezca MAVEN_OPTS en
Alias de entrada: mavenOpts. string. Valor predeterminado: -Xmx1024m.

Establece la MAVEN_OPTS variable de entorno, que se usa para enviar argumentos de línea de comandos para iniciar la JVM. La -Xmx marca especifica la memoria máxima disponible para la JVM.

mavenAuthenticateFeed - Autenticación con fuentes de artefactos
Alias de entrada: mavenFeedAuthenticate. boolean. Valor predeterminado: true.

Se autentica automáticamente con fuentes de Azure Artifacts. Si las fuentes artifacts no están en uso, anule la selección de esta opción para compilaciones más rápidas.

sonarQubeRunAnalysis - Ejecución del análisis de SonarQube o SonarCloud
Alias de entrada: sqAnalysisEnabled. boolean. Valor predeterminado: false.

Esta opción ha cambiado de usar la versión 1 de la tarea maven para usar las extensiones de Marketplace SonarQube y SonarCloud .
Habilite esta opción para ejecutar el análisis de SonarQube o SonarCloud después de ejecutar objetivos en el campo Objetivos. El objetivo de instalación o paquete debe ejecutarse primero. Antes de esta tarea de Maven, también debe agregar una tarea Preparar configuración de análisis de una de las extensiones a la canalización de compilación.

isJacocoCoverageReportXML - Uso de informes de Jacoco XML para el análisis de SonarQube
boolean. Opcional. Use cuando sqAnalysisEnabled = true && codeCoverageTool = JaCoCo. Valor predeterminado: false.

Usa informes de Jacoco XML para el análisis de SonarQube. Obtenga más información sobre los informes de prueba.

sqMavenPluginVersionChoice - Escáner sonarQube para la versión de Maven
string. Necesario cuando sqAnalysisEnabled = true. Valores permitidos: latest (use la versión más reciente), pom (use la versión declarada en la pom.xml). Valor predeterminado: latest.

Especifica la versión del complemento SonarQube Maven que se va a usar. Puede usar la versión más reciente o confiar en la versión de pom.xml.

checkStyleRunAnalysis - Ejecutar Checkstyle
Alias de entrada: checkstyleAnalysisEnabled. boolean. Valor predeterminado: false.

Ejecuta la herramienta Checkstyle con las comprobaciones de Sun predeterminadas. Los resultados se cargan como artefactos de compilación.

pmdRunAnalysis - Ejecución de PMD
Alias de entrada: pmdAnalysisEnabled. boolean. Valor predeterminado: false.

Usa la herramienta de análisis estático PMD para buscar errores en el código. Los resultados se cargan como artefactos de compilación.

findBugsRunAnalysis - Ejecutar FindBugs
Alias de entrada: findbugsAnalysisEnabled. boolean. Valor predeterminado: false.

Usa la herramienta de análisis estático FindBugs para buscar errores en el código. Los resultados se cargan como artefactos de compilación.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

La configuración del análisis de SonarQube se movió a las extensiones SonarQube o SonarCloud en la tarea Preparar configuración de análisis.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usen esta tarea: maven
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.89.0 o superior
Categoría de la tarea:	Build

Consulte también

• Autenticación de Maven
• Publicación de artefactos de Maven con Azure Pipelines
• Instalador de herramientas de Java
• Compilación de aplicaciones Java