Help us learn about your current experience with the documentation. Take the survey.
Jira 开发面板
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
您可以使用 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 应用 |
|---|---|---|
| 智能提交 | 是 | 是 |
| 同步合并请求 | 是 | 是 |
| 同步分支 | 是 | 是 |
| 同步提交 | 是 | 是 |
| 同步现有数据 | 是 | 是（参见 同步到 Jira 的 GitLab 数据） |
| 同步构建 | 否 | 是 |
| 同步部署 | 否 | 是 |
| 同步功能标志 | 否 | 是 |
| 同步间隔 | 最多 60 分钟 | 实时 |
| 删除分支 | 否 | 是 |
| 从分支创建合并请求 | 是 | 是 |
| 从 Jira 问题创建分支 | 否 | 是 |
GitLab 中的已连接项目
Jira 开发面板将 Jira 实例及其所有项目连接到以下内容：
- 对于 GitLab for Jira Cloud 应用，已连接的 GitLab 组或子组及其项目
- 对于 Jira DVCS 连接器，已连接的 GitLab 组、子组或个人命名空间及其项目
开发面板中显示的信息
您可以在 Jira 开发面板中查看 Jira 问题的 GitLab 活动， 方法是在 GitLab 中通过 ID 引用 Jira 问题。开发面板中显示的信息取决于您在 GitLab 中提及 Jira 问题 ID 的位置。
对于 GitLab for Jira Cloud 应用，显示以下信息：
| GitLab：您提及 Jira 问题 ID 的位置 | Jira 开发面板：显示什么信息 |
|---|---|
| 合并请求标题或描述 | 合并请求链接 部署链接 通过合并请求标题链接到流水线 通过合并请求描述链接到流水线（在 GitLab 15.10 中引入） 分支链接（在 GitLab 15.11 中引入） 审查者信息和批准状态（在 GitLab 16.5 中引入） |
| 分支名称 | 分支链接 部署链接 |
| 提交消息 | 提交链接 从最后一次成功部署到环境后的最多 2,000 个提交中链接到部署 1 2 |
| Jira 智能提交 | 自定义评论、记录的时间或工作流转换 |
脚注：
- 在 GitLab 16.2 中引入 并带有标志
jira_deployment_issue_keys。默认启用。 - 在 GitLab 16.3 中正式发布。移除了功能标志
jira_deployment_issue_keys。
Jira 智能提交
先决条件：
- 您必须拥有相同邮箱地址或用户名的 GitLab 和 Jira 用户账户。
- 命令必须在提交消息的第一行。
- 提交消息不能超过一行。
Jira 智能提交是处理 Jira 问题的特殊命令。通过这些命令，您可以使用 GitLab：
- 向 Jira 问题添加自定义评论。
- 记录在 Jira 问题上花费的时间。
- 将 Jira 问题转换到项目工作流中定义的任何状态。
智能提交必须遵循以下语法：
<ISSUE_KEY> <忽略的文本> #<命令> <可选命令参数>您可以在单个提交中执行一个或多个命令。
智能提交语法
| 命令 | 语法 |
|---|---|
| 添加评论 | KEY-123 #comment Bug 已修复 |
| 记录时间 | KEY-123 #time 2w 4d 10h 52m 跟踪工作时间 |
| 关闭问题 | KEY-123 #close 关闭问题 |
| 记录时间并关闭问题 | KEY-123 #time 2d 5h #close |
| 添加评论并转换为进行中 | KEY-123 #comment 开始处理此问题 #in-progress |
有关智能提交的工作原理和可用命令的更多信息，请参见：
Jira 部署
您可以使用 Jira 部署直接在 Jira 中跟踪和可视化软件发布的进度。
如果满足以下条件，GitLab 会将您的环境和部署信息发送到 Jira：
- 您项目的
.gitlab-ci.yml文件包含environment关键字。 - Jira 问题 ID 在GitLab 的某些部分被提及并且触发了流水线。
有关更多信息，请参见环境和部署。