将 TeamCity 与 Bugzilla 集成

最后修改日期： 2025年 3月 21日

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

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

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

要在 TeamCity UI 中查看问题的基本详情，请打开相关构建结果的更改选项卡，并将鼠标悬停在问题 ID 旁边的图标上。
可以在构建结果的问题选项卡中查看构建中修复的问题。
要查看与整个构建配置（而不仅仅是单个构建）相关的问题，请使用问题日志选项卡，位于构建配置主页页面中。您可以过滤列表，只显示某一范围的构建，和 / 或启用只显示已解决的问题选项，以便只显示在构建中修复的问题。

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

在将更改提交到版本控制时，始终提及问题 ID 与提交注释中的修复相关。
马克在 Bugzilla 中将问题标记为“已解决” Resolved ，以便与 TeamCity 日志中的“已修复” Fixed状态一起显示（解决的时间实际上并不重要）。

tip
启用 TeamCity 与 Bugzilla 的集成需要项目管理员权限，因为它是在项目级别配置的。请注意，为一个项目启用集成会同时为其所有子项目启用。如果子项目中的设置与父项目的设置不同，那么子项目的设置将优先于父项目的设置。

要启用集成，请在项目设置 | 问题跟踪器页面上创建与 Bugzilla 的连接，并指定以下设置：

设置	描述
连接类型	从列表中选择 Bugzilla。
显示名称	指定连接名称以便将其与其他连接区分开。
服务器 URL	输入您的 Bugzilla 实例的 URL。
用户名	输入您的 Bugzilla 用户帐户的用户名。
密码	为您的 Bugzilla 用户帐户输入密码。
问题 ID 模式	在注释文本中识别问题ID，请指定一个 Java Regular Expression 模式。匹配的文本（如果定义了组，则使用第一组）被用作问题编号。最常见的情况是 `#(\d+)`—— 此将从文本 `修复 #1234` 中提取 `1234` 作为问题 ID。

note
如果用户名和密码被指定，您需要开启 Bugzilla XML-RPC 接口。如果您使用匿名访问 Bugzilla ，而不使用用户名和密码，那么这不是必须的。

请注意，用户在与 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 （可选）。