Jenkins构建中tag的应用

文章发布较早，内容可能过时，阅读注意甄别。

# 1，缘起。

许多公司在做安卓的构建或者其他项目构建的同时，会有打tag到Gitlab的需求，这个需求的存在有其实在的价值意义，不仅仅让每一次我们发布过的代码有记录存留，也能够方便一些其他的功能（比如回滚），因此，今天就来说说这个事儿。

这个功能的实现依赖于 Jenkins 的 git 插件，不过一般都默认有安装。

先准备一个测试项目，内容如下：

然后来到 Jenkins 处，做一些简单的功能，能够用于测试验证即可。

执行 shell 处加一些简单的操作：

git pull origin master
echo "**********************************************"
cat README.md
echo "**********************************************"

1
2
3
4

进入正式配置之前需要先安装本文的主角Git Parameter插件，插件详情，可以点我查看。 (opens new window)

在构建后的操作中添加Git Publisher，然后如图中所示配置：

在构建后操作当中选择Git Publisher，然后如图配置：

配置一：定义 tag 名称，release-$BUILD_NUMBER 这里取用了一个 Jenkins 的环境变量，用于每次的 tag 自增问题。
配置二：选中，以表示创建一个新的 tag。
配置三：要推送的项目。

接着我们构建一下看看效果：

看样子 tag 已经打好并且推送到远程服务器去了。

现在去 git 里边看看是否有了。

图中圈起来的地方可以看到，正好与我们构建此时对应的，创建了三个标签。

现在我们模拟开发，更改一下项目文件内容，然后再构建一下看看情况。

来波操作：

Administrator@liqilong MINGW64 ~/Desktop/gittest/eryajf (master)
$ echo "第二次添加内容用于测试" >> README.md

Administrator@liqilong MINGW64 ~/Desktop/gittest/eryajf (master)
$ git commit -a -m "add two"
warning: LF will be replaced by CRLF in README.md.
The file will have its original line endings in your working directory.
[master 822b2f3] add two
 1 file changed, 1 insertion(+), 1 deletion(-)

Administrator@liqilong MINGW64 ~/Desktop/gittest/eryajf (master)
$ git push
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 307 bytes | 76.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To 192.168.106.70:linux/eryajf.git
   635b61c..822b2f3  master -> master

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

然后再去构建一下：

第四次构建，已经看到刚刚模拟开发所添加的内容了。

那么现在，就可以引出这个自动打 tag 的功能所带来的另外一个大方便了，那就是方便回滚。

# 2，回滚功能。

我们可以在参数化构建当中进行参数的定义，依赖于 Git 版本控制的特性，当用户选择的是构建时，可以选择对应的分支进行构建，当用户选择的是回滚是，那么可以选择对应的 tag 进行回滚。事实上与分支的构建回滚是一个道理，不过这里直接选择 tag，也非常方便。

那么在验证之前，我们需要对 Jenkins 进行一些小小的调整，通过添加刚刚表述的参数，以及执行的 shell 的配合，来完成这样一个构建回滚各有分工的一个事情。

# 1，添加 mode 选项。

在参数化构建过程中先添加一个选项参数，从而让构建以及回滚两种情况存在。具体配置如图:

# 2，再添加 branch 选项。

然后添加一个用于构建不同代码分支的字符参数，这个是一个很常规的配置，就不做过多介绍，具体如图：

# 3，添加 Git Parameter 选项。

然后添加一个用于回滚不同 tag 的选项，这里的 tag 是我们项目自动生成的，随后会做一下总结，具体如图：

# 4，修改 shell 内容。

修改一下 shell 的执行内容，做一个简单判断，脚本如下：

cd $WORKSPACE
if [ $mode == "deploy" ];then
    git checkout $branch
    git pull
    echo "**********************************************"
    cat README.md
    echo "**********************************************"
else
    git reset --hard $tagbak
    echo "**********************************************"
    cat README.md
    echo "**********************************************"
fi