您可以使用 Jira 开发面板直接在 Jira 中查看 Jira 问题的 GitLab 活动。要设置 Jira 开发面板,请执行以下操作:
- 对于 Jira Cloud,使用由 GitLab 开发和维护的GitLab for Jira Cloud 应用程序。
- 对于 Jira Data Center 或 Jira Server,使用由 Atlassian 开发和维护的Jira DVCS 连接器。
有关概述,请参阅Jira 开发面板集成。
功能可用性
历史
下表显示了 Jira DVCS 连接器和 GitLab for Jira Cloud 应用程序可用的功能:
特征 | Jira DVCS 连接器 | GitLab for Jira Cloud 应用程序 |
---|---|---|
智能提交 | 是的 | 是的 |
同步合并请求 | 是的 | 是的 |
同步分支 | 是的 | 是的 |
同步提交 | 是的 | 是的 |
同步现有数据 | 是的 | 是(查看GitLab 数据同步到 Jira) |
同步构建 | 不 | 是的 |
同步部署 | 不 | 是的 |
同步功能标志 | 不 | 是的 |
同步间隔 | 最多 60 分钟 | 即时的 |
删除分支 | 不 | 是的 |
从分支创建合并请求 | 是的 | 是的 |
从 Jira 问题创建分支 | 不 | 是的 |
GitLab 中的关联项目
Jira 开发面板将 Jira 实例及其所有项目连接到以下内容:
- 对于GitLab for Jira Cloud 应用程序,链接的 GitLab 组或子组及其项目
- 对于Jira DVCS 连接器,链接的 GitLab 组、子组或个人命名空间及其项目
开发面板中显示的信息
您可以在 Jira 开发面板中通过引用 GitLab 中的Jira 问题 ID 查看 Jira 问题的 GitLab 活动 。开发面板中显示的信息取决于您在 GitLab 中提及 Jira 问题 ID 的位置。
对于GitLab for Jira Cloud 应用程序,将显示以下信息。
GitLab:您在此处提及 Jira 问题 ID | Jira 开发面板:显示哪些信息 |
---|---|
合并请求标题或描述 | 链接到合并请求 链接到部署 通过合并请求标题链接到流水线 通过合并请求描述链接到流水线(在 GitLab 15.10 中引入 )链接到分支(在 GitLab 15.11 中引入) 审阅者信息和批准状态(在 GitLab 16.5 中引入) |
支行名称 | 链接到分支 链接到部署 |
提交消息 | 链接到提交 链接到部署,自上次成功部署到环境后最多 5,000 个提交1 2 |
Jira 智能提交 | 自定义评论、记录时间或工作流程转换 |
脚注:
- 在 GitLab 16.2 中引入了一个名为 的标志
jira_deployment_issue_keys
。默认情况下启用。 - 通常在 GitLab 16.3 中可用。功能标志
jira_deployment_issue_keys
已删除。
Jira 智能提交
先决条件:
- 您必须拥有具有相同电子邮件地址或用户名的 GitLab 和 Jira 用户帐户。
- 命令必须位于提交消息的第一行。
- 提交信息不能超过一行。
Jira Smart Commits 是处理 Jira 问题的特殊命令。使用这些命令,您可以使用 GitLab 来执行以下操作:
- 向 Jira 问题添加自定义评论。
- 记录 Jira 问题的时间。
- 将 Jira 问题转换为项目工作流中定义的任何状态。
智能提交必须遵循以下语法:
复制到剪贴板
<ISSUE_KEY> <ignored text> #<command> <optional command parameters>
您可以在一次提交中执行一个或多个命令。
Smart Commit 语法
命令 | 句法 |
---|---|
添加评论 | KEY-123 #comment Bug is fixed |
记录时间 | KEY-123 #time 2w 4d 10h 52m Tracking work time |
关闭问题 | KEY-123 #close Closing issue |
记录时间并关闭问题 | KEY-123 #time 2d 5h #close |
添加评论并过渡至进行中 | KEY-123 #comment Started working on the issue #in-progress |
新闻 | 句法 |
---|
有关智能提交的工作原理以及可使用的命令的更多信息,请参阅:
Jira 部署
您可以使用 Jira 部署直接在 Jira 中跟踪和可视化软件发布的进度。
在以下情况下,GitLab 会向 Jira 发送有关您的环境和部署的信息:
- 您的项目
.gitlab-ci.yml
文件包含environment
关键字。 - GitLab 的某些部分提到了Jira 问题 ID ,并触发了管道。
有关更多信息,请参阅环境和部署。