Jenkins 配合 GitLab 实现分支的自动合并、自动建立 Tag

Jenkins 配合 GitLab 实现分支的自动合并、自动建立 Tag

背景

GitFlow工做流简介

Gitflow工做流定义了一个围绕项目发布的严格分支模型，它会相对复杂一点，但提供了用于一个健壮的用于管理大型项目的框架，很是适合用来管理大型项目的发布和维护。 贯穿整个开发周期，master和develop分支是一直存在的，master分支能够被视为稳定的分支， 而develop分支是相对稳定的分支，特性开发会在feature分支上进行，发布会在release分支上进行，而bug修复则会在hotfix分支上进行，这样也有效避免了不一样类型的开发工做在代码层级的耦合和干扰。

GitFlow工做流优化

• hotfix和release的结果都要合并到master和develop中，为何？由于它们的修改结果将持续影响这后续的开发和维护，必须合并以保证代码的一致性。

• 当线上项目须要版本回退，或者须要简单记录迭代版本时，咱们常在master分支上打上 Tag 标签，例如：

  • 功能发布：release_20190101_当月版本数
  • BUG修复：hotfix_20190101_修复次数

本文基于GitFlow工做流，将利用Jenkins配合GitLab实现如下自动化任务：

• master分支代码更新后，自动将代码合并到develop分支
• master分支代码更新后，自动在master分支提交中打 tag

Jenkins自动任务Job的建立

Jenkins是一个用Java编写的开源的持续集成工具，能够与Git打通，监听Git的merge, push事件，触发执行Jenkins的指定任务(job)，例如执行单元测试。更多的是：当代码变动时能够触发打包部署、性能测试、接口测试、监控、日志分析等。项目发布的任何一个环节均可自动完成，无需太多的人工干预，有利于减小重复过程以节省时间和工做量等。

如何建立Jenkins Job

下面列出自动任务Jenkins Job的建立过程，供参考。建立过程以下：

• 首先，建立一个任务，输入名称，选择“构建一个自由风格的软件项目” 肯定便可。

• General：填写项目名称及描述；Label Expression 是在Jenkins admin 中配置的节点（container, node），一个Label Expression 是一组docker，当多个不一样的Job同时执行的时候，能够实现并行。

• 源码管理：在Repository URL中填写GitLab中的项目地址；Branches to build此处的Branch Specifier是触发Jenkins Job时由Jenkins自动拉取的代码的分支，能够填写一个固定的指定分支，如master，也能够写正则表达式。另外，也能够填写${gitlabSourceBranch}。若是填写${gitlabSourceBranch}，表示从git读取Merge Request的源分支，使用该变量，则不能手工点击Job的“当即构建”执行job了，由于读取不到这个变量只能经过git push事件触发了。具体能够根据应用场景选择。

• 构建触发器：下面截图中指定的是：仅当产生 push 事件时且目标分支为master时触发此job。这里能够根据需求来具体配置。Filter branches by name：仅当目标分支为 master 时触发Job。

• 构建环境 & 构建：构建环境勾选第一项指在每次构建开始以前先清空工做空间；构建中的Execute shell Command 中就能够配置咱们自动化脚本，咱们能够把这些脚本放到项目根目录当中，也能够放到一个GitLab仓库当中，来统一管理脚本（文末附脚本示例）。

• 构建后操做（Editable Email Notification）：用于配置邮件提醒。

  • Disable Extended Email Publisher：勾选后，邮件就不发送；
  • Project Recipient List：收件人地址；多个收件人邮件地址用逗号进行分割；
  • Project Reply-To List：容许回复人的地址；默认为$DEFAULT_REPLYTO；
  • Content Type：邮件文档的类型，能够设置HTML等格式；
  • Default Subject：默认邮件标题；也可使用$DEFAULT_SUBJECT；
  • Default Content：默认邮件内容，这里能够写HTML文件，引用Jenkins内部的一些变量；也可使用默认内容：$DEFAULT_CONTENT；
  • Attach Build Log：发送的邮件是否包含日志。

  Triggers 中的配置须要注意下，通常配置为Job执行失败的时候发送邮件

Jenkins Job 如何与 Git 关联

