Maven@3 - Maven v3 작업

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

Syntax

# 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.

입력

mavenPOMFile - Maven POM 파일
string. 필수 요소. 기본값은 pom.xml입니다.

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

goals - 목표(s)
string. 기본값은 package입니다.

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

options - 옵션
string.

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

publishJUnitResults - Azure Pipelines에 게시
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 목표 목록에 삽입됩니다.

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 하여 지정할 수 있습니다.

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

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

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

jdkArchitectureOption - 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 - 아티팩트 피드를 사용하여 인증
입력 별칭: mavenFeedAuthenticate. boolean. 기본값은 false입니다.

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

effectivePomSkip - 아티팩트 피드를 사용하여 인증하는 동안 효과적인 POM 생성 건너뛰기
입력 별칭: skipEffectivePom. boolean. 기본값은 false입니다.

POM만 사용하여 아티팩트 피드를 사용하여 인증합니다.

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

이 옵션은 Maven 작업 버전 1 사용에서 SonarQube 및 SonarCloud 마켓플레이스 확장 사용으로 변경되었습니다.
목표 필드에서 목표를 실행한 후 SonarQube 또는 SonarCloud 분석을 실행하려면 이 옵션을 사용하도록 설정합니다. 설치 또는 패키지 목표가 먼저 실행되어야 합니다. 이 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 도구를 실행합니다. 파일에 체크스타일 구성이 지정되지 pom.xml 않은 경우 기본 Sun 검사가 사용됩니다. 결과는 빌드 아티팩트로 업로드됩니다.

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

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

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

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

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

SpotBugs 코드 분석 플러그 인을 실행하려면 이 옵션을 사용하도록 설정합니다. SpotBugs Maven 플러그 인에 대한 자세한 정보입니다.

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

SpotBugs의 사용 가능한 버전에 대해 알아봅니다.

spotBugsGoal - 스폿버그 플러그 인의 목표
string. 선택 사항입니다. 를 사용하는 경우 spotBugsAnalysisEnabled = true를 사용합니다. 허용되는 값: spotbugs ("spotbugs" - 찾은 버그에 대한 보고서를 만듭니다. check ("검사" - 버그가 감지되면 파이프라인이 실패함). 기본값은 spotbugs입니다.

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

failWhenBugsFound - 스폿버그를 사용하여 버그가 발견되면 실패:검사
입력 별칭: spotBugsFailWhenBugsFound | sbFailWhenBugsFound. boolean. 선택 사항입니다. 를 사용하는 경우 spotBugsAnalysisEnabled = true && spotBugsGoal = check를 사용합니다. 기본값은 true입니다.

확인 목표가 지정된 경우 버그가 발견되면 실패합니다. SpotBug 매개 변수 세부 정보에 대해 자세히 알아봅니다.

작업 제어 옵션

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

출력 변수

없음

설명

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

중요

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

중요

사용하려는 JDK 버전이 에이전트에 이미 설치된 경우 를 로 path 설정하고 javaHomeOption 를 JDK 버전의 경로로 설정합니다jdkDirectory. 이러한 옵션은 Maven 작업에 필요한 환경 변수를 설정합니다 JAVA_HOME_11_X64 . 이 환경 변수는 Java 도구 설치 관리자 작업을 사용하는 경우 자동으로 설정됩니다.

FAQ

다중 모듈 프로젝트가 있지만 빌드가 실패합니다. 무엇을 검사?

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

예제

• Java 애플리케이션을 빌드하고 Azure Web App에 배포합니다.

요구 사항

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

추가 정보

• Maven 인증
• Azure Pipelines를 사용하여 Maven 아티팩트 게시
• Java 도구 설치 관리자
• Java 앱 빌드