Maven@2 - Maven v2 작업

이 작업을 사용하여 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.

입력

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

리포지토리 루트에서 Maven POM 파일로의 상대 경로를 지정합니다.

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

options - 옵션
string.

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

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

testResultsFiles - 테스트 결과 파일
string. 필요한 경우 publishJUnitResults = true입니다. 기본값은 **/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입니다.

코드 검사 도구를 지정합니다.

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 .

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 .

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. 기본값은 true입니다.

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

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

이 옵션은 Maven 작업 버전 1 사용에서 SonarQube 및 SonarCloud 마켓플레이스 확장 사용으로 변경되었습니다.
Goals 필드에서 목표를 실행한 후 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 도구를 실행합니다. 결과는 빌드 아티팩트로 업로드됩니다.

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

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

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

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

작업 제어 옵션

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

출력 변수

없음

설명

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

요구 사항

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

추가 정보

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