TeamCity On-Premises 2024.03 Help

teamcity-info.xml

作为一种过时的构建脚本收集信息的方法,您可以在根构建目录中生成一个名为 teamcity-info.xml 的 XML 文件。 当构建完成时,这个文件将自动被上传为构建工件并由 TeamCity 服务器处理。

请注意,这种方法在未来的 TeamCity 版本中可能会被停用,因此,我们建议使用 服务消息 方法。 如果服务消息对您不起作用,请告知我们具体情况,并通过 电子邮件 详细描述问题。

修改构建状态

TeamCity 有能力直接从构建脚本更改构建状态。 您可以设置状态(构建失败或成功)并更改构建状态的文本(例如,如果测试框架不受 TeamCity 支持,记下失败的测试数量)。

teamcity-info.xml 的 XML schema

可以为构建设置以下信息:

  • Build number — 设定已完成构建的新编号。 您可以使用 {build.number} 引用 TeamCity 提供的构建号。

  • 构建状态 — 更改构建状态。 支持的值包括 失败成功

  • 状态文本 — 修改构建状态的文本。 您可以替换 TeamCity 提供的状态文本,或在标准文本前后添加自定义部分。 支持的 操作 值包括 "append" 、 "prepend" 和 "replace"。

teamcity-info.xml 文件的示例:

<build number="1.0.{build.number}"> <statusInfo status="FAILURE"> <!-- or SUCCESS --> <text action="append"> fitnesse: 45</text> <text action="append"> coverage: 54%</text> </statusInfo> </build>

报告自定义统计数据

在 TeamCity 中,可以提供 custom charts。 您的构建可以使用 teamcity-info.xml 文件为此类图表提供数据。

在 teamcity-info.xml 中存储数据

此文件应由构建在构建的根目录中创建。 您可以发布多个统计数据(请参阅下方的数据格式详细信息)并为每组值创建单独的图表。

teamcity-info.xml 文件应包含以下格式的代码(您可以在 teamcity-info.xml 文件中组合各种数据):

<build> <statisticValue key="chart1Key" value="342"/> <statisticValue key="chart2Key" value="53"/> </build>

密钥 不能等于任何一个 预定义键 必须是一个最多13位的正整数/负整数。 支持最多6位小数的浮点数值。

这里的关键在于描述图表时使用的 valueType 标签的关键。

描述自定义图表

请参见 定制统计图表 页面以获取详细描述。

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