TeamCity On-Premises 2024.07 Help

构建结果页面

在 TeamCity 中,所有关于构建的信息,无论是排队,正在运行还是已完成,都会在其 构建结果 页面上累积。 这个页面可以从 构建配置首页 访问,也可以从在以 主页 模式浏览时,TeamCity UI 的各处通过构建编号或构建状态的链接访问。 一些数据只有在构建完成后才可以访问,像变更、参数和依赖这样的一些细节也适用于正在队列中等待的构建。

这篇文章概述了新版 TeamCity UI 中的 Build Results 页面。 大部分功能在经典 UI 模式中也可使用。

内部构建ID

在使用 REST API下载构建构件时,可能需要知道构建ID。 您可以从 URL 或 参数 标签的 构建结果 页面中获取此 ID。

构建结果 页面的网址通常如下所示:

  • 在樱花 UI: <SERVER_URL>/buildConfiguration/<CONFIGURATION_ID>/<BUILD_ID>?...

  • 在 Classic UI 中: <SERVER_URL>/viewLog.html?buildId=<BUILD_ID>&buildTypeId=<CONFIGURATION_ID>&...

<BUILD_ID> 部分是 TeamCity 中唯一标识此构建的内部数字构建 ID。

您也可以在 TeamCity 界面中构建的 参数选项卡下找到相同的值,存储在 teamcity.build.id 参数中。

构建结果标题面板

Build Results 页面包含几个选项卡,其集合取决于当前构建的特性,以及一些常见元素:

  • 分支选择器,用于显示当前构建的分支。 当在 构建配置首页上,此选择器实际上允许按照特定的分支筛选显示的构建列表。

  • 操作菜单(描述在 这里)。

  • 当展开 Details模块时,会显示当前模块的主要信息。

  • Investigation 小部件让您能够迅速分配这个构建的 investigation,或者查看开放调查的详细情况。

  • Trends 小部件显示所有以前的构建及其详细信息。 将鼠标悬停在构建上查看其详细信息。

概览标签页

概览选项卡显示有关构建的一般信息,例如构建持续时间、所用的代理、触发器和依赖项。 标签页的集合取决于当前构建的步骤和特性。 如果构建排队中,选项卡会显示构建在队列中的位置,构建预计启动的时间等。

Sakura 构建结果页面

它还显示与当前构建状态相关的诊断消息。

更改"选项卡

Changes 标签页显示了有关构建中更改的信息,并为更改列表提供了高级过滤功能。 您可以按照作者、注释、路径和修订版本来过滤更改。

要查看来自依赖项的更改,请勾选相应的框。

您可以通过勾选 显示文件 框来查看已修改的文件。 点击文件名将打开差异查看器。

启用 Show graph 将会以图表的形式显示出与此构建相关的 VCS 根的提交更改。 图形显示在列表的左侧,并以可变的详细程度展示变化,允许您:

  • 导航至图形节点以显示 VCS 根修订号。

  • 查看在此构建中更改的 VCS 根:将鼠标悬停在更改列表左侧的区域上,每个根都会以条形突出显示。

  • 点击一个条形来选择一个单一的 VCS 根。 只有与此根相关的更改是可见的,其他的则显示为灰色。

  • 如果仓库的分支之间有合并,图表会显示它们。

  • 如果您的 VCS 根目录有子仓库(在变更列表中标记为 S),请导航至父节点,查看父节点中哪些修订引用了子仓库的提交。

Changes 标签页,您可以:

  • 审查版本控制中包含在构建中的所有更改以及它们对应的 修订版本

    • 审查当前构建所依赖的构建中包含的更改:如果当前的构建配置有一个构件依赖项,且当前构建中下载的构件与当前配置的上一次构建中下载的构件相比发生了更改,那么 构件依赖项更改 节点将会出现,显示用于下载构件依赖项的构建,以及该构建中包含的更改。

  • 为构建源标签

  • 配置构建配置的 VCS 设置(如果您有足够的权限)。

对于此页面上的每一项更改,您可以:

  • 探索详细的变化。

  • 查看更改来自哪个依赖构建,或者启用了 "Show changes from snapshot dependencies"(显示快照依赖性的更改)选项的构建具有快照依赖性。

  • 点击已更改的文件链接,导航至 更改细节

  • 触发自定义构建,以实施此项更改。

  • 下载补丁。

  • 将补丁下载到您的 IDE。

  • 如果管理员已配置,则在 外部更改查看器 中审查更改。

构建日志标签页

图形化构建日志时间线反映了每个构建阶段的持续时间,并指示构建问题:

构建时间线

点击任何阶段以打开构建日志的相应行。

有关 TeamCity 中构建日志的更多信息,可在 此处 查看。

制品标签页

如果构建产生了 artifacts,它们都会在专用的 Artifacts 标签页中显示。

参数选项卡

Parameters标签页会显示所有实际的(在这次构建时) build parameters的值。

构建参数报告

这个页面有两个标签页:

  • 参数 — 列出所有配置参数、系统属性和环境变量的值。 您可以勾选相关的复选框,只查看在此次构建过程中改变了数值的参数。

  • 统计值 — 列出所有构建报告的 统计值(例如,构建成功率或检出远程仓库所需的时间)。 点击 查看图表 按钮(查看图表 )可以让您检查这些值在构建运行过程中的趋势。

