Maven@3 - Maven v3 작업

2025-06-24

이 작업을 사용하여 Apache Maven을 사용하여 빌드, 테스트 및 배포합니다.

이 버전의 작업은 더 이상 사용되지 않습니다. Maven@4사용합니다.

이 작업을 사용하여 Apache Maven을 사용하여 빌드, 테스트 및 배포합니다.

문법

# Maven v3
# Build, test, and deploy with Apache Maven.
- task: Maven@3
  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: '**/surefire-reports/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/surefire-reports/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.21' | '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: false # boolean. Alias: mavenFeedAuthenticate. Authenticate with Artifacts feeds. Default: false.
    #effectivePomSkip: false # boolean. Alias: skipEffectivePom. Skip generating effective POM while authenticating with Artifacts feeds. Default: false.
  # 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.
    #spotBugsRunAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs analysis. Default: false.
    #spotBugsVersion: '4.5.3.0' # string. Alias: spotBugsMavenPluginVersion. Optional. Use when spotBugsAnalysisEnabled = true. Version number. Default: 4.5.3.0.
    #spotBugsGoal: 'spotbugs' # 'spotbugs' | 'check'. Optional. Use when spotBugsAnalysisEnabled = true. The goal for the spotbugs plugin. Default: spotbugs.
    #failWhenBugsFound: true # boolean. Alias: spotBugsFailWhenBugsFound | sbFailWhenBugsFound. Optional. Use when spotBugsAnalysisEnabled = true && spotBugsGoal = check. Fail when bugs are found with spotbugs:check. Default: true.

# Maven v3
# Build, test, and deploy with Apache Maven.
- task: Maven@3
  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: '**/surefire-reports/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/surefire-reports/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: false # boolean. Alias: mavenFeedAuthenticate. Authenticate with Artifacts feeds. Default: false.
    #effectivePomSkip: false # boolean. Alias: skipEffectivePom. Skip generating effective POM while authenticating with Artifacts feeds. Default: false.
  # 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.
    #spotBugsRunAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs analysis. Default: false.
    #spotBugsVersion: '4.5.3.0' # string. Alias: spotBugsMavenPluginVersion. Optional. Use when spotBugsAnalysisEnabled = true. Version number. Default: 4.5.3.0.
    #spotBugsGoal: 'spotbugs' # 'spotbugs' | 'check'. Optional. Use when spotBugsAnalysisEnabled = true. The goal for the spotbugs plugin. Default: spotbugs.
    #failWhenBugsFound: true # boolean. Alias: spotBugsFailWhenBugsFound | sbFailWhenBugsFound. Optional. Use when spotBugsAnalysisEnabled = true && spotBugsGoal = check. Fail when bugs are found with spotbugs:check. Default: true.

# Maven v3
# Build, test, and deploy with Apache Maven.
- task: Maven@3
  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: '**/surefire-reports/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/surefire-reports/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: false # boolean. Alias: mavenFeedAuthenticate. Authenticate built-in Maven feeds. Default: false.
    #effectivePomSkip: false # boolean. Alias: skipEffectivePom. Skip generating effective POM while authenticating built-in feeds. Default: false.
  # 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.
    #spotBugsRunAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs analysis. Default: false.
    #spotBugsVersion: '4.5.3.0' # string. Alias: spotBugsMavenPluginVersion. Optional. Use when spotBugsAnalysisEnabled = true. Version number. Default: 4.5.3.0.
    #spotBugsGoal: 'spotbugs' # 'spotbugs' | 'check'. Optional. Use when spotBugsAnalysisEnabled = true. The goal for the spotbugs plugin. Default: spotbugs.
    #failWhenBugsFound: true # boolean. Alias: spotBugsFailWhenBugsFound | sbFailWhenBugsFound. Optional. Use when spotBugsAnalysisEnabled = true && spotBugsGoal = check. Fail when bugs are found with spotbugs:check. Default: true.

# Maven v3
# Build, test, and deploy with Apache Maven.
- task: Maven@3
  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: '**/surefire-reports/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/surefire-reports/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
  # 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.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: false # boolean. Alias: mavenFeedAuthenticate. Authenticate built-in Maven feeds. Default: false.
    #effectivePomSkip: false # boolean. Alias: skipEffectivePom. Skip generating effective POM while authenticating built-in feeds. Default: false.
  # 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.

