TeamCity On-Premises 2024.03 Help

配置 VCS 设置

版本控制系统(VCS)是用于跟踪项目源文件修订的系统。 它也被称为 SCM (源代码管理)或者修订版本控制系统。 TeamCity 支持以下版本控制系统(VCS):GitSubversionMercurialPerforceAzure DevOpsCVSStarTeam

连接到版本控制系统由 TeamCity VCS root 定义。 在 TeamCity 中,一个 项目 或者一个 构建配置 可以附带一个或多个 VCS 根;构建配置还可以通过其他签出选项,如 签出规则 来定义构建的工作区。

TeamCity始终从服务器端监控存储库以检测更改,并在UI中显示它们。 根据指定的 VCS Checkout Mode,实际的代码库检出也可能在代理端进行。

TeamCity 对每个 VCS 根进行 VCS 相关操作,因此建议重复使用具有相同设置的 VCS 根。

当在 VCS 根中使用 参数引用时,TeamCity 对每一个 "VCS 根实例" 执行与 VCS 相关的操作,其中 "实例" 是引用解析后 VCS 根参数的唯一集合。 将参数添加到 VCS 根并不会减少执行的 VCS 操作数量,它只是允许更有效地共享设置。

附加 VCS 根目录

附加或创建 VCS 根

  1. 前往 Administration 并点击您想要配置的项目。

  2. 从项目的 常规设置页面,点击相关的构建,位于 构建配置 下面

  3. 从侧边栏中选择 Version Control Settings

  4. 点击 附加 VCS 根

  5. 如果至少有一个现有的 VCS 根可用,TeamCity 提供了以下操作的选择:

    • 关联现有的 VCS 根目录 — 选择要关联的 VCS 根目录,然后完成更新检出规则表单。

    • 创建新的 VCS 根 — 遵循 配置 VCS 根 中的指南,配置新的 VCS 根。

配置签出规则

当附加了几个 VCS 根或您只需要检出存储库的一部分时,指定 VCS 根的 检出规则,以提供更高级的源代码检出控制可能性。 根据这些规则,您可以在检出期间将路径排除和/或映射到构建代理上的不同位置。

配置构建配置的签出选项

签出设置

设置

描述

VCS 检出模式

要定义项目源代码如何达到代理,使用 VCS Checkout Mode 选项。

检出目录

Build Checkout Directory 是 TeamCity 代理 机器上的一个目录,所有构建的所有源代码都会检出到这个目录中。

清理构建

定义您是否希望在构建之前清理 checkout 目录中的所有文件。 请查看 Clean Checkout 以获取详细信息。

更改计算设置

设置

描述

显示来自快照依赖的更改

配置 TeamCity 是否会显示来自快照依赖项的更改。 这也影响了对计划触发器中待处理更改的处理。

将默认分支的更改从其他分支中排除

默认情况下,当在功能分支中显示待处理变更或在分支上构建的变更时,TeamCity 会包含 默认分支 中的变动(直到默认分支中的构建)也一起显示。 这允许跟踪这样的情况:在默认分支中修复了破坏构建的 commit,但在功能分支中并未修复。

然而,对于大型项目而言,多个团队会同时在许多不同的分支上工作,这意味着所有项目的提交者(无论他们提交的分支是哪个)都将在例如默认分支的一次提交破坏了构建,或者执行了强制推送时得到通知。

如果您只想查看功能分支中的更改,勾选框以排除在其他分支中显示默认分支的更改。

分支过滤器

您可以使用branch filter来限制用于构建配置的分支集合。 默认情况下,不会应用任何限制。

其他 VCS 相关设置

  • 如果您希望在检测到新的更改时启动构建,请配置一个 VCS 触发器

  • 另外,您可以通过 VCS 标签 构建功能,为用于特定构建的源代码在版本控制系统中添加标签。

最后修改日期: 16日 7月 2024年