Maven@2 - Maven v2-taak

Gebruik deze taak om te bouwen, te testen en te implementeren met 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.

Invoerwaarden

mavenPOMFile - Maven POM-bestand
string. Vereist. Standaardwaarde: pom.xml.

Hiermee geeft u het relatieve pad van de hoofdmap van de opslagplaats naar het Maven POM-bestand.

goals - Doel(en)
string. Standaardwaarde: package.

options - Opties
string.

publishJUnitResults - Publiceren naar Azure Pipelines
boolean. Standaardwaarde: true.

Hiermee geeft u de optie voor het publiceren van de JUnit-testresultaten die zijn geproduceerd door de Maven-build naar Azure Pipelines. Elke overeenkomende testresultatenbestand Test Results Files wordt gepubliceerd als een testuitvoering in Azure Pipelines.

testResultsFiles - Bestanden met testresultaten
string. Vereist wanneer publishJUnitResults = true. Standaardwaarde: **/TEST-*.xml.

Hiermee geeft u het pad en patroon van testresultaten bestanden te publiceren. Jokertekens kunnen worden gebruikt. Meer informatie over bestandsmatchingspatronen.
Bijvoorbeeld **/TEST-*.xml voor alle XML-bestanden waarvan de naam begint met TEST-.
Als er geen hoofdpad is opgegeven, worden bestanden vergeleken onder de standaardwerkmap, waarvan de waarde beschikbaar is in de variabele $(System.DefaultWorkingDirectory). Een waarde van **/TEST-*.xml resulteert bijvoorbeeld in overeenkomende bestanden uit $(System.DefaultWorkingDirectory)/**/TEST-*.xml.

testRunTitle - Titel van testuitvoering
string. Optioneel. Gebruik wanneer publishJUnitResults = true.

Hiermee geeft u een naam voor de testuitvoering.

allowBrokenSymlinks - Verbroken symbolische koppelingen toestaan
Invoeralias: allowBrokenSymbolicLinks. boolean. Optioneel. Gebruik wanneer publishJUnitResults = true. Standaardwaarde: true.

Als deze optie is ingesteld op false, mislukt de build wanneer de taak een verbroken symbolische koppeling vindt tijdens het publiceren van het testresultaat.

codeCoverageToolOption - Hulpprogramma voor codedekking
Invoeralias: codeCoverageTool. string. Toegestane waarden: None, Cobertura, JaCoCo. Standaardwaarde: None.

Hiermee geeft u het hulpprogramma voor codedekking op.

codeCoverageClassFilter - Klasseninsluitings-/uitsluitingsfilters
Invoeralias: classFilter. string. Optioneel. Gebruik wanneer codeCoverageTool != None.

Hiermee geeft u een door komma's gescheiden lijst met filters op om klassen op te nemen of uit te sluiten van het verzamelen van codedekking. Bijvoorbeeld +:com.*,+:org.*,-:my.app*.*.

codeCoverageClassFilesDirectories - Mappen met klassebestanden
Invoeralias: classFilesDirectories. string. Optioneel. Gebruik wanneer codeCoverageTool = JaCoCo.

Dit veld is vereist voor een project met meerdere modules.
Hiermee geeft u een door komma's gescheiden lijst met relatieve paden van het Maven POM-bestand naar mappen met klassebestanden en archiefbestanden (JAR, WAR, enzovoort). Codedekking wordt gerapporteerd voor klassebestanden in deze mappen. Bijvoorbeeld target/classes,target/testClasses.

codeCoverageSourceDirectories - Mappen van bronbestanden
Invoeralias: srcDirectories. string. Optioneel. Gebruik wanneer codeCoverageTool = JaCoCo.

Dit veld is vereist voor een project met meerdere modules.
Hiermee geeft u een door komma's gescheiden lijst met relatieve paden van het Maven POM-bestand naar broncodemappen. Codedekkingsrapporten gebruiken deze om broncode te markeren. Bijvoorbeeld src/java,src/Test.

codeCoverageFailIfEmpty - Mislukt wanneer de resultaten van de codedekking ontbreken
Invoeralias: failIfCoverageEmpty. boolean. Optioneel. Gebruik wanneer codeCoverageTool != None. Standaardwaarde: false.

De build mislukt als de codedekking geen resultaten heeft geproduceerd om te publiceren.

codeCoverageRestoreOriginalPomXml - Oorspronkelijke pom.xml herstellen na het uitvoeren van de taak
Invoeralias: restoreOriginalPomXml. boolean. Optioneel. Gebruik wanneer codeCoverageTool != None. Standaardwaarde: false.

Codedekking wordt gewijzigd pom.xml om resultaten te produceren. Gebruik deze optie als u de oorspronkelijke pom.xmlwilt behouden.

javaHomeOption - JAVA_HOME instellen op
Invoeralias: javaHomeSelection. string. Vereist. Toegestane waarden: JDKVersion (JDK-versie), Path. Standaardwaarde: JDKVersion.

U kunt dit JAVA_HOME instellen door een JDK-versie te selecteren die tijdens builds wordt gedetecteerd of door handmatig een JDK-pad in te voeren.

