Maven

请选择您想要使用的 Maven 版本。 您也可以 管理已安装的版本。

在此指定要使用哪种用户设置。 这等同于Maven命令行选项 -s 或 --设置。 可用选项如下：

请选择以下选项之一：

选择 仅构建受更改影响的模块复选框以启用 Maven 模块的增量构建。
增量构建的一般概念是只处理更改过的模块，而不花时间重新处理其所关联的未更改模块。 TeamCity 使用此方法仅针对已更改的 Maven 模块运行测试，从而在重新运行构建或构建链时节省时间。

由于 Maven 本身对增量构建的支持非常有限，TeamCity 使用自己的变更影响分析算法来确定受影响模块的集合，并使用一个特殊的预备阶段来制定受影响模块的依赖关系。

首先，TeamCity 执行自身的变更影响分析，考虑到父子关系和不同的依赖范围，并确定受影响的模块。 然后，构建被分为两个顺序的 Maven 执行。

第一个叫做准备阶段的 Maven 执行旨在构建受影响模块的依赖项。 准备阶段的目的是确保在第二次执行过程中，由于依赖类的缺失或不一致，不会出现编译器或其他错误。

第二次 Maven 执行称为主阶段，执行主要目标（例如， test ），因此只执行受更改影响的那些测试。

另外，查看有关此主题的相关 博客文章。

在这个部分，您可以指定一个将被 用于运行构建步骤 的 Docker 镜像。

Maven 构建运行程序支持基于 IDEA 覆盖引擎的代码覆盖率。 要了解如何配置代码覆盖率选项，请参阅 配置 Java 代码覆盖率 页面。

note

仅支持 Surefire 版本 2.4 或更新的版本。

如果您在同一台机器上安装了多个构建代理，默认情况下它们使用相同的本地仓库。 然而，有两种方法可以为每个构建代理分配自定义本地存储库：

• 在 teamcity-agent/conf/buildAgent.properties 中指定以下属性：

  system.maven.repo.local=%\system.agent.work.dir%/<subdirectory_name>

  例如， %system.agent.work.dir%/m2-repository。

• 在不同的用户帐户下运行每一个构建代理。

Maven Release 插件需要一个 ticket 才能在 Perforce 中进行身份验证。

在您的 TeamCity 构建配置中的 Perforce VCS root 设置中：

1. 启用 checkout on agent。

2. 在 Perforce VCS 根设置中启用 使用基于票证的身份验证。

3. 确保您的构建代理环境中没有任何偶尔出现的 P4 变量，这可能会干扰 Maven Release Plugin 的执行。

4. 在 Maven 构建步骤的 Goals 字段中指定 release:prepare ，然后运行构建。

要在 Git 中使用此插件，需要在您的 pom.xml 中将 Git SSH URL 设置为 SCM URL。

在 TeamCity 代理上：

1. 确保代理已安装 Git 并已将其添加到 Unix-like OS 的代理的 $PATH ，以及 Windows 的 % \PATH% 环境变量中。

2. 在代理上，通过执行设置您的帐户的身份

   git config --system user.email "buildserver@example.com"
   git config --system user.name "TeamCity Server"

3. 确保您的 Git VCS 已添加到代理的已知主机数据库中。

在 TeamCity 服务器上：

1. 将 Git SSH key 上传到您的 TeamCity 服务器。

2. 打开 配置设置 ，并导航到 版本控制设置设置选项卡。

3. 启用代理上的检出。

4. 在您的 Git VCS 根目录中，启用 Private Key 认证。

5. 将 SSH Agent 构建功能添加到您的配置中。

6. 在 Maven 构建步骤的 目标 字段中指定 release:prepare 并运行构建。