Mercurial
TeamCity 使用典型的 Mercurial 命令行客户端:hg 命令。 支持 Mercurial 1.5.2+。
请注意:
Remote Run 不支持从 IDE 进行。 请使用 Branch Remote Run Trigger 替代。
除了
.=><target_dir>
规则外,代理端签出规则不受支持。
有关常用 VCS Root 属性,请参阅 此部分。 以下部分包含了关于 Mercurial 特定字段和选项的描述。
TeamCity 默认支持 Mercurial 。
一般设置
选项 | 描述 | |
---|---|---|
从中拉取更改 | 您的托管服务的 URL。 | |
默认分支 | 设置为默认分支,该分支在没有分支规范或分支规范中的分支无法找到时使用。 请注意,此处支持参数引用。 | |
分支规范 | 在此区域列出您希望监控其更改的所有分支。 语法与检出规则相似: | |
使用标签作为分支 | 允许您在分支规格中使用标签。 默认情况下,标签会被忽略。 | |
检测子仓库的变更 | 默认情况下,子仓库不会被监控以查找更改。 | |
标签/合并的用户名 | 用于标记的自定义用户名 | |
使用未压缩的传输 | 对于局域网中的仓库,未压缩的传输更快。 | |
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配置选项,例如,输入以下内容以启用 [extensions]
`largefiles =
配置格式的描述在 这里。 |
清除设置 | 定义是否要清除文件和当前仓库中Mercurial未追踪的目录。 您可以选择只删除未知文件和空目录,或者同时删除被忽略的文件。 已添加的文件和(未修改或已修改的)跟踪文件将被保留。 |
使用镜像 | 启用后,TeamCity 首先在代理的 |
内部属性
这个部分描述了与 hg 相关的 内部属性。 您可以根据需要修改默认设置以调整 Mercurial 设置。
服务器端内部属性:
属性 | 默认 | 描述 |
---|---|---|
| 3600 | 拉取操作运行的最大时间(以秒为单位) |
| hg | 服务器上 hg 可执行文件的路径(见 hg 可执行文件检测路径 获取详细信息)。 |
|
|
Agent 配置 适用于 Mercurial:
属性 | 默认 | 描述 | |
---|---|---|---|
| 3600 | 拉取操作运行的最大时间(以秒为单位) | |
| hg | 代理上 hg 可执行文件的路径(请参考 hg 可执行文件路径检测 了解详情)。 |