手把手教你使用 Jenkins+Docker 实现持续集成

作者：乐之终曲
来源：https://blog.csdn.net/qq_37143673/

对于 Jenkins 我只能用两个字形容，难用。就不过多吐槽了，本篇是基于 docker 环境的使用。

1.安装

寻找需要的 Jenkins 镜像：

https://hub.docker.com/r/jenkinsci/blueocean

docker pull jenkinsci/blueocean

我选择的镜像是 Jenkins-blueocean Jenkins 海洋版，为什么选这个？

• 踩坑：普通的 Jenkins 在部署的时候不少人都遇到过，插件下不下来，但是在海洋版没有这个问题（最主要原因）
• blueocean 的页面更加人性化，流程的监控上看着让人舒服的多，当然普通 Jenkins 也可以通过安装插件添加这个功能

启动镜像

docker run 
--name jenkinsci-blueocean -u root 
--rm -d -p 7005:8080 -p 50000:50000 
-v /data/jenkins:/var/jenkins_home 
-v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean

• -u root：以 root 权限启动，防止出现权限问题
• -p 7005:8080：端口映射，服务器的 7005 端口映射容器的 8080 端口
• -p 50000:50000：Jenkins代理默认通过TCP端口50000与Jenkins主机通信
• -v /data/jenkins:/var/jenkins_home：把容器内的 Jenkins 目录挂载到服务器的 /data/jenkins 目录以防容器没了，数据也没了
• -v /var/run/docker.sock:/var/run/docker.sock：保证容器内的 docker 与 服务器上 docker 的通讯

附带下删除 jenkinsci/blueocean 容器

# 删除对应绑定网桥
docker network disconnect --force bridge jenkinsci-blueocean
# 删除 jenkinsci-blueocean 容器，xxxx 容器 ID
docker rm -f xxxx

输入密码进入

由于我们挂载映射到服务器，所以可以直接通过服务器路径找密码

cat /data/jenkins/secrets/initialAdminPassword

或者直接通过容器日志可以看到密码：docker logs xxxx（容器 ID）

接下来，我选择推荐插件安装

创建第一个账号，我用的 root 123456

然后完成安装，由于是用的是镜像，所以安装起来非常的简单，海洋版也没有出现插件无法下载的问题

2.创建项目与持续集成

踩坑PS：为什么说难用，就是在这。一开始我是把 jdk 和 maven 也挂载到容器里的，但是配置完全局变量后，根本无法使用，可能是容器内也要配置好这些才行，我就搞不懂容器内配了那还要专门配个全局环境变量干啥。。。自动安装也是完全没用，所以我放弃了，用我自己的方法进行持续集成部署。

接下来配置项目，选择流水线

配置

这里我们通过 webhook，让项目提交后，自动调用钩子函数进行部署，进行持续集成

配置构建触发器，也就是钩子函数

身份验证令牌自己写的，所以这里钩子函数的路径就是

http://127.0.0.1:7005/job/spring-cloud/build?token=123456

PS：身份验证令牌框下面就是钩子函数的请求路径说明，不太明白的，可以自己看看，我上面给的这个是示例

配置项目

公私密钥的可参考：

https://blog.csdn.net/weixin_41235146/article/details/81780894

然后保存，这里暂时就配好了

root 创建 API token

记住这串 token，后面要和钩子函数一起使用，离开这个页面后再进入就看不到这串 token 了

系统管理 => 全局安全配置

PS踩坑：这里不配置的话，后面钩子函数的请求都会 403 失败

接下来配置钩子函数的请求了，这里以 gitee 为例

进入项目 => 管理 => WebHook

请求历史可以看到请求成功 201

先说下本人用于测试的这个项目是父子项目，打包时候把每个子项目打成 jar 包，然后通过 Dockerfile 生产 docker 镜像，然后启动镜像生成容器，这就是我的部署流程

项目根目录下新增 Jenkinsfile

PS踩坑：由于 maven 配置不成功，我也不想进容器配置 maven，因为服务器才 1G ，进容器就死机了，所以我改了依赖 maven 镜像部署，然后再通过另一个任务把 jar 包生成镜像，因为 maven 容器里没有 docker 环境

先 pull 个 maven 镜像，以及在构建镜像时候所需要的 jdk8 的镜像

# maven 用于 Jenkins 构建有 maven 环境的容器
docker pull maven
# jdk8 的镜像用于 Dockerfile 中设置构建拥有 jdk8 环境镜像的基础镜像
docker pull kdvolder/jdk8

• image 'docker.io/maven'：基于这个镜像生成容器部署，所以环境有 maven 环境
• args 中 -v /root/.m2:/root/.m2：把依赖挂载导服务器上，不用每次打包都下依赖
• PS：首先，你要知道这个流程是如何进行的，在你根据下的那个 maven 镜像去打包时，由于内外 docker 建立了通讯，所有服务器的 docker 就会生成一个你 maven 的容器，而你的命令都会在这个容器里进行，所以这里挂载就能直接把 maven 这个临时容器里的依赖挂载到服务器上，打包的过程中，你用 docker ps 是可以看到这个 maven 容器的
• args 中 -v /data/maven/apache-maven-3.6.0/conf/settings.xml:/root/.m2/settings.xml：阿里环境配置挂进去
• PS踩坑：这里注意，挂载进去的 settings.xml 文件必须放在 .m2 文件夹下，不是放在 maven 的 conf 下面，那样不会生效
• --entrypoint=：配置下好像就不会打开进入容器了，没深入研究
• ${env.WORKSPACE}：工作空间路径
• ${env.NODE_NAME}：进行的分支

Jenkins 内置环境变量可参考：

https://www.cnblogs.com/puresoul/p/4828913.htm

可以看到，我这部署先判度为 master 分支的情况下，package 任务中调用脚本进行打包，build 任务下调用脚本部署

下面贴下这两个脚本，大伙可以参考下

package-prod.sh

#!/bin/sh
#进入文件根目录
#cd "$WORKSPACE"
#项目打包
mvn clean install package '-Dmaven.test.skip=true'

build-prod.sh

我写配置喜欢统一性配置，后面改起来简单，上面参数换下下面都不需要改，这里我的文件夹名，镜像名和生产的 jar 名都用一样的也是这个目的

打包成功，这画面看的好看不少