TeamCity On-Premises 2024.03 Help

配置 VCS 根目录

在 TeamCity 中,VCS root 定义了一个到版本控制系统的连接。 它代表一组参数(源路径、用户名、密码和其他设置),这些参数决定了 TeamCity 如何与 VCS 进行通信,以监视更改并获取构建的源代码。

VCS 根在项目中创建,并可供该项目或其 子项目 中定义的所有构建配置使用。 一个或多个 VCS 根可以被附加到构建配置或模板上。 您可以通过 VCS签出规则 指定要检出的仓库部分和目标路径。

要查看和管理项目中配置的所有 VCS 根,请转到 Project Settings | VCS Roots

在这里,您可以按名称筛选项目的根目录,并修改其他筛选选项。

如果有人试图修改在多个项目或构建配置中使用的 VCS 根,TeamCity 将发出警告,指出对 VCS 根的更改可能会影响其他项目或构建配置。 系统将提示用户选择是保存更改并将它们应用于所有受影响的项目和构建配置,还是复制 VCS 根来由特定的构建配置或项目使用。

在尝试创建新的 VCS 根时,TeamCity 会检查在此项目中是否有其他具有相似设置的可访问的 VCS 根。 如果存在此类 VCS 根,TeamCity 建议使用它们。

一旦配置了 VCS 根,TeamCity 将定期查询版本控制系统以获取新更改,并在已附加该根的 构建配置 中显示这些更改。 您可以设置您的构建配置,每当 TeamCity 检测到任何构建配置的 VCS 根目录发生变化时,都会触发新的构建,这在大多数情况下是适用的。 当构建开始时,TeamCity 从版本控制中获取已更改的文件,并将更改应用于 Build Checkout Directory

常见 VCS 根属性

属性

描述

VCS 类型

TeamCity支持的版本控制系统类型:例如,Perforce或Subversion。

VCS 根名称

项目所有 VCS 根中的 VCS 根的唯一名称。

VCS 根 ID

在系统中所有 VCS 根中,VCS 根的独特 ID。 VCS 根 ID 可用于参数引用到 VCS 根参数和 REST API。 如果未指定,将会根据 VCS 根参数自动生成。

存储库 URL

VCS 存储库的 URL。 支持不同格式的URL,如: http(s)://svn://ssh://git@git:// 以及其他,同时也支持Maven格式的URL。

最小轮询间隔

指定 TeamCity 对 VCS 存储库进行 VCS 更改的轮询频率。 默认情况下,会使用全局预定义的服务器设置,这可以在 Administration | Global Settings 页面上进行修改。 在每个 VCS 根的基础上,间隔时间在上次轮询结束后立即开始。 在这里,您可以为当前的 VCS 根目录指定自定义间隔。

如果 TeamCity 检测到使用了一个 VCS commit hook 来触发检查更改,那么这个间隔会自动增加至预设的值(4 小时)。 如果定期检查发现了通过提交钩子未检测到的更改,轮询间隔将被重置为指定的最小值。

属于项目

每个 VCS 根都属于某个项目,而在这个部分中,会显示这个项目的名称。 VCS 根目录可以移动到当前使用根目录的所有子项目、构建配置和模板的公共父项目中。

参阅本节内的页面,获取 VCS 特定的配置详细信息。

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