Maven@2 - Tâche Maven v2

Utilisez cette tâche pour générer, tester et déployer avec 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.

Entrées

mavenPOMFile - Fichier Pom Maven
string. Obligatoire. Valeur par défaut : pom.xml.

Spécifie le chemin d’accès relatif de la racine du dépôt au fichier Pom Maven.

goals - Objectif(s)
string. Valeur par défaut : package.

options - Options
string.

publishJUnitResults - Publier sur Azure Pipelines
boolean. Valeur par défaut : true.

Spécifie l’option permettant de publier les résultats des tests JUnit générés par la build Maven sur Azure Pipelines. Chaque fichier de résultats de test correspondant à Test Results Files sera publié en tant que série de tests dans Azure Pipelines.

testResultsFiles - Fichiers de résultats de test
string. Nécessaire lorsque publishJUnitResults = true. Valeur par défaut : **/TEST-*.xml.

Spécifie le chemin d’accès et le modèle des fichiers de résultats de test à publier. Des caractères génériques peuvent être utilisés. Plus d’informations sur les modèles de correspondance de fichiers.
Par exemple, **/TEST-*.xml pour tous les fichiers XML dont le nom commence par TEST-.
Si aucun chemin d’accès racine n’est spécifié, les fichiers sont mis en correspondance sous le répertoire de travail par défaut, dont la valeur est disponible dans la variable $(System.DefaultWorkingDirectory). Par exemple, une valeur de entraîne la correspondance des **/TEST-*.xml fichiers à partir de $(System.DefaultWorkingDirectory)/**/TEST-*.xml.

testRunTitle - Titre de la série de tests
string. facultatif. Utilisez quand publishJUnitResults = true.

Spécifie un nom pour la série de tests.

allowBrokenSymlinks - Autoriser les liens symboliques rompus
Alias d’entrée : allowBrokenSymbolicLinks. boolean. facultatif. Utilisez quand publishJUnitResults = true. Valeur par défaut : true.

Lorsque la valeur est définie sur false, la build échoue lorsque la tâche trouve un lien symbolique rompu lors de la publication du résultat des tests.

codeCoverageToolOption - Outil de couverture du code
Alias d’entrée : codeCoverageTool. string. Valeurs autorisées : None, Cobertura, JaCoCo. Valeur par défaut : None.

Spécifie l’outil de couverture du code.

codeCoverageClassFilter - Filtres d’inclusion/exclusion de classe
Alias d’entrée : classFilter. string. facultatif. Utilisez quand codeCoverageTool != None.

Spécifie une liste de filtres séparés par des virgules pour inclure ou exclure les classes de la collecte de la couverture du code. Par exemple : +:com.*,+:org.*,-:my.app*.*.

codeCoverageClassFilesDirectories - Répertoires de fichiers de classe
Alias d’entrée : classFilesDirectories. string. facultatif. Utilisez quand codeCoverageTool = JaCoCo.

Ce champ est requis pour un projet multi-module.
Spécifie une liste séparée par des virgules de chemins d’accès relatifs du fichier Pom Maven vers des répertoires contenant des fichiers de classe et des fichiers d’archive (JAR, WAR, etc.). La couverture du code est signalée pour les fichiers de classe de ces répertoires. Par exemple : target/classes,target/testClasses.

codeCoverageSourceDirectories - Répertoires de fichiers sources
Alias d’entrée : srcDirectories. string. facultatif. Utilisez quand codeCoverageTool = JaCoCo.

Ce champ est requis pour un projet multi-module.
Spécifie une liste séparée par des virgules des chemins d’accès relatifs du fichier Pom Maven vers les répertoires de code source. Les rapports de couverture du code les utilisent pour mettre en évidence le code source. Par exemple : src/java,src/Test.

codeCoverageFailIfEmpty - Échec lorsque les résultats de la couverture du code sont manquants
Alias d’entrée : failIfCoverageEmpty. boolean. facultatif. Utilisez quand codeCoverageTool != None. Valeur par défaut : false.

Échec de la génération si la couverture du code n’a produit aucun résultat à publier.

codeCoverageRestoreOriginalPomXml - Restaurer les pom.xml d’origine après l’exécution de la tâche
Alias d’entrée : restoreOriginalPomXml. boolean. facultatif. Utilisez quand codeCoverageTool != None. Valeur par défaut : false.

La couverture du code change pom.xml pour produire des résultats. Utilisez cette option si vous devez conserver le .pom.xml

javaHomeOption - Définir JAVA_HOME par
Alias d’entrée : javaHomeSelection. string. Obligatoire. Valeurs autorisées : JDKVersion (version JDK), Path. Valeur par défaut : JDKVersion.

Définit JAVA_HOME soit en sélectionnant une version du JDK qui sera découverte pendant les builds, soit en entrant manuellement un chemin JDK.