# Maven v3
# Build, test, and deploy with Apache Maven.
- task: Maven@3
  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: '**/surefire-reports/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/surefire-reports/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
  # 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.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '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: false # boolean. Alias: mavenFeedAuthenticate. Authenticate built-in Maven feeds. Default: false.
    #effectivePomSkip: false # boolean. Alias: skipEffectivePom. Skip generating effective POM while authenticating built-in feeds. Default: false.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud 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.

입력

maven POM 파일mavenPOMFile -
string; 필수 사항입니다. 기본값은 pom.xml입니다.

리포지토리 루트에서 Maven POM 파일로의 상대 경로를 지정합니다. 자세한 내용은 POM 소개 를 참조하십시오.

goals - 목표
string; 기본값은 package입니다.

(선택 사항) 코드를 컴파일하고 .war 파일로 패키지화하도록 설정합니다 package . 이 인수를 비워 두면 빌드가 실패합니다. 자세한 내용은 Maven 빌드 수명 주기 소개 를 참조하세요.

options - 옵션
string;

(선택 사항) 사용할 Maven 명령줄 옵션을 지정합니다.

Azure Pipelines게시 publishJUnitResults -
boolean; 기본값은 true입니다.

Maven 빌드에서 생성된 JUnit 테스트 결과를 Azure Pipelines에 게시하는 옵션을 지정합니다. 각 테스트 결과 파일 일치 Test Results Files Azure Pipelines에서 테스트 실행으로 게시됩니다.

testResultsFiles - 테스트 결과 파일
string; publishJUnitResults = true때 필요합니다. 기본값은 **/surefire-reports/TEST-*.xml입니다.

게시할 테스트 결과 파일의 경로와 패턴을 지정합니다.
와일드 카드를 사용할 수 있습니다.
파일 일치 패턴에 대한 자세한 정보.
예를 들어 이름이 **/TEST-*.xml시작하는 모든 XML 파일에 대해 TEST-. 루트 경로가 지정되지 않은 경우 파일은 기본 작업 디렉터리 아래에 일치하며 이 값은 변수 $(System.DefaultWorkingDirectory)사용할 수 있습니다. 예를 들어 **/TEST-*.xml 값은 실제로 $(System.DefaultWorkingDirectory)/**/TEST-*.xml파일과 일치합니다.

testRunTitle - 실행 타이틀
string; 선택 사항입니다. publishJUnitResults = true때 사용합니다.

테스트 실행의 이름을 지정합니다.

allowBrokenSymlinks - 끊어진 심볼 링크 허용
입력 별칭: allowBrokenSymbolicLinks. boolean; 선택 사항입니다. publishJUnitResults = true때 사용합니다. 기본값은 true입니다.

로 false설정하면 테스트 결과를 게시하는 동안 작업이 끊어진 심볼릭 링크를 찾을 때 빌드에 실패합니다.

codeCoverageToolOption - 코드 검사 도구
입력 별칭: codeCoverageTool. string; 허용되는 값: None, Cobertura, JaCoCo. 기본값은 None입니다.

코드 검사 도구를 지정합니다. 코드 검사를 사용하도록 설정하면 Maven이 실행될 때 Maven 목표 목록에 clean 목표가 삽입됩니다.

codeCoverageClassFilter - 클래스 포함/제외 필터
입력 별칭: classFilter. string; 선택 사항입니다. codeCoverageTool != None때 사용합니다.

코드 검사 수집에서 클래스를 포함하거나 제외할 쉼표로 구분된 필터 목록을 지정합니다. 예: +:com.*,+:org.*,-:my.app*.*.

codeCoverageClassFilesDirectories - 클래스 파일 디렉터리
입력 별칭: classFilesDirectories. string; 선택 사항입니다. codeCoverageTool = JaCoCo때 사용합니다.

이 필드는 다중 모듈 프로젝트에 필요합니다.
Maven POM 파일에서 클래스 파일 및 아카이브 파일(JAR, WAR 등)을 포함하는 디렉터리까지의 상대 경로의 쉼표로 구분된 목록을 지정합니다. 이러한 디렉터리에 있는 클래스 파일에 대한 코드 적용 범위가 보고됩니다. 예: target/classes,target/testClasses.

