{{< details >}}
- Tier: 基础版, 专业版, 旗舰版
- Offering: JihuLab.com, 私有化部署
{{< /details >}}
你可以使用 Jira 开发面板直接在 Jira 中查看极狐GitLab 活动。要设置 Jira 开发面板:
- 对于 Jira Cloud,使用由极狐GitLab 开发和维护的 GitLab for Jira Cloud app。
- 对于 Jira Data Center 或 Jira Server,使用由 Atlassian 开发和维护的 Jira DVCS connector。
功能可用性
{{< history >}}
- 删除分支的功能在极狐GitLab 17.1 中引入,使用名为
jira_connect_remove_branches
的功能标志。默认禁用。 - 删除分支的功能在极狐GitLab 17.2 中 GA。功能标志
jira_connect_remove_branches
被移除。
{{< /history >}}
此表显示了 Jira DVCS 连接器和 GitLab for Jira Cloud app 可用的功能:
功能 | Jira DVCS 连接器 | GitLab for Jira Cloud app |
---|---|---|
智能提交 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes |
同步合并请求 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes |
同步分支 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes |
同步提交 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes |
同步现有数据 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes (参见 GitLab data synced to Jira) |
同步构建 | {{< icon name=”dotted-circle” >}} No | {{< icon name=”check-circle” >}} Yes |
同步部署 | {{< icon name=”dotted-circle” >}} No | {{< icon name=”check-circle” >}} Yes |
同步功能标志 | {{< icon name=”dotted-circle” >}} No | {{< icon name=”check-circle” >}} Yes |
同步间隔 | 最多 60 分钟 | 实时 |
删除分支 | {{< icon name=”dotted-circle” >}} No | {{< icon name=”check-circle” >}} Yes |
从分支创建合并请求 | {{< icon name=”check-circle” >}} Yes | {{< icon name=”check-circle” >}} Yes |
从 Jira 议题创建分支 | {{< icon name=”dotted-circle” >}} No | {{< icon name=”check-circle” >}} Yes |
极狐GitLab 中的连接项目
Jira 开发面板将一个 Jira 实例与其所有项目连接到以下内容:
- 对于 GitLab for Jira Cloud app,链接的极狐GitLab 群组或子群组及其项目
- 对于 Jira DVCS connector,链接的极狐GitLab 群组、子群组或个人命名空间及其项目
开发面板中显示的信息
你可以通过在极狐GitLab 中引用 Jira 议题的 ID 来在 Jira 开发面板中 查看 Jira 议题的极狐GitLab 活动。开发面板中显示的信息取决于你在极狐GitLab 的哪个地方提到 Jira 议题 ID。
对于 GitLab for Jira Cloud app,显示以下信息。
极狐GitLab:你在哪提到 Jira 议题 ID | Jira 开发面板:显示什么信息 |
---|---|
合并请求标题或描述 | 链接到合并请求 链接到部署 通过合并请求标题链接到流水线 通过合并请求描述链接到流水线 (引入于极狐GitLab 15.10) 链接到分支 (引入于极狐GitLab 15.11) 审阅人信息和批准状态 (引入于极狐GitLab 16.5) |
分支名称 | 链接到分支 链接到部署 |
提交信息 | 链接到提交 在最后一次成功部署到环境后的最多 5,000 次提交中链接到部署 1 2 |
Jira Smart Commit | 自定义评论、记录时间或工作流转换 |
脚注:
- 在极狐GitLab 16.2 中引入,使用名为
jira_deployment_issue_keys
的功能标志。默认启用。 - 在极狐GitLab 16.3 中 GA。功能标志
jira_deployment_issue_keys
被移除。
Jira Smart Commits
前提条件:
- 你必须拥有相同电子邮件地址或用户名的极狐GitLab 和 Jira 用户帐户。
- 命令必须在提交消息的第一行。
- 提交消息不能超过一行。
Jira Smart Commits 是处理 Jira 议题的特殊命令。使用这些命令,你可以使用极狐GitLab:
- 向 Jira 议题添加自定义评论。
- 记录 Jira 议题的时间。
- 将 Jira 议题转换为项目工作流中定义的任何状态。
Smart Commits 必须遵循以下语法:
<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 |
有关 Smart Commits 如何工作以及可用命令的更多信息,请参阅:
- 使用 Smart Commits 处理议题
- 使用 Smart Commits
Jira 部署
你可以使用 Jira 部署直接在 Jira 中跟踪和可视化软件发布的进度。
如果:
- 你的项目的
.gitlab-ci.yml
文件包含environment
关键字。 - 极狐GitLab 的某些部分 提到了 Jira 议题 ID 并触发了流水线。
有关更多信息,请参阅 环境和部署。