TeamCity On-Premises 2024.03 Help

Mercurial

TeamCity 使用典型的 Mercurial 命令行客户端:hg 命令。 支持 Mercurial 1.5.2+。

请注意:

  • Remote Run 不支持从 IDE 进行。 请使用 Branch Remote Run Trigger 替代。

  • 除了 .=><target_dir> 规则外,代理端签出规则不受支持。
    有关常用 VCS Root 属性,请参阅 此部分。 以下部分包含了关于 Mercurial 特定字段和选项的描述。

TeamCity 默认支持 Mercurial 。

一般设置

选项

描述

从中拉取更改

您的托管服务的 URL。

默认分支

设置为默认分支,该分支在没有分支规范或分支规范中的分支无法找到时使用。 请注意,此处支持参数引用。

分支规范

在此区域列出您希望监控其更改的所有分支。 语法与检出规则相似: +|-:branch_name ,其中 branch_name 是特定于版本控制系统(有可选的 * 占位符)。 请注意,只允许有一个星号,并且每个规则必须从新行开始。 书签也可以在分支和分支规范字段中使用。 如果一个书签与普通分支有同样的名称,普通分支会优先。 更多相关内容,请参阅 TeamCity 博客文章

使用标签作为分支

允许您在分支规格中使用标签。 默认情况下,标签会被忽略。

检测子仓库的变更

默认情况下,子仓库不会被监控以查找更改。

标签/合并的用户名

用于标记的自定义用户名

使用未压缩的传输

对于局域网中的仓库,未压缩的传输更快。

HG 命令路径

到 hg 可执行文件的路径。 仅当被包含在白名单中时,才在 TeamCity 服务器上使用。 查看更多 下面

检测 hg 可执行文件的路径

当代理启动时,hg-plugin 会检测代理机器上已安装的 Mercurial。

该插件尝试使用 teamcity.hg.agent.path 参数指定的路径运行 hg version 命令。 您可以在 <Agent 安装目录>\conf\buildAgent.properties 中更改此参数。

如果此参数未设置,插件将使用 hg 作为命令的路径,假设它位于 $PATH 中的某个地方。 如果命令成功执行并且 mercurial 具有适当的版本(1.5.2+),那么 hg-plugin 将会在 teamcity.hg.agent.path 参数中报告 hg 的路径。

在构建过程中,插件会在 VCS 根设置的 HG 命令路径 字段中使用指定的 hg。 要使用检测到的 hg,将 %teamcity.hg.agent.path% 放入此字段。 只有在代理上报 hg 路径的情况下,此类设置的配置才会运行。

插件的服务器端检查 teamcity.hg.customServerHgPathWhitelist 内部属性 的值。 该属性包含服务器上允许使用的 hg 路径的 ; 分隔列表。 如果在 VCS 根中指定的路径在白名单中,那么它将在服务器上使用。 如果没有,将使用 teamcity.hg.server.path 中指定的 内部属性 的路径。 如果此属性未设置,TeamCity 服务器将使用 hg 来自 $PATH

代理设置

这些是代理侧检出(默认模式)所使用的设置,该模式要求所有代理都安装了 Mercurial。

选项

描述

Mercurial 配置

指定应用于代理端检出期间存储库的Mercurial配置选项,例如,输入以下内容以启用 largefiles 扩展:

[extensions] `largefiles =

配置格式的描述在 这里

清除设置

定义是否要清除文件和当前仓库中Mercurial未追踪的目录。 您可以选择只删除未知文件和空目录,或者同时删除被忽略的文件。 已添加的文件和(未修改或已修改的)跟踪文件将被保留。

使用镜像

启用后,TeamCity 首先在代理的 system/mercurial 目录下创建一个本地镜像,然后从这个本地镜像克隆到工作目录。 此选项可以加快清理checkout,因为只有构建工作目录被清理。 另外,如果在多个构建配置中使用了单一根目录,克隆将会更快。

内部属性

这个部分描述了与 hg 相关的 内部属性。 您可以根据需要修改默认设置以调整 Mercurial 设置。

服务器端内部属性:

属性

默认

描述

teamcity.hg.pull.timeout.seconds

3600

拉取操作运行的最大时间(以秒为单位)

teamcity.hg.server.path

hg

服务器上 hg 可执行文件的路径(见 hg 可执行文件检测路径 获取详细信息)。

teamcity.hg.customServerHgPathWhitelist

;-分隔的允许在 TeamCity 服务器机器上使用的 hg 执行文件路径列表

Agent 配置 适用于 Mercurial:

属性

默认

描述

teamcity.hg.pull.timeout.seconds

3600

拉取操作运行的最大时间(以秒为单位)

teamcity.hg.agent.path

hg

代理上 hg 可执行文件的路径(请参考 hg 可执行文件路径检测 了解详情)。

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