依赖项标签页

如果已完成的构建具有工件和 / 或快照依赖项,那么 依赖项 标签会在 构建结果 页面上显示。 在这里,您可以查看用于创建此构建(已下载的工件)的构建及其工件和/或源代码,以及利用当前构建的工件和/或源代码(已交付的工件)的构建。 另外,您可以查看构建的间接依赖项。 也就是说,例如,如果构建 A 依赖于构建 B,而构建 B 又依赖于构建 C 和构建 D,那么构建 C 和构建 D 就是构建 A 的间接依赖项。

Dependencies选项卡提供了三种显示构建依赖关系的模式:视觉时间线,结构化列表,和构建链。 选择最适合您当前任务的模式。

构建结果的依赖项标签页

时间线"和"列表"查看模式允许您通过构建名称搜索特定构建。

在依赖中查找面板

问题标签页

如果您已配置了 问题跟踪器的集成,并且在包含的更改的注释中或在构建本身的注释中至少提到了一个问题,您将在 问题 标签中看到与当前构建相关的问题列表。

代码覆盖率选项卡

如果您在构建运行程序中配置了代码覆盖率,那么带有完整 HTML 代码覆盖率报告的 代码覆盖率 标签页将会出现。

点击 覆盖率分解 部分中的链接,您可以深入查看不同范围的统计数据:例如,命名空间、程序集、方法和源代码。

代码检查选项卡

如果已配置, Code Inspection 构建步骤的结果将在 Code Inspection 标签页中展示。 使用左侧面板浏览检查结果;过滤后的检查结果将显示在右侧面板中。

  • 如果您对警告不感兴趣,那么请从 Total 切换到 Errors 选项。

  • 使用范围过滤器将视图限制到特定的目录。 这使得开发人员更容易管理特定的感兴趣的代码。

  • 在范围过滤器下使用巡检树视图来按特定的巡检显示结果。

  • 请注意,TeamCity 会显示包含问题的源代码行号。 点击它以跳至您的 IDE 中的代码。

重复项

如果您的构建配置中包含 Duplicates 构建运行程序作为构建步骤之一,您将在 构建结果 中看到 重复项 标签。

该标签页包含:

  • 找到的重复项列表。 new only 选项让您只能查看在最新构建中出现的重复项。

  • 包含这些重复项的文件列表。 使用左右箭头按钮在选项卡下部的相应窗格中显示选定的重复项。

  • 两个面板显示包含重复项的文件片段的源代码。

  • 位于左上角的范围过滤器列出了包含重复项的特定目录。 这种过滤使得开发者更易于管理感兴趣的代码。

测试"标签页

Tests 标签页允许您在失败的、被忽略的和成功的测试之间切换,并使用各种过滤器。

对于每一个失败的测试,您可以查看它的堆栈跟踪,预期和实际值之间的差异,跳转到测试历史, 指派一个团队成员来调查它的失败原因在您的IDE中打开测试,并 / 或立即开始修复它。

要查看详细的测试或调查历史,点击其上下文菜单中的 显示测试历史显示调查历史

点击 显示测试历史 链接将打开 测试详情 页面,您可以在那里找到以下信息:

  • 测试详情,包括测试成功率和测试运行持续时间的数据和图表。

  • 一个完整的测试历史表,包含有关测试状态、其持续时间,以及此测试在其中运行的构建的信息。

测试时长图表

测试持续时间图表对于比较单个测试在此构建配置的构建中运行所需的时间非常有用。

测试持续时间结果只适用于当前在构建历史中的构建。 一旦构建已经被 清理,这些数据将不再可用。

您可以在 Test Duration Graph 上执行以下操作:

  • 通过清除 显示失败 选项,过滤掉未通过测试的构建。

  • 通过选择 Average 选项来计算每日平均值。

  • 点击图表上的一个点,即可跳转到对应构建结果的页面。

  • 在图表上的点的工具提示中查看构建摘要,并导航到相应的 Build Results 页面。

  • 通过选择或清除特定代理,或者点击 全部 链接来选择或清除所有代理,以过滤信息。

Maven 构建信息标签页

对于每次 Maven 构建,构建代理会收集 Maven 特定的构建详细信息,在构建完成后显示在 Maven 构建信息 标签页上。 此选项卡在调整构建配置时,可能对构建工程师有用。

经典 UI 标签页

其他的经典 UI 标签页,尚未在新的 UI 中复制,也是可以用的:点击 More,然后在列表中选择您需要的标签页。 要查看下面描述的各个部分,您也可以通过右上角的相应切换暂时切换到经典的 UI 界面。

在经典 UI 中构建历史记录

构建历史记录是 TeamCity 产出过去构建的纪录。 它在新的用户界面中显示为 Trends 小工具,以及在经典用户界面中作为带有链接的菜单显示,具体描述如下。

要查看当前配置中的构建历史,请点击位于 Build Results 右上角的 previousnext 链接。 点击 所有历史记录 链接以打开 历史记录 标签页。

导航菜单:

浏览历史记录

History 选项卡:

Build history(构建历史记录)

经典 UI 中的测试历史

经典 UI 的 Tests 标签页与新版本不同,并包含一些独特的功能,比如下载所有测试的 CSV 格式和弹出持续时间图表图片的能力。 当您需要其功能时,您可以临时切换到它。

最后修改日期: 2025年 3月 28日