TeamCity On-Premises 2024.03 Help

将 TeamCity 与 YouTrack 集成

您可以将 TeamCity 与 JetBrains YouTrack Standalone 或 InCloud 集成,从而在 TeamCity UI 中提供指向 YouTrack 问题的链接。

请注意,TeamCity 不支持 过时的 YouTrack REST API 端点。 参见 此问题 以获取详细信息。

在 TeamCity 用户界面中显示指向 YouTrack 问题的链接

当启用了与 YouTrack 的集成后,TeamCity 会自动检测 VCS 提交评论中提到的 YouTrack 问题 ID。 它将这些 ID 转换为链接,链接至 YouTrack 中的相应问题,并在 TeamCity 的用户界面中进行显示。

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

问题跟踪器集成

在构建结果的 Issues 选项卡上可以查看构建中修复的问题:

问题"标签页

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

问题日志

当提交变更到您的版本控制时,始终在提交的评论中提到与修复相关的问题 ID,以从 YouTrack 集成中获得最大的好处。

配置与 YouTrack 的连接

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

设置

描述

连接类型

从列表中选择 YouTrack

显示名称

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

服务器 URL

请输入您的 YouTrack 实例的基础 URL。

身份验证

选择您想要用于设置集成的授权类型。 您可以使用用户名和密码登录,或者使用令牌。

用户名

输入您的 YouTrack 用户帐户的用户名。
验证 设置为 用户名 / 密码时,将显示此选项。

密码

为您的 YouTrack 用户帐户输入密码。
身份验证 设置为 用户名 / 密码 时,会显示此选项。

永久令牌

输入您的 永久令牌
认证 设置为 永久令牌 时,此选项将显示。

项目 ID

输入一个以空格分隔的 项目 ID 列表,以指定哪些字符串应被识别为 YouTrack 中的问题引用。 例如,如果一个项目 ID 是 TW ,在 VCS 评论中提到的问题 ID,如 TW-18802 ,将被转成对应问题的链接。

您也可以自动加载所有项目 ID :启用 自动使用所有 YouTrack ID,并测试与您的 YouTrack 服务器的连接。 如果连接成功,Project IDs 字段将会自动填充。 TeamCity 将检测在 YouTrack 中新创建的项目,并自动同步项目 ID 的列表。

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

增强与 YouTrack 的集成

YouTrack 提供了与 TeamCity 的原生集成,这增强了可用功能的集合。 例如:

  • YouTrack 能够用特定的构建编号填充“Fixed in build”字段。

  • YouTrack 允许您通过在 VCS 变更提交的评论中指定命令来应用于问题。

要使用这些功能,配置 YouTrack

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