TeamCity On-Premises 2024.03 Help

StarTeam

这篇文章介绍了使用 StarTeam 设置 VCS 根时可用的字段和选项。

常见的 VCS 根属性在 此处描述。

StarTeam 连接设置

选项

描述

URL

指定指向所需源的 StarTeam URL

用户名

输入 StarTeam 服务器的登录信息

密码

在上面的字段中为指定的用户输入相应的密码

结束符转换

为文本文件定义 EOL (行结束)符号的转换规则。 请选择以下选项之一:

  • 存储在存储库中 — 就像存储在存储库中一样,EOL 符号得以保留。 不进行转换。

  • 代理的平台默认—— 无论存储库中的特定文件使用了何种 EOL 符号,建设代理传递时,都会转换为特定于平台的行分隔符。 结果的 EOL 符号完全依赖于代理的平台。

目录命名

定义本地目录命名模式。 请选择以下选项之一:

  • 使用工作文件夹 — StarTeam 文件夹具有“工作文件夹”属性。 它定义了哪个本地路径对应于 StarTeam 文件夹(默认情况下,工作文件夹等于文件夹的名称)。 在此模式下,TeamCity 会根据 "工作文件夹" 属性中存储的名称给本地目录命名。 请注意,尽管 StarTeam 允许使用绝对路径作为工作文件夹,但 TeamCity 仅支持相对路径,而且无法检测到绝对路径的存在。

  • 使用 StarTeam 文件夹名称 — 在此模式下,本地目录将以对应的 StarTeam 文件夹的名称命名。 这种模式适合保持工作目录结构与存储库中的项目结构相同且不想依赖“工作文件夹”属性的用户,因为这些属性可能会遭到无法控制的修改。

签出模式

文件可以通过其当前(尖端)版本、标签或推广状态来检索。 请注意,如果您选择按标签或促销状态进行检出,那么对于这个 VCS 根,将无法进行更改检测。 因此,如果标签被移动或促销状态切换到另一个标签,您的构建将无法触发。 保持构建更新的唯一方法是使用基于计划的触发。 为了实现这一点,当您选择通过标签或促销状态选项进行检出时,总是会执行全面检出。

关于目录命名规则的说明

在检查源代码时,TeamCity(就像StarTeam本地客户端一样)使用 工作文件夹 名称而不仅仅是文件夹名称来形成本地目录结构。 默认情况下,特定 StarTeam 文件夹的工作文件夹名称等于文件夹的名称。 例如,您的项目中有一个名为“A”的文件夹,其中包含一个名为“B”的子文件夹。 默认情况下,他们的工作文件夹分别是 "A" 和 "B" ,本地目录结构将看起来像 <checkout dir>/A/B。 但是,如果将文件夹“A” 的工作文件夹设置为不同的内容(例如, Foo ),那么目录结构也将会不同: <checkout dir>/Foo/B

StarTeam 允许指定绝对路径作为工作文件夹。 然而,TeamCity 仅支持相对工作文件夹。 这是按设计完成的;所有从源代码控制检索的文件必须位于检出目录下。 如果 TeamCity 检测到绝对工作文件夹的存在,构建将会失败。

您需要确保 VCS 根目录下的所有文件夹都有相对的工作文件夹名称。

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