一、为什么要做 JIRA  和 GitLab 集成

   GitLab 是面向开发人员的, 而 JIRA 更多的是项目管理驱动的, 而项目的目标总是要让团队更加紧密的协作。 一般项目管理员倾向于不干预 Gitlab, 同样的,开发人员也不是很有激情在 JIRA 上做贡献. 通过把 GitLab 集成到 JIRA, 可以解决这个痛点,因为这样可以提供一个更加舒适的环境,让开发人员可以通过 commit 语句方便的项目团队沟通:

            当开发人员提交代码到 gitlab 的时候,gitlab 可以根据 commit 信息,向对应的 jira 添加一个备注和一条链接:

            JIRA 集成 Gitlab_JIRA

            JIRA 集成 Gitlab_工作日志_02


        在 JIRA平台上,可以看到和各个 jira 对应的代码提交情况:某个功能,或者某个 bug,对应那些代码,一目了然。而且可以通过点击commit的链接,直接跳转到 gitlab 上,查看提交的代码。

            JIRA 集成 Gitlab_开发人员_03

            JIRA 集成 Gitlab_工作日志_04



        如果在 JIRA 平台上安装一些 Git 插件,还可以有获得更多强大的辅助功能:(本博客以 git integration for jira 插件为例演示,遗憾的是这个插件是收费的)

JIRA 集成 Gitlab_Gitlab_05


二、集成配置

    JIRA 集成 Gitlab,配置的难点在于 Gitlab。不同版本的 Gitlab 配置差异还是挺大的。不过,仔细阅读并按照以下两份文档

的说明一步一步配置,应该没有问题。

    参考文档:

        ​​比较新的gitlab版本的集成配置指南​

        ​​比较旧的gitlab版本的集成配置指南​

        ​​额外的配置参考文档​

    本博客演示使用的 Gitlab 是 Gitlab 官方提供的在线版 gitlab。

1、在 JIRA 使用管理员账号创建一个项目

Projects - Create project

JIRA 集成 Gitlab_开发人员_06


选择“Basic Software development”,点击 Next

JIRA 集成 Gitlab_git_07

点击 Select

JIRA 集成 Gitlab_Gitlab_08


输入 name 和 key,点击 submit ,项目创建完成。

JIRA 集成 Gitlab_开发人员_09


2、在 GitLab 创建一个项目

JIRA 集成 Gitlab_git_10


点击 setting - integration - jira :

JIRA 集成 Gitlab_Gitlab_11


JIRA 集成 Gitlab_工作日志_12


JIRA 集成 Gitlab_工作日志_13


点击 View:

JIRA 集成 Gitlab_Gitlab_14


最后,点击“Test setting and save changes”:

JIRA 集成 Gitlab_工作日志_15


到此为止,配置完成。

三、在 JIRA 安装 Git 插件

演示安装插件 git integration for jira

1、在线安装。比较简单,省略。

JIRA 集成 Gitlab_开发人员_16

2、手动安装

登录官网,选择下载对应的安装包:

JIRA 集成 Gitlab_工作日志_17

JIRA 集成 Gitlab_工作日志_18

JIRA 集成 Gitlab_git_19

JIRA 集成 Gitlab_开发人员_20

JIRA 集成 Gitlab_git_21


最终下载得到的是一个名为 jira_git_plugin-**.jar 的文件

在 JIRA 上传安装下载的插件包

JIRA 集成 Gitlab_JIRA_22

JIRA 集成 Gitlab_JIRA_23

JIRA 集成 Gitlab_Gitlab_24

JIRA 集成 Gitlab_开发人员_25

JIRA 集成 Gitlab_工作日志_26


出现错误,是因为还没有配置上license:

JIRA 集成 Gitlab_开发人员_27

点击“update”:

JIRA 集成 Gitlab_git_28

 然后点击 Gitlab 图标:

JIRA 集成 Gitlab_JIRA_29

JIRA 集成 Gitlab_工作日志_30

JIRA 集成 Gitlab_JIRA_31

JIRA 集成 Gitlab_JIRA_32

JIRA 集成 Gitlab_开发人员_33