Jenkins：Jenkins创建自由风格任务

前言

使用Gitlab + Jenkins + Docker + Harbor 完成一次Spring Boot（单体maven工程）的自动化构建部署。
前置条件：

1. 机器一：您要安装好Gitlab机器
2. 机器二：您要有安装好Jenkins + Docker + Maven + Jdk + Git + Harbor + docker-compose
3. 机器三：您要安装好Docker
4. 所有机器都能正常ping通

机器一进项项目源码的管理，机器二负责拉取源码，制作镜像，打好标签后推送到私有镜像仓库。机器三负责拉取镜像，然后启动容器

条件有限，如果可以将Harbor单独安装到一台服务器上

相关链接：Gitlab的安装及基本使用，Harbor的安装及使用教程，Jenkins安装教程，Jenkins的插件安装及使用教程汇总

分析大体步骤

步骤1，创建Spring Boot项目

如下图所示，我们新建一个spring boot 项目，使用maven进行三方包的依赖管理。在项目根目录下创建一个Dockerfile文件，用来进项镜像的构建。最后在static下创建一个html文件，项目启动成功后，访问http://ip:port/hello-world.html只要页面显示 hello world 字符串即可证明项目启动成功。

Dockerfile文件的内容如下：

FROM openjdk:8
ADD ./target/*.jar /app.jar
EXPOSE 8080
ENTRYPOINT java -jar /app.jar

步骤2，创建Gitlab项目

在Gitlab上创建一个项目，然后将步骤1中的本地项目推送到远程仓库中去。

新建Gitlab项目

推送项目到Gitlab

先进入项目根目录打开命令窗口

git init
git remote add origin http://192.168.31.128:82/demo/standalone-maven.git
# 因为我使用的gitlab比较新，默认是使用main主分支，所以我们本地也新建一个main分支
git checkout -b main
git pull origin main
git add .
git commit -m "init standalone-maven"
git push origin main

步骤3，远程服务器创建部署脚本创建

在生产主机上创建一个部署项目的脚本文件:develop.sh，它的作用就是拉取镜像仓库harbor中的镜像，然后使用新的镜像创建新的容器并运行。
/root/develop.sh 的内容如下

#!/bin/bash
# 登录
docker login http://192.168.31.196:85 -u harbor -p Harbor123 &> develop.log
# 拉取镜像
docker pull 192.168.31.196:85/standalone-maven-harbor-repository/standalone-maven:v1.0 &>> develop.log
#停止容器
docker stop `docker ps | grep standalone-maven | awk '{print $1}'` &>> develop.log
# 创建新的容器并运行容器
docker run -id -p8080:8080 --name standalone-maven`date +%s`  192.168.31.196:85/standalone-maven-harbor-repository/standalone-maven:v1.0 &>> develop.log

步骤4，创建Jenkins项目

前提条件

1、jenkins 所在的服务器要安装Git、Jdk、Maven、Docker等软件

2、在jenkins的系统配置中添加几个全局环境变量：

3、 添加gitlab的凭证（需要事先安装插件 Role-based Authorization Strategy）jenkins常用插件安装使用教程

4、Harbor需要事先安装配置好
5、在Jenkins的系统管理 -> 系统配置 中新增SSH Server（需要事先安装插件Publish over SSH）

创建自由风格任务

自由风格是jenkins安装后，自带的创建任务方式。

1. 新建自由风格项目，名字命名为 standalone-maven
2. 配置 源码管理,使用Git方式管理源码，注意配置正确的git仓库及其凭据分支等详细信息。
3. 构建里输入shell 命令（最终目的是将源码打成jar包，然后docker打标签推送到远程harbor仓库）
4. 构建环境中配置调用远程服务器的shell脚本（从harbor拉取镜像然后启动容器）
5. 测试项目是否成功启动
6. 修改本地代码然后提交gitlab，再构建刚创建的自由风格任务。
7. 测试项目是否修改更新了

构建内配置的shell命令

echo "1.maven打包构建"
mvn clean package -Dmaven.test.skip=true 
echo "2.制作镜像"
docker build -t standalone-maven:v1.0 .
echo "3.给镜像打标签"
docker tag standalone-maven:v1.0 192.168.31.196:85/standalone-maven-harbor-repository/standalone-maven:v1.0
echo "4.登录harbor"
docker login http://192.168.31.196:85 -u harbor -p Harbor123  
echo "5.推送镜像"
docker push 192.168.31.196:85/standalone-maven-harbor-repository/standalone-maven:v1.0
echo "6.删除本地镜像"
docker rmi -f `docker images | grep 192.168.31.196:85/standalone-maven-harbor-repository/standalone-maven  | awk '{print $3}'`

上述的命令，我们也可以写成一个脚本文件，然后再执行这个脚本文件，例如：

1. 将shell命令复制到jenkins的/root/jenkins-build.sh中去
2. 给脚本添加执行权限（需要jenkins能正常执行即可）
3. 将构建内shell命令 修改为/root/jenkins-build.sh
   

访问成功

修改文件，然后提交gitlab

构建成功后，等待容器启动，再访问页面，如果发现页面发生了变化即表示测试成功。

总结

上面是我在学习过Jenkins后的动手实践，这只是简单的一个单体项目，所以我这里采用了自由风格，也可以使用流水线（比较流行），后续还会介绍更多方式。