配置 VCS 设置
版本控制系统(VCS)是用于跟踪项目源文件修订的系统。 它也被称为 SCM (源代码管理)或者修订版本控制系统。 TeamCity 支持以下版本控制系统(VCS): Git、 Subversion、 Mercurial、 Perforce、 Azure DevOps、 CVS、 StarTeam。
连接到版本控制系统由 TeamCity VCS root 定义。 在 TeamCity 中,一个 项目 或者一个 构建配置 可以附带一个或多个 VCS 根;构建配置还可以通过其他签出选项,如 签出规则 来定义构建的工作区。
TeamCity始终从服务器端监控存储库以检测更改,并在UI中显示它们。 根据指定的 VCS Checkout Mode ,实际的代码库检出也可能在代理端进行。
TeamCity 对每个 VCS 根进行 VCS 相关操作,因此建议重复使用具有相同设置的 VCS 根。
当 参数引用在 VCS 根中使用时,TeamCity 会针对每个"VCS 根实例"执行与 VCS 相关的操作,其中"实例"是引用解析后 VCS 根参数的唯一集合。 将参数添加到 VCS 根并不会减少执行的 VCS 操作数量,它只是允许更有效地共享设置。
附加 VCS 根目录
附加或创建 VCS 根
前往 Administration 并点击您想要配置的项目。
从项目的 常规设置页面,点击相关的构建,位于 构建配置 下面
从侧边栏中选择 Version Control Settings。
点击 附加 VCS 根。
如果至少有一个现有的 VCS 根可用,TeamCity 提供了以下操作的选择:
关联现有的 VCS 根目录 — 选择要关联的 VCS 根目录,然后完成 更新检出规则表单。
创建新的 VCS 根 — 遵循 配置 VCS 根 中的指南,配置新的 VCS 根。
配置签出规则
当附加了几个 VCS 根或您只需要检出存储库的一部分时,指定 VCS 根的 检出规则 ,以提供更高级的源代码检出控制可能性。 根据这些规则,您可以在检出期间将路径排除和/或映射到构建代理上的不同位置。
配置构建配置的签出选项
签出设置
设置 | 描述 |
|---|---|
VCS 检出模式 | 要定义项目源代码如何达到代理,使用 VCS Checkout Mode 选项。 |
检出目录 | Build Checkout Directory 是 TeamCity 代理 机器上的一个目录,所有构建的所有源代码都会检出到这个目录中。 |
清理构建 | 定义您是否希望在构建前删除检出目录中的所有文件。 请查看 Clean Checkout 以获取详细信息。 |
更改计算设置
设置 | 描述 |
|---|---|
显示来自快照依赖的更改 | 配置 TeamCity 是否将 显示快照依赖项的更改。 这也影响了对计划触发器中待处理更改的处理。 |
将默认分支的更改从其他分支中排除 | 默认情况下,当在功能分支中显示待处理变更或在分支上构建的变更时,TeamCity 会包含 默认分支 中的变动(直到默认分支中的构建)也一起显示。 这允许跟踪这样的情况:在默认分支中修复了破坏构建的 commit,但在功能分支中并未修复。 然而,对于大型项目而言,多个团队会同时在许多不同的分支上工作,这意味着所有项目的提交者(无论他们提交的分支是哪个)都将在例如默认分支的一次提交破坏了构建,或者执行了强制推送时得到通知。 如果您只想查看功能分支中的更改,勾选框以排除在其他分支中显示默认分支的更改。 |
分支过滤器
您可以使用 branch filter来限制用于构建配置的分支集合。 默认情况下,不会应用任何限制。