将 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 是 您也可以自动加载所有项目 ID :启用 自动使用所有 YouTrack ID,并测试与您的 YouTrack 服务器的连接。 如果连接成功,Project IDs 字段将会自动填充。 TeamCity 将检测在 YouTrack 中新创建的项目,并自动同步项目 ID 的列表。 |
请注意,连接到 YouTrack 的用户应具有查看 YouTrack 问题的足够权限。 这将允许 TeamCity 获取有关问题的信息,并在 UI 中显示。
增强与 YouTrack 的集成
YouTrack 提供了与 TeamCity 的原生集成,这增强了可用功能的集合。 例如:
YouTrack 能够用特定的构建编号填充“Fixed in build”字段。
YouTrack 允许您通过在 VCS 变更提交的评论中指定命令来应用于问题。
要使用这些功能,配置 YouTrack。