원본 파일 디렉터리codeCoverageSourceDirectories -
입력 별칭: srcDirectories. string; 선택 사항입니다. codeCoverageTool = JaCoCo때 사용합니다.

이 필드는 다중 모듈 프로젝트에 필요합니다.
Maven POM 파일에서 소스 코드 디렉터리로 쉼표로 구분된 상대 경로 목록을 지정합니다. 코드 검사 보고서에서는 이를 사용하여 소스 코드를 강조 표시합니다. 예: src/java,src/Test.

코드 검사 결과가 누락된 경우 codeCoverageFailIfEmpty - 실패
입력 별칭: failIfCoverageEmpty. boolean; 선택 사항입니다. codeCoverageTool != None때 사용합니다. 기본값은 false입니다.

코드 검사에서 게시할 결과를 생성하지 않은 경우 빌드에 실패합니다.

codeCoverageRestoreOriginalPomXml - 작업 실행 후 원본 pom.xml 복원
입력 별칭: restoreOriginalPomXml. boolean; 선택 사항입니다. codeCoverageTool != None때 사용합니다. 기본값은 false입니다.

코드 검사는 결과를 생성하도록 수정됩니다 pom.xml . 원본을 pom.xml유지해야 하는 경우 이 옵션을 사용합니다.

javaHomeOption - JAVA_HOME 설정
입력 별칭: javaHomeSelection. string; 필수 사항입니다. 허용되는 값: JDKVersion(JDK 버전), Path. 기본값은 JDKVersion입니다.

빌드 중에 검색될 JDK 버전을 선택하거나 JDK 경로를 수동으로 입력하여 JAVA_HOME 설정합니다. 에이전트 시스템에 Java가 이미 설치되어 있는 경우 JDK 설치 디렉토리의 경로로 pathjdkDirectory 설정하여 javaHomeOption 지정할 수 있습니다.

JDK 버전
입력 별칭: jdkVersion. string; 선택 사항입니다. javaHomeSelection = JDKVersion때 사용합니다. 허용되는 값: default, 1.21 (JDK 21), 1.17 (JDK 17), 1.11 (JDK 11), 1.10 (JDK 10 (지원되지 않음)), 1.9 (JDK 9 (지원되지 않음)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (지원되지 않음)). 기본값은 default입니다.

선택한 JDK 버전의 경로를 검색하려고 시도하고 그에 따라 설정합니다 JAVA_HOME .
메모: Microsoft에서 호스팅하지 않는 에이전트에서 실행 중이고 요청된 Java 버전이 에이전트 컴퓨터에 설정된 변수로 표시된 JAVA_HOME 버전이 아닌 경우 작업은 변수 JAVA_HOME_{version}_{arch} (예: JAVA_HOME_8_X64)를 사용하여 필요한 JDK를 찾습니다. 이 변수가 이 매개 변수 및/또는 에 의해 jdkArchitecture요청될 수 있는 JDK의 모든 버전 및 아키텍처에 대해 자체 호스팅 에이전트에 설정되어 있는지 확인합니다.

