Jenkins自动化部署集成了docker-maven插件的多模块项目--粉丝服务平台-粉丝头条-fensifuwu.com

Jenkins自动化部署集成了docker-maven插件的多模块项目

科技 07-02 来源：互联网架构小马哥

Jenkins自动化部署环境搭建

本文的目的是将多模块的项目利用 jenkins 实现自动化的部署，再将代码推送到 gitlab 时，jenkins 通过轮询的方式查看 gitlab 的代码是否有变化，有变化则拉取仓库的代码，使用 maven 打包，而我的项目的各个子模块又集成了 docker-mavne 插件，会将各模块的服务打包为 docker 镜像推送到服务器，在服务器编写好对应 docker-compose.yml 编排文件启动项目，所以 jenkind 需要在 maven 打包完成后，向服务器发送编排启动项目的命令，即可达到自动化部署项目的目的

1.拉取镜像

有很多的 jenkins 镜像，我们选择 jdk8 这一个

docker pull jenkins/jenkins:latest-jdk8

2.准备 maven 和 jdk

自行前往官网下载对应的版本，这里采用的是 maven3.6.3 和 jdk8

3.编写编排文件

准备一个目录放置挂载文件和 docker-compose.yml 文件

新建一个名为 hudson.model.UpdateCenter.xml 的文件,填入以下内容

<?xml version='1.1' encoding='UTF-8'?>


default

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

新建 docker-compose.yml 文件

version: '3'
services:
docker_jenkins:
user: root
restart: always
image: jenkins/jenkins:latest-jdk8
container_name: jenkins
ports:
- 8080:8080
- 5000:5000
volumes:
- /etc/localtime:/etc/localtime # 挂载位置（镜像和宿主机器之间时间保持一致）
- ./jenkins_home:/var/jenkins_home
# 挂载maven,按自己的需求修改maven的配置文件,配置仓库地址和本地仓库存储地址
- ./apache-maven-3.6.3:/var/jenkins_home/maven
# 挂载 jdk8
- ./jdk1.8.0_202:/var/jenkins_home/jdk8
- ./jenkinsci:/usr/jenkinsci
- /var/run/docker.sock:/var/run/docker.sock
- /usr/bin/docker:/usr/bin/docker
- /usr/local/bin/docker-compose:/usr/local/bin/docker-compose
# 挂载出生成的密钥
- ./ssh:/root/.ssh
# 如果容器无法解析域名，则需要将容器的网络模式修改为 host 模式

启动项目：docker-compose up -d

4.初始化 Jenkins

1.第一次登录需要在服务模块下获取密码，因为已经将 jenkins_home 目录挂载出来了，直接去对应的目录下找即可。

第一次登录需要在服务模块下获取密码，因为已经将 jenkins_home 目录挂载出来了，直接去对应的目录下找即可。

2.选择安装推荐的插件

3.创建一个账户

4.进入管理界面

5.安装插件

这里主要安装 Maven Integration 和 publish over ssh 插件

系统管理 -> 插件管理 -> 可选插件搜索这两个插件下载即可

6.配置 maven 环境和 jdk 环境

进入系统管理 -> 全局工具配置

配置 maven，新增maven，配置 maven_home

配置 settings 所在的路径

7.配置 jdk

8.配置 Publish over SSH，增加一个 ssh server，方便使用 ssh 连接服务器执行一些命令，或者传输文件

.5.gitlab配置ssh

安装 gitlab 插件

系统管理 -> 插件管理 -> 可选插件搜索 gitlab

2.登录到jenkins服务器，生成秘钥，进入 jenkins 容器内部执行命令

# 生成密钥
ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa
# 查看公钥
cat /root/.ssh/id_rsa.pub

1.登录到 gitlab 添加 ssh keys

点击头像 -> settings -> SSH Keys id_rsa.pub 复制到网页框中

2.创建 Access Token

点击头像 -> settings -> Access Token

复制这个令牌保存起来，作为之后的访问 gitlab 的令牌

5.jenkins 配置 gitlab 登录

系统管理 -> 系统设置 -> gitlab

添加登录凭据，api token 就是在 gitlab 创建的 Access Token

测试连接是否成功，成功之后点击保存即可

6.git plugins 配置

系统管理 -> 系统设置 -> git plugin 配置姓名和邮箱

7.新建任务

首页 -> 新建任务 -> 构建一个 maven 项目

在源码管理中选择 Git，复制仓库的 ssh 连接地址，此时提示无法连接仓库，点击添加

类型选择 SSH Username with private key，Username 填 root，PrivateKey 选择Enter directly，点击add 登录到 jenkins 服务器查看私钥，挂载了 .ssh目录出来，在 ssh 下，查看 id_rsa 的文件内容

cat ssh/id_rsa

将私钥内容复制的网页上面，点击添加

在“credentials”里选择我们刚刚创建的认证方式：root

kins job默认对master分支进行构建，也可以自定义分支。

配置 Job 的构建触发器

选择“构建触发器”，勾选“Pull SCM”，这个选项会每隔一段时间检查一下GitLab仓库中代码是否有更新，有的话就执行构建操作。日程表如何设置，在这个输入框下面有说明，轮询的时间还可以再缩短一点，比如 10s、半分钟、一分钟之类的

常见构建触发器：

Build after other projects are built 当另一个构建任务完成之后触发
Build periodically 周期性的触发
Build when a change is pushed to GitLab. GitLab CI Service 当代码有更新的时候触发，通过GitLab CI
GitHub hook trigger for GITScm polling 通过Github钩子触发
Poll SCM 定期检查代码有无更新，在更新时间触发

配置 maven 的 pom 文件位置

我这里是多模块的项目，配置父模块 pom 文件所在位置

构建后执行远程shell命令

选择ssh服务，配置执行的编排命令

我这里的项目是多模块的工程，然后每个子模块集成了 docker-maven 插件，会将每个服务的 jar 打包成镜像推送到服务器，在服务中编写对应的 docker-compose.yml 文件编排每个项目的容器，所以我这里在 jenkins 调用 maven 打包好项目之后，使用 ssh 连接服务器切换到对应的目录执行编排命令，即可启动服务，不同的部署方式可灵活变通，这里只是演示本项目所使用的一种方式。

# 登录服务器，执行docker-compose编排命令
cd /data/docker/farmland-chief-server
docker-compose stop
docker-compose rm -f
docker-compose up -d
docker rmi $(docker images | grep "none" | awk '{print $3}')

由于是父模块 pom 进行打包的，子模块要依据父模块 pom 的位置配置 dockerfile 所在的位置