jdkVersionOption - Version du JDK
Alias d’entrée : jdkVersion. string. facultatif. Utilisez quand javaHomeSelection = JDKVersion. Valeurs autorisées : default, 1.17 (JDK 17), 1.11 (JDK 11), 1.10 (JDK 10 (JDK 10 (hors support)), 1.9 (JDK 9 (hors support)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (hors support)). Valeur par défaut : default.

Tente de découvrir le chemin d’accès à la version JDK sélectionnée et définit JAVA_HOME en conséquence.

jdkDirectory - Chemin JDK
Alias d’entrée : jdkUserInputPath. string. Nécessaire lorsque javaHomeSelection = Path.

Définit JAVA_HOME le chemin d’accès donné.

jdkArchitectureOption - Architecture JDK
Alias d’entrée : jdkArchitecture. string. facultatif. Utilisez quand jdkVersion != default. Valeurs autorisées : x86, x64. Valeur par défaut : x64.

Fournit l’architecture (x86, x64) du JDK.

mavenVersionOption - Version de Maven
Alias d’entrée : mavenVersionSelection. string. Obligatoire. Valeurs autorisées : Default, Path (Chemin personnalisé). Valeur par défaut : Default.

Utilise la version de Maven par défaut ou la version dans le chemin personnalisé spécifié.

mavenDirectory - Chemin Maven
Alias d’entrée : mavenPath. string. Nécessaire lorsque mavenVersionSelection = Path.

Spécifie le chemin d’accès personnalisé à l’installation de Maven (par exemple : /usr/share/maven).

mavenSetM2Home - Définir M2_HOME variable
boolean. facultatif. Utilisez quand mavenVersionSelection = Path. Valeur par défaut : false.

Définit la M2_HOME variable sur un chemin d’installation Maven personnalisé.

mavenOptions - Définissez MAVEN_OPTS sur
Alias d’entrée : mavenOpts. string. Valeur par défaut : -Xmx1024m.

Définit la MAVEN_OPTS variable d’environnement, qui est utilisée pour envoyer des arguments de ligne de commande pour démarrer la JVM. L’indicateur -Xmx spécifie la mémoire maximale disponible pour la machine virtuelle JVM.

mavenAuthenticateFeed - S’authentifier avec des flux d’artefacts
Alias d’entrée : mavenFeedAuthenticate. boolean. Valeur par défaut : true.

S’authentifie automatiquement avec les flux Azure Artifacts. Si les flux Artifacts ne sont pas en cours d’utilisation, désélectionnez cette option pour des builds plus rapides.

sonarQubeRunAnalysis - Exécuter une analyse SonarQube ou SonarCloud
Alias d’entrée : sqAnalysisEnabled. boolean. Valeur par défaut : false.

Cette option est passée de la version 1 de la tâche Maven à l’utilisation des extensions De place de marché SonarQube et SonarCloud .
Activez cette option pour exécuter l’analyse SonarQube ou SonarCloud après avoir exécuté des objectifs dans le champ Objectifs. L’objectif d’installation ou de package doit s’exécuter en premier. Avant cette tâche Maven, vous devez également ajouter une tâche Préparer la configuration de l’analyse à partir de l’une des extensions au pipeline de build.

isJacocoCoverageReportXML - Utiliser des rapports Jacoco XML pour l’analyse SonarQube
boolean. facultatif. Utilisez quand sqAnalysisEnabled = true && codeCoverageTool = JaCoCo. Valeur par défaut : false.

Utilise des rapports Jacoco XML pour l’analyse SonarQube. En savoir plus sur les rapports de test.

sqMavenPluginVersionChoice - Scanneur SonarQube pour la version Maven
string. Nécessaire lorsque sqAnalysisEnabled = true. Valeurs autorisées : latest (Utiliser la dernière version), pom (Utiliser la version déclarée dans votre pom.xml). Valeur par défaut : latest.

Spécifie la version du plug-in SonarQube Maven à utiliser. Vous pouvez utiliser la dernière version ou vous appuyer sur la version dans votre pom.xml.

checkStyleRunAnalysis - Exécuter Checkstyle
Alias d’entrée : checkstyleAnalysisEnabled. boolean. Valeur par défaut : false.

Exécute l’outil Checkstyle avec les vérifications Sun par défaut. Les résultats sont chargés en tant qu’artefacts de build.

pmdRunAnalysis - Exécuter PMD
Alias d’entrée : pmdAnalysisEnabled. boolean. Valeur par défaut : false.

Utilise l’outil d’analyse statique PMD pour rechercher des bogues dans le code. Les résultats sont chargés en tant qu’artefacts de build.

findBugsRunAnalysis - Exécuter FindBugs
Alias d’entrée : findbugsAnalysisEnabled. boolean. Valeur par défaut : false.

Utilise l’outil d’analyse statique FindBugs pour rechercher des bogues dans le code. Les résultats sont chargés en tant qu’artefacts de build.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

La configuration de l’analyse SonarQube a été déplacée vers les extensions SonarQube ou SonarCloud dans la tâche Préparer la configuration de l’analyse.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : maven
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.89.0 ou version ultérieure
Catégorie de la tâche	Build

Voir aussi

• Authentification Maven
• Publier des artefacts Maven avec Azure Pipelines
• Programme d’installation de l’outil Java
• Générer des applications Java