在GitLab项目的Settings中找到以下图的配置：勾选“Active”，指定在Git Push 或 mr 建立/更新/合并时触发指定的 Jenkins url，Project name 为Jenkins 中配置的Job名称，用户名、密码是jenkins的帐号和密码。

总体步骤梳理

1. GitLab上准备一个项目工程；
2. 安装Jenkins以及相关的GitLab插件；
3. Jenkins配置GitLab访问权限；
4. Jenkins上建立一个Job，对应步骤1中的项目工程；
5. GitLab项目中配置Jenkins；
6. 修改项目工程的源码，并提交到GitLab上；
7. 检查Jenkins的构建任务是否会触发配置的脚本。

脚本示例

如下为master分支代码更新后，自动在master分支提交中打 tag的脚本示例，仅供参考：

（ Tag 标签命名规则: release_当前日期_当月版本_当季度版本_当年版本 ）

#!/bin/sh
echo **********************************Start********************************
date
# 获取最近一次远程 master 提交的 commit id
sha1=`git rev-parse remotes/origin/master^{commit}`
# 获取姓名及邮箱，来配置git提交者信息
name=`git show --pretty=%an $sha1 | awk 'NR==1{print}'`
email=`git show --pretty=%ce $sha1 | awk 'NR==1{print}'`
echo '################# 当前提交人信息:'
echo $name 
echo $email 
git config --global user.name $name
git config --global user.email $email

# 获取 merge 的源分支前缀
function getOriginPrefix(){
  # 获取分支所属
  info_sha1=`git show $sha1 | grep 'Merge:' | cut -d' ' -f3`
  info_branch=`git branch -r --contains $info_sha1`
  # 判断是否 hotfix 分支
  isHotfix=`echo "${info_branch}" | grep 'origin/hotfix'`
  if [ -n "$isHotfix" ]; then 
    echo 'hotfix'
  else
    echo 'release'
  fi
}
originBra=$(getOriginPrefix)
echo '################# 获取的源分支前缀为:' $originBra

# 获取最近一次建立的标签
latestTag=`git for-each-ref --sort=-taggerdate --format "%(tag)" refs/tags | grep $originBra | head -n 1`
# 获取最近标签的年
latestYear=`echo "${latestTag}" | awk -F_ '{print substr($2,1,4)}'`
# 获取最近标签的月
latestMonth=`echo "${latestTag}" | awk -F_ '{print substr($2,5,2)}'`
# 获取最近标签的季度
latestQuarter=`echo "${latestMonth}" | awk '{print int(($0-1)/3)+1}'`

# 获取当年
currentYear=`date +%Y`
# 获取当月
currentMonth=`date +%m`
# 获取当日
currentDay=`date +%Y%m%d`
# 获取当前季度
currentQuarter=`echo $currentMonth | awk '{print int(($0-1)/3)+1}'`

# 计算当月版本号
if [ $latestMonth -eq $currentMonth ]; then 
  currentMonthVersion=`echo "${latestTag}" | awk -F_ '{print $3+1}'`
else
  currentMonthVersion='1'
fi

# 计算当季度版本号
if [ $latestQuarter -eq $currentQuarter ]; then 
  currentQuarterVersion=`echo "${latestTag}" | awk -F_ '{print $4+1}'`
else
  currentQuarterVersion='1'
fi

# 计算当年版本号
if [ $latestYear -eq $currentYear ]; then 
  currentVersion=`echo "${latestTag}" | awk -F_ '{print $5+1}'`
else
  currentVersion='1'
fi

# 获取最终标签名 
newVersion=$originBra'_'$currentDay'_'$currentMonthVersion'_'$currentQuarterVersion'_'$currentVersion

# 建立标签
git tag -a $newVersion -m '提交人: '$name
git push origin --tags
newTag=`git tag -l | grep $newVersion`
echo '################# 最近建立的标签为:' $latestTag
echo '################# 自动计算的标签为:' $newVersion
echo '################# 自动建立的标签为:' $newTag
echo **********************************End**********************************

参考资料

Jenkins 官方文档

GitLab 官方文档

GitFlow 工做流

转载请标注出处，谢谢！http://www.javashuo.com/article/p-hffoopwc-z.html