配置步骤
在Jira中添加gitlab专属用户
此用户在项目中至少要具备以下三种权限
- 添加注释
- 创建问题链接
- 工作流转换
GitLab中集成jira
配置网络
Admin Area --> Setting --> Network --> 展开Outbound requests
勾选Allow requests to the local network from web hooks and services
否则添加jira时候报如下错误:
Validations failed. Url is blocked: Requests to the local network are not allowed
集成配置
全局方案:
Admin Area --> Setting --> Integrations --> 选择Jira
默认选项即可
Web URL: jira访问地址
Username or Email: gitlab专属用户名
Enter new Password or API token: gitlab专属用户密码
Jira workflow transition IDs: 工作流转换ID
项目自定义方案:
选择对应项目–> Setting --> Integrations --> 选择Jira
默认选项即可
Web URL: jira访问地址
Username or Email: gitlab专属用户名
Enter new Password or API token: gitlab专属用户密码
Jira workflow transition IDs: 工作流转换ID
选择Test setting,测试配置是否正确,如果正确,保存
重点细节
注释和问题链接
GitLab自动在Jira问题中添加注释并创建问题链接:
Gitlab集成Jira重点在于commit中的关键词, 当gitlab用户提交时候, 带上Jira问题编号时候(例如 DEMO-25: 问题已解决),就会自动触发gitlab的推送, 在Jira对应问题编号的问题下添加注释(注释信息为commit信息),并添加一个问题链接,直接链接到gitlab对应版本
工作流转换:
commit关键字
- Closes 问题编号(例如 Closes DEMO-25)
- Fixed 问题编号(例如 Fixed DEMO-25)
对当前问题工作流要求
- gitlab专属用户, 可见下一步转换状态, 有权限转换当前状态到下一状态
- 问题的决结果不要手动配置,否则无法触发工作流转换
- GiltLab中项目默认分支必须为master
- GitLab中必须有merge到master动作,这里可以有两种实现方法
- gitlab用户直接提交代码到master分支(默认带有merge动作), commit信息中填写关键字Closes 问题编号或者Fixed 问题编号
- gitlab用户提交到临时分支, 管理用户讲临时分支merge到master分支, 在描述中填写关键字Closes 问题编号或者Fixed 问题编号