TeamCity On-Premises 2024.03 Help

将 TeamCity 与 Bugzilla 集成

您可以将 TeamCity 与 Bugzilla(3.0 或更高版本)整合,以从 TeamCity 用户界面提供到 Bugzilla 问题的链接。

在 TeamCity 用户界面中显示 Bugzilla 问题的链接

当启用与 Bugzilla 的集成时,TeamCity 会自动检测在 VCS 提交的评论中提到的问题 ID。 它将这些 ID 转换为链接到 Bugzilla 中的相应问题,并在 UI 中向 TeamCity 用户显示:

  • 要查看TeamCity UI中的问题的基本详情,请打开相关构建结果的 Changes 标签,并将鼠标悬停在问题ID旁边的图标上。

  • 在构建结果的 Issues 标签页中可以查看已修复的问题。

  • 要查看与整个构建配置(不仅仅是单个构建)相关的问题,请使用 构建配置主页问题日志 标签。 您可以过滤列表,只显示某一范围的构建,和 / 或启用 只显示已解决的问题 选项,以便只显示在构建中修复的问题。

遵循以下建议,以最大限度地从 Bugzilla 集成中受益:

  • 当将更改提交到您的版本控制时,始终在提交的注释中提及与修复相关的问题 ID。

  • 马克在 Bugzilla 中将问题标记为“已解决”Resolved,以便与 TeamCity 日志中的“已修复”Fixed状态一起显示(解决的时间实际上并不重要)。

配置连接至 Bugzilla

要启用集成,您需要在 Project Settings | Issue Trackers 页面上创建到 Bugzilla 的连接,并指定以下设置:

设置

描述

连接类型

从列表中选择 Bugzilla

显示名称

指定连接名称以便将其与其他连接区分开。

服务器 URL

输入您的 Bugzilla 实例的 URL。

用户名

输入您的 Bugzilla 用户帐户的用户名。

密码

为您的 Bugzilla 用户帐户输入密码。

问题 ID 模式

在注释文本中识别问题ID,请指定一个 Java Regular Expression 模式。 匹配的文本(如果定义了组,则使用第一组)被用作问题编号。 最常见的情况是 #(\d+)—— 此将从文本 修复 #1234 中提取 1234 作为问题 ID。

请注意,用户在与 Bugzilla 的连接中指定的用户应具备足够的权限来查看 Bugzilla 问题。 这将允许 TeamCity 获取有关问题的信息,并在 UI 中显示。

已知问题

在 Bugzilla 中,关于问题生成的 XML 存在几个已知问题,这使得与之通信变得困难。 然而,通常可以通过调整 Bugzilla 配置来解决这个问题。

  • 如果您看到 path/to/bugzilla.dtd not found 错误,这意味着问题 XML 包含到 bugzilla.dtd 文件的相对路径,而不是 URL。 为了解决这个问题,您需要在 Bugzilla 中设置服务器 URL 。

  • 有时您可能会看到一个 SAXParseException ,表示 期望元素类型标志与属性 type_id 关联的开头引号。 这是因为生成的 XML 与捆绑的 bugzilla.dtd 不相符。 要解决这个问题,将 type_id 属性在 bugzilla.dtd 文件中设为 #IMPLIED (可选)。

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