转载

Jenkins 中以构建 Tag 来实现版本管理

好的工具和流程能使我们事半功倍，而这个过程是不断迭代和演进的。关于这一块的内容，之前写过几篇文章：

在团队中使用GitLab中的Merge Request工作模式
敏捷下的需求和代码分支管理
不断进化的分支和需求管理

现在又有了些新的变化和改进，之所以需要改进，肯定是遇到问题了，那么就先从问题来开始今天的文章。

问题

问题分为两种：

方法论的问题：比如团队采用主干开发，主干发布的模式，但是质量得不到保证，这时通过分析讨论决定采用采用主干开发，分支发布的模式来解决，这属于从方法论层面解决问题。

落地执行的问题：已经知道应该采用主干开发，分支发布的模式，但在实际操作的时候，难以执行下去，这属于执行的问题。

在《不断进化的分支和需求管理》一文的最后提到会引入 release 分支和 tag，实际也这么做了，但效果并不理想，原因是执行的不严格，没有做到位，具体原因如下：

发布时是对分支进行构建发布，发布后再在 GitLab 中打上 tag，一忙起来很容易忘记；
镜像的版本也是如此。

解决思路

目的其实很简单，就是让代码的 tag 和镜像的 tag 能够一致，靠人工去做这些事情比想象的要更加困难，所以稍微转换了下思路就能实现自动化，也就可以解决这个问题。

之前提到的 release 分支只做最终的集成测试；
需要发布时就从 release 分支创建 tag，对 tag 来做发布，通过脚本自动创建镜像 tag 进行 push 。

流程图如下：

Jenkins 中以构建 Tag 来实现版本管理

实际操作

原来在 jenkins 中对分支进行发布，需要设置特定的分支，现在需要对 tag 进行发布，tag 是不断进行创建的，就需要用到 jenkisn 的参数化功能。

jenkins 的参数化需要用到 Git Parameter 插件，可以在 jenkins 的插件管理界面中直接安装，如果安装失败，可以在这个地址进行下载：http://mirror.xmission.com/jenkins/plugins/git-parameter/latest/，更多插件的使用说明参考官网：https://plugins.jenkins.io/git-parameter/

具体配置步骤如下：

1、在 General 下面勾选 This project is parameterized 。

Jenkins 中以构建 Tag 来实现版本管理

Name：参数名称，可以随便填写，在后面配置分支名称时会用到；
Parameter Type：这里我选择 Tag，你也可以根据需要选择 Branch 或者其他类型。

2、在 Source Code Management 选择 git 进行设置。

Jenkins 中以构建 Tag 来实现版本管理

Branch Specifier：${tag}, tag 为第一步中输入的参数名称。

设置完成后，可以看到在构建界面中由原来的 Build Now 变成了 Build with Parameters 。

Jenkins 中以构建 Tag 来实现版本管理

3、点击 Build with Parameters 选择需要构建的 tag 就可以了。

Jenkins 中以构建 Tag 来实现版本管理

按照 tag 进行构建搞定后，剩下就是需要在构建脚本中获取到最新的 tag 名称，并作为参数设置到容器的环境变量和镜像的 tag 中：

首先进入到 jenkins 配置的程序目录，使用 git describe --abbrev=0 --tags 获取 tab 名称；
前端容器使用环境变量的方式将 tag 名称传入，并最终在界面显示；
容器镜像使用参数的方式拼接上 tag 名称。

完整脚本如下：

#!/bin/bash

docker rm -f vue_demo
echo "old container vue_demo del success"

echo "begin docker build"
if [ ! -d web ]; then
  mkdir -p web
  echo "web dir created"
fi

# "获取最新tag 名称"
cd /root/code/vue_demo
tagName=`git describe --abbrev=0 --tags`
echo "tag name is：" $tagName

cd /root/build/vue_demo
cp /root/build/vue_demo/Dockerfile ./web
cp /root/build/vue_demo/init.sh ./web
cp -r /root/code/vue_demo/dist/* ./web

echo "begin docker build"
cd web
docker build -t vue_demo .
echo "build end"

docker run -d -p 9500:80 --name vue_demo -e "tag_name=${tagName}" --restart=always  vue_demo

cd ..
rm -rf web

echo "update docker iamges start"
docker tag vue_demo:latest 10.10.10.10:8888/vue_demo:${tagName}
docker push 10.10.10.10:8888/vue_demo:${tagName}
echo "update docker iamges end"