Maven@1 - Задача Maven v1

2025-06-24

Используйте эту задачу для сборки с помощью Apache Maven.

Эта версия задачи устарела; используйте Maven@4.

Синтаксис

# Maven v1
# Build with Apache Maven.
- task: Maven@1
  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 TFS/Team Services. 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. 
  # 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.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 built-in Maven feeds. Default: true.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube Analysis. Default: false.
    #sonarQubeServiceEndpoint: # string. Alias: sqConnectedServiceName. Required when sqAnalysisEnabled = true. SonarQube Endpoint. 
    #sonarQubeProjectName: # string. Alias: sqProjectName. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Name. 
    #sonarQubeProjectKey: # string. Alias: sqProjectKey. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Key. 
    #sonarQubeProjectVersion: # string. Alias: sqProjectVersion. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Version. 
    #sonarQubeSpecifyDB: false # boolean. Alias: sqDbDetailsRequired. Optional. Use when sqAnalysisEnabled = true. The SonarQube server version is lower than 5.2. Default: false.
    #sonarQubeDBUrl: # string. Alias: sqDbUrl. Optional. Use when sqDbDetailsRequired = true. Db Connection String. 
    #sonarQubeDBUsername: # string. Alias: sqDbUsername. Optional. Use when sqDbDetailsRequired = true. Db Username. 
    #sonarQubeDBPassword: # string. Alias: sqDbPassword. Optional. Use when sqDbDetailsRequired = true. Db User Password. 
    #sonarQubeIncludeFullReport: true # boolean. Alias: sqAnalysisIncludeFullReport. Optional. Use when sqAnalysisEnabled = true. Include full analysis report in the build summary (SQ 5.3+). Default: true.
    #sonarQubeFailWhenQualityGateFails: # boolean. Alias: sqAnalysisBreakBuildIfQualityGateFailed. Optional. Use when sqAnalysisEnabled = true. Fail the build on quality gate failure (SQ 5.3+). 
    #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.

Указывает относительный путь из корневого каталога репозитория в файл POM Maven.

цели goals -
string. Значение по умолчанию: package.

параметры options -
string.

publishJUnitResults - Публикация в TFS/Team Services
boolean. Значение по умолчанию: true.

Указывает параметр для публикации результатов теста JUnit, полученных сборкой Maven, в службах TFS/Team Services. Каждый файл с сопоставлением Test Results Files результатов теста будет опубликован в виде тестового прогона в TFS/Team Services.

testResultsFiles - файлы результатов тестирования
string. Требуется, если publishJUnitResults = true. Значение по умолчанию: **/TEST-*.xml.

Указывает путь и шаблон файлов результатов теста для публикации. Например, для всех XML-файлов с именем, **/TEST-*.xml которое начинается с TEST-. Если корневой путь не указан, файлы сопоставляются под рабочим каталогом по умолчанию, значение которого доступно в переменной $(System.DefaultWorkingDirectory). Например, значение **/TEST-*.xml фактически приведет к сопоставлению файлов из $(System.DefaultWorkingDirectory)/**/TEST-*.xml.

testRunTitle - заголовок тестового запуска
string. Необязательно. Используется при publishJUnitResults = true.

Задает имя тестового запуска.

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.

Это поле требуется для проекта с несколькими модулями.
Задает разделенный запятыми список относительных путей из файла POM Maven в каталоги исходного кода. Отчеты о охвате кода будут использовать их для выделения исходного кода. Например: src/java,src/Test.

codeCoverageFailIfEmpty - Сбой при отсутствии результатов покрытия кода
Псевдоним ввода: failIfCoverageEmpty. boolean. Необязательно. Используется при codeCoverageTool != None. Значение по умолчанию: false.

Завершается сбоем сборки, если покрытие кода не дает никаких результатов для публикации.

javaHomeOption - Задать JAVA_HOME
Псевдоним ввода: javaHomeSelection. string. Обязательное. Допустимые значения: JDKVersion (версия JDK), Path. Значение по умолчанию: JDKVersion.

Задает JAVA_HOME либо путем выбора версии JDK, которая будет обнаружена во время сборки, либо путем ввода пути JDK вручную.

jdkVersionOption - Версия JDK
Псевдоним ввода: jdkVersion. string. Необязательно. Используется при javaHomeSelection = JDKVersion. Допустимые значения: default, 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.

Предоставляет архитектуру (x86, x64) JDK.

mavenVersionOption - Версия Maven
Псевдоним ввода: mavenVersionSelection. string. Обязательное. Допустимые значения: Default, Path (пользовательский путь). Значение по умолчанию: Default.

Использует версию Maven по умолчанию или версию в указанном пользовательском пути.

mavenDirectory - Путь Мейвен
Псевдоним ввода: mavenPath. string. Требуется, если mavenVersionSelection = Path.

Предоставляет пользовательский путь к установке Maven (например, /usr/share/maven).

mavenSetM2Home - Задать M2_HOME переменную
boolean. Необязательно. Используется при mavenVersionSelection = Path. Значение по умолчанию: false.

Задает переменную M2_HOME для пользовательского пути установки Maven.

mavenOptions - задать MAVEN_OPTS значение
Псевдоним ввода: mavenOpts. string. Значение по умолчанию: -Xmx1024m.