JDK 버전
입력 별칭: jdkVersion. string; 선택 사항입니다. javaHomeSelection = JDKVersion때 사용합니다. 허용되는 값은 default, 1.17(JDK 17), 1.11(JDK 11), 1.10(JDK 10(지원되지 않는 경우), 1.9(JDK 9(지원되지 않는)), 1.8(JDK 8), 1.7(JDK 7), 1.6(JDK 6(지원되지 않는 경우)입니다. 기본값은 default입니다.

JDK 버전
입력 별칭: jdkVersion. string; 선택 사항입니다. javaHomeSelection = JDKVersion때 사용합니다. 허용되는 값은 default, 1.11(JDK 11), 1.10(JDK 10(지원되지 않는 경우), 1.9(JDK 9(지원되지 않는 경우), 1.8(JDK 8), 1.7(JDK 7), 1.6(JDK 6(지원되지 않는 경우)입니다. 기본값은 default입니다.

선택한 JDK 버전의 경로를 검색하려고 시도하고 그에 따라 설정합니다 JAVA_HOME .

JDK 경로jdkDirectory -
입력 별칭: jdkUserInputPath. string; javaHomeSelection = Path때 필요합니다.

지정된 경로에 JAVA_HOME 설정합니다.

JDK 아키텍처
입력 별칭: jdkArchitecture. string; 선택 사항입니다. jdkVersion != default때 사용합니다. 허용되는 값: x86, x64. 기본값은 x64입니다.

JDK의 아키텍처(x86, x64)를 제공합니다.

mavenVersionOption - Maven 버전
입력 별칭: mavenVersionSelection. string; 필수 사항입니다. 허용되는 값: Default, Path(사용자 지정 경로). 기본값은 Default입니다.

기본 Maven 버전 또는 지정된 사용자 지정 경로의 버전을 지정합니다.

mavenDirectory - Maven 경로
입력 별칭: mavenPath. string; mavenVersionSelection = Path때 필요합니다.

Maven 설치에 대한 사용자 지정 경로를 제공합니다(예: /usr/share/maven).

mavenSetM2Home - M2_HOME 변수 설정
boolean; 선택 사항입니다. mavenVersionSelection = Path때 사용합니다. 기본값은 false입니다.

M2_HOME 변수를 사용자 지정 Maven 설치 경로로 설정합니다.

mavenOptions - MAVEN_OPTS 설정
입력 별칭: mavenOpts. string; 기본값은 -Xmx1024m입니다.

JVM을 시작하기 위해 명령줄 인수를 보내는 데 사용되는 MAVEN_OPTS 환경 변수를 설정합니다. -Xmx 플래그는 JVM에 사용할 수 있는 최대 메모리를 지정합니다.

mavenAuthenticateFeed - Artifacts 피드를 사용하여 인증
입력 별칭: mavenFeedAuthenticate. boolean; 기본값은 false입니다.

Azure Artifacts 피드를 사용하여 자동으로 인증합니다. 아티팩트 피드를 사용하지 않는 경우 더 빠른 빌드를 위해 이 옵션을 선택 취소합니다.

mavenAuthenticateFeed - 기본 제공 Maven 피드 인증
입력 별칭: mavenFeedAuthenticate. boolean; 기본값은 false입니다.

Azure Artifacts 피드를 사용하여 자동으로 인증합니다. 아티팩트 피드를 사용하지 않는 경우 더 빠른 빌드를 위해 이 옵션을 선택 취소합니다.

effectivePomSkip - Artifacts 피드로 인증하는 동안 효과적인 POM 생성 건너뛰기
입력 별칭: skipEffectivePom. boolean; 기본값은 false입니다.

POM만 사용하여 Artifacts 피드로 인증합니다.

effectivePomSkip - 내장 피드를 인증하는 동안 효과적인 POM 생성 건너뛰기
입력 별칭: skipEffectivePom. boolean; 기본값은 false입니다.

POM만 사용하여 Artifacts 피드로 인증합니다.

sonarQubeRunAnalysis - SonarQube 또는 SonarCloud 분석 실행
입력 별칭: sqAnalysisEnabled. boolean; 기본값은 false입니다.

이 옵션은 Maven 작업 버전 1 사용에서 SonarQube 및 SonarCloud 마켓플레이스 확장 사용으로 변경되었습니다.
목표 필드에서 목표를 실행한 후 SonarQube 또는 SonarCloud 분석을 실행하려면 이 옵션을 활성화합니다. install 또는 package 목표가 먼저 실행되어야 합니다. 이 Maven 작업 전에 확장 중 하나에서 빌드 파이프라인에 분석 구성 준비 작업도 추가해야 합니다.

isJacocoCoverageReportXML - SonarQube 분석을 위해 XML Jacoco 보고서 사용
boolean; 선택 사항입니다. sqAnalysisEnabled = true && codeCoverageTool = JaCoCo때 사용합니다. 기본값은 false입니다.

SonarQube 분석을 위해 XML Jacoco 보고서를 사용합니다. 테스트 보고서에 대해 자세히 알아보세요.

sqMavenPluginVersionChoice - Maven 버전용 SonarQube 스캐너
string; sqAnalysisEnabled = true때 필요합니다. 허용되는 값: latest (최신 릴리스 사용), pom (pom.xml에 선언된 버전 사용). 기본값은 latest입니다.

사용할 SonarQube Maven 플러그인 버전을 지정합니다. 최신 버전을 pom.xml사용하거나 .

checkStyleRunAnalysis - 실행 체크 스타일
입력 별칭: checkstyleAnalysisEnabled. boolean; 기본값은 false입니다.

기본 Sun 검사를 사용하여 체크 스타일 도구를 실행합니다. 파일에 Checkstyle 구성이 지정되지 않은 경우 기본 Sun 검사가 pom.xml 사용됩니다. 결과는 빌드 아티팩트로 업로드됩니다.

PMD실행 pmdRunAnalysis -
입력 별칭: pmdAnalysisEnabled. boolean; 기본값은 false입니다.

PMD 정적 분석 도구를 사용하여 코드에서 버그를 찾습니다. 결과는 빌드 아티팩트로 업로드됩니다.

FindBugs실행 findBugsRunAnalysis -
입력 별칭: findbugsAnalysisEnabled. boolean; 기본값은 false입니다.

FindBugs 정적 분석 도구를 사용하여 코드에서 버그를 찾습니다. 결과는 빌드 아티팩트로 업로드됩니다.

spotBugsRunAnalysis - SpotBugs 분석 실행
입력 별칭: spotBugsAnalysisEnabled. boolean; 기본값은 false입니다.

이 옵션을 활성화하면 SpotBugs 코드 분석 플러그인을 실행할 수 있습니다. SpotBugs Maven 플러그인에 대한 자세한 정보.

spotBugsVersion - 버전 번호
입력 별칭: spotBugsMavenPluginVersion. string; 선택 사항입니다. spotBugsAnalysisEnabled = true때 사용합니다. 기본값은 4.5.3.0입니다.

사용 가능한 SpotBugs 버전에 대해 알아보세요.

spotBugsGoal - spotbugs 플러그인의 목표
string; 선택 사항입니다. spotBugsAnalysisEnabled = true때 사용합니다. 허용되는 값: spotbugs ("spotbugs" - 발견된 버그에 대한 보고서 만들기), check ("check" - 버그가 검색된 경우 파이프라인이 실패함). 기본값은 spotbugs입니다.

플러그인의 목표를 지정합니다. SpotBugs 목표에 대해 자세히 알아보세요.

failWhenBugsFound - spotbugs에서 버그가 발견되면 실패:확인
입력 별칭: spotBugsFailWhenBugsFound | sbFailWhenBugsFound. boolean; 선택 사항입니다. spotBugsAnalysisEnabled = true && spotBugsGoal = check때 사용합니다. 기본값은 true입니다.

Check Goal이 지정된 경우 버그가 발견되면 실패합니다. SpotBug 매개 변수 세부 정보에 대해 자세히 알아보세요.

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

비고

SonarQube 분석의 구성이 분석 구성 준비 작업의 SonarQube 또는 SonarCloud 확장으로 이동되었습니다.

중요합니다

에서 MAVEN_OPTS옵션을 사용하는 -q 경우 효과적인 pom이 올바르게 생성되지 않으며 Azure Artifacts 피드를 인증하지 못할 수 있습니다.

중요합니다

사용하려는 JDK 버전이 에이전트에 이미 설치되어 있는 경우 를 JDK 버전의 경로로 path 설정하고 javaHomeOption 설정합니다jdkDirectory. 이러한 옵션은 Maven 작업에 필요한 환경 변수를 설정합니다 JAVA_HOME_11_X64 . 이 환경 변수는 Java Tool 설치 프로그램 태스크를 사용하는 경우 자동으로 설정됩니다.

자주 묻는 질문(FAQ)

다중 모듈 프로젝트가 있지만 빌드가 실패합니다. 무엇을 확인해야 하나요?

및 #codeCoverageSourceDirectories 를 작업 입력으로 지정 #codeCoverageClassFilesDirectories 했는지 확인합니다. 이 두 매개 변수는 단일 모듈 프로젝트의 경우 선택 사항이지만 다중 모듈 프로젝트에는 필요합니다.

예시

Java 응용 프로그램을 빌드하고 Azure Web App에 배포합니다.

요구 사항

요구 사항	설명
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행	에이전트, DeploymentGroup
요구	자체 호스팅 에이전트에는 다음 요구 사항과 일치하는 기능이 있어야 하며, 이 작업을 사용하는 작업을 실행해야 합니다. maven
기능	이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한	어느 것이든
settable 변수	어느 것이든
에이전트 버전	1.89.0 이상
작업 범주	빌드