jdkVersionOption - JDK-versie
Invoeralias: jdkVersion. string. Optioneel. Gebruik wanneer javaHomeSelection = JDKVersion. Toegestane waarden: default, 1.17 (JDK 17), 1.11 (JDK 11), 1.10 (JDK 10 (niet meer ondersteund)), 1.9 (JDK 9 (niet ondersteund)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (niet ondersteund)). Standaardwaarde: default.

Probeert het pad naar de geselecteerde JDK-versie te detecteren en stelt dienovereenkomstig in JAVA_HOME .

jdkDirectory - JDK-pad
Invoeralias: jdkUserInputPath. string. Vereist wanneer javaHomeSelection = Path.

Hiermee wordt JAVA_HOME ingesteld op het opgegeven pad.

jdkArchitectureOption - JDK-architectuur
Invoeralias: jdkArchitecture. string. Optioneel. Gebruik wanneer jdkVersion != default. Toegestane waarden: x86, x64. Standaardwaarde: x64.

Levert de architectuur (x86, x64) van de JDK.

mavenVersionOption - Maven-versie
Invoeralias: mavenVersionSelection. string. Vereist. Toegestane waarden: Default, Path (Aangepast pad). Standaardwaarde: Default.

Gebruikt de standaard Maven-versie of de versie in het opgegeven aangepaste pad.

mavenDirectory - Maven-pad
Invoeralias: mavenPath. string. Vereist wanneer mavenVersionSelection = Path.

Hiermee geeft u het aangepaste pad naar de Maven-installatie (bijvoorbeeld: /usr/share/maven).

mavenSetM2Home - M2_HOME variabele instellen
boolean. Optioneel. Gebruik wanneer mavenVersionSelection = Path. Standaardwaarde: false.

Hiermee stelt u de M2_HOME variabele in op een aangepast Maven-installatiepad.

mavenOptions - Stel MAVEN_OPTS in op
Invoeralias: mavenOpts. string. Standaardwaarde: -Xmx1024m.

Hiermee stelt u de MAVEN_OPTS omgevingsvariabele in, die wordt gebruikt om opdrachtregelargumenten te verzenden om de JVM te starten. De -Xmx vlag geeft het maximale geheugen aan dat beschikbaar is voor de JVM.

mavenAuthenticateFeed - Verifiëren met artefactenfeeds
Invoeralias: mavenFeedAuthenticate. boolean. Standaardwaarde: true.

Verifieert automatisch met Azure Artifacts-feeds. Als artefactenfeeds niet in gebruik zijn, schakelt u deze optie uit voor snellere builds.

sonarQubeRunAnalysis - SonarQube- of SonarCloud-analyse uitvoeren
Invoeralias: sqAnalysisEnabled. boolean. Standaardwaarde: false.

Deze optie is gewijzigd van het gebruik van versie 1 van de Maven-taak in het gebruik van de Marketplace-extensies SonarQube en SonarCloud .
Schakel deze optie in om Een SonarQube- of SonarCloud-analyse uit te voeren na het uitvoeren van doelen in het veld Goals. Het installatie- of pakketdoel moet eerst worden uitgevoerd. Vóór deze Maven-taak moet u ook een taak Analyseconfiguratie voorbereiden vanuit een van de extensies toevoegen aan de build-pijplijn.

isJacocoCoverageReportXML - XML Jacoco-rapporten gebruiken voor SonarQube-analyse
boolean. Optioneel. Gebruik wanneer sqAnalysisEnabled = true && codeCoverageTool = JaCoCo. Standaardwaarde: false.

Maakt gebruik van XML Jacoco-rapporten voor SonarQube-analyse. Meer informatie over testrapporten.

sqMavenPluginVersionChoice - SonarQube-scanner voor Maven-versie
string. Vereist wanneer sqAnalysisEnabled = true. Toegestane waarden: latest (Gebruik de nieuwste versie), pom (Gebruik versie die is gedeclareerd in uw pom.xml). Standaardwaarde: latest.

Hiermee geeft u de versie van de SonarQube Maven-invoegtoepassing te gebruiken. U kunt de nieuwste versie gebruiken of vertrouwen op de versie in uw pom.xml.

checkStyleRunAnalysis - Controlestijl uitvoeren
Invoeralias: checkstyleAnalysisEnabled. boolean. Standaardwaarde: false.

Hiermee voert u het hulpprogramma Checkstyle uit met de standaard sun-controles. Resultaten worden geüpload als buildartefacten.

pmdRunAnalysis - PMD uitvoeren
Invoeralias: pmdAnalysisEnabled. boolean. Standaardwaarde: false.

Maakt gebruik van het hulpprogramma voor statische pmd-analyse om te zoeken naar fouten in de code. Resultaten worden geüpload als buildartefacten.

findBugsRunAnalysis - FindBugs uitvoeren
Invoeralias: findbugsAnalysisEnabled. boolean. Standaardwaarde: false.

Maakt gebruik van het statische analysehulpprogramma FindBugs om te zoeken naar fouten in de code. Resultaten worden geüpload als buildartefacten.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

De configuratie van de SonarQube-analyse is verplaatst naar de SonarQube - of SonarCloud-extensies in de taak Analyseconfiguratie voorbereiden.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: maven
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.89.0 of hoger
Taakcategorie	Build

Zie ook

• Maven-verificatie
• Maven-artefacten publiceren met Azure Pipelines
• Java-hulpprogramma-installatieprogramma
• Java-apps bouwen