Задает переменную среды MAVEN_OPTS, которая используется для отправки аргументов командной строки для запуска JVM. Флаг -Xmx указывает максимальную память, доступную для JVM.

mavenAuthenticateFeed - аутентификация встроенных веб-каналов Maven
Псевдоним ввода: mavenFeedAuthenticate. boolean. Значение по умолчанию: true.

Автоматически выполняет проверку подлинности с помощью веб-каналов Артефактов Azure. Если веб-каналы артефактов не используются, отключите этот параметр для ускорения сборок.

sonarQubeRunAnalysis - Запуск анализа SonarQube
Псевдоним ввода: sqAnalysisEnabled. boolean. Значение по умолчанию: false.

Запускает анализ SonarQube после выполнения текущих целей. install Или package цели должны быть выполнены в первую очередь.

sonarQubeServiceEndpoint - Конечная точка SonarQube
Псевдоним ввода: sqConnectedServiceName. string. Требуется, если sqAnalysisEnabled = true.

Указывает универсальную конечную точку сервера SonarQube.

sonarQubeProjectName - Название проекта SonarQube
Псевдоним ввода: sqProjectName. string. Необязательно. Используется при sqAnalysisEnabled = true.

Указывает имя проекта SonarQube, например sonar.projectName.

sonarQubeProjectKey - Ключ проекта SonarQube
Псевдоним ввода: sqProjectKey. string. Необязательно. Используется при sqAnalysisEnabled = true.

Указывает уникальный ключ проекта SonarQube, например sonar.projectKey.

sonarQubeProjectVersion - Версия проекта SonarQube
Псевдоним ввода: sqProjectVersion. string. Необязательно. Используется при sqAnalysisEnabled = true.

Указывает версию проекта SonarQube, например sonar.projectVersion.

sonarQubeSpecifyDB - Версия сервера SonarQube ниже 5.2
Псевдоним ввода: sqDbDetailsRequired. boolean. Необязательно. Используется при sqAnalysisEnabled = true. Значение по умолчанию: false.

Если вы используете сервер SonarQube 5.1 или ниже, необходимо указать данные подключения к базе данных.

sonarQubeDBUrl - Строка подключения db
Псевдоним ввода: sqDbUrl. string. Необязательно. Используется при sqDbDetailsRequired = true.

Используйте только для сервера SonarQube 5.1 и ниже.
Указывает параметр подключения к базе данных (например, sonar.jdbc.url или jdbc:jtds:sqlserver://localhost/sonar;SelectMethod=Cursor).

sonarQubeDBUsername - db Имя пользователя
Псевдоним ввода: sqDbUsername. string. Необязательно. Используется при sqDbDetailsRequired = true.

Используйте только для сервера SonarQube 5.1 и ниже.
Указывает имя пользователя для пользователя базы данных (например, sonar.jdbc.username).

sonarQubeDBPassword - db Пароль пользователя
Псевдоним ввода: sqDbPassword. string. Необязательно. Используется при sqDbDetailsRequired = true.

Используйте только для сервера SonarQube 5.1 и ниже.
Указывает пароль для пользователя базы данных (например, sonar.jdbc.password).

sonarQubeIncludeFullReport - Включение полного отчета об анализе в сводку сборки (SQ 5.3+)
Псевдоним ввода: sqAnalysisIncludeFullReport. boolean. Необязательно. Используется при sqAnalysisEnabled = true. Значение по умолчанию: true.

Этот параметр отложит сборку до тех пор, пока анализ SonarQube не будет завершен.

sonarQubeFailWhenQualityGateFails - Неудачная сборка из-за отказа ворот качества (SQ 5.3+)
Псевдоним ввода: sqAnalysisBreakBuildIfQualityGateFailed. boolean. Необязательно. Используется при sqAnalysisEnabled = true.

Эта опция доступна только при использовании сервера SonarQube 5.3 или выше. Приводит к задержкам, так как сборка должна ожидать завершения анализа в SonarQube. Больше информации о воротах качества SonarQube.

checkStyleRunAnalysis - запуск checkstyle
Псевдоним ввода: checkstyleAnalysisEnabled. boolean. Значение по умолчанию: false.

Запускает средство Checkstyle с проверкой по умолчанию Sun. Результаты передаются как артефакты сборки.

pmdRunAnalysis - запуск PMD
Псевдоним ввода: pmdAnalysisEnabled. boolean. Значение по умолчанию: false.

Использует средство статического анализа PMD для поиска ошибок в коде. Результаты передаются как артефакты сборки.

findBugsRunAnalysis - запуск FindBugs
Псевдоним ввода: findbugsAnalysisEnabled. boolean. Значение по умолчанию: false.

Использует средство статического анализа FindBugs для поиска ошибок в коде. Результаты передаются как артефакты сборки.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Локальные агенты должны иметь возможности, соответствующие следующим требованиям , для выполнения заданий, использующих эту задачу: maven
Возможности	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.89.0 или более поздней версии
Категория задач	Строить

Поделиться через

Maven@1 - Задача Maven v1

Синтаксис

Входные данные

Параметры управления задачами

Выходные переменные

Требования

См. также

Обратная связь

Дополнительные ресурсы