之前对mall-swarm项目做了升级,注册中心和配置中心都改为使用Nacos,但是Jenkins的自动化部署文档一直都没更新。有些朋友参考原来的文档部署有点小问题,这次对mall-swarm的自动化部署文档做个升级,希望对大家有所帮助!

部署准备

部署之前需要先安装mall-swarm需要的依赖服务,并打包好所有应用的Docker镜像。由于之前已经写过相关教程,这里只提示下关键的步骤,具体可以参考《mall-swarm在Linux环境下的部署(基于Docker容器)》,文档地址:http://www.macrozheng.com/#/deploy/mall_swarm_deploy_docker 。

需要安装好项目所需的依赖服务,直接使用Docker Compose安装即可,具体服务和版本信息如下;




jenkins 微服务 流水线_Docker


打包好所有SpringBoot应用的Docker镜像,具体应用服务信息如下;


jenkins 微服务 流水线_jenkins 微服务 流水线_02


将应用所有配置添加到Nacos注册中心中去,具体配置文件如下。


jenkins 微服务 流水线_Docker_03


执行脚本准备

Jenkins自动化部署是需要依赖Linux执行脚本的,我们先把需要执行的脚本准备好。

  • 脚本文件都存放在了mall-swarm项目的/document/sh目录下:


jenkins 微服务 流水线_Jenkins_04


上传脚本前在IDEA中修改所有脚本文件的换行符格式为LF,否则脚本会无法执行;


jenkins 微服务 流水线_Jenkins_05


将所有脚本文件上传到指定目录,这里我们上传到/mydata/sh目录下;


jenkins 微服务 流水线_Jenkins_06


将所有脚本文件都修改为可执行文件:

chmod +x ./mall-*


jenkins 微服务 流水线_Jenkins_07


Jenkins中创建任务

接下来我们将通过在Jenkins中创建任务来实现自动化部署。由于我们的mall-swarm是个多模块的项目,部署上面和曾经的单模块项目还是有所区别的。

mall-admin

由于各个模块执行任务的创建都大同小异,下面将详细讲解mall-admin模块任务的创建,其他模块将简略讲解。

  • 首先我们选择构建一个自由风格的软件项目,然后输入任务名称为mall-admin,配置其Git仓库地址,这里我直接使用了Gitee上面的地址:


jenkins 微服务 流水线_Docker_08


  • 之后我们创建一个构建,构建mall-swarm项目中的依赖模块,否则当构建可运行的服务模块时会因为无法找到这些模块而构建失败;
# 只install mall-common,mall-mbg两个模块clean install -pl mall-common,mall-mbg -am
  • 依赖模块构建示意图:


jenkins 微服务 流水线_Docker_09


再创建一个构建,单独构建并打包mall-admin模块:


jenkins 微服务 流水线_Docker_10


再创建一个构建,通过SSH去执行sh脚本,这里执行的是mall-admin的运行脚本:


jenkins 微服务 流水线_Docker_11


  • 点击保存,完成mall-admin的执行任务创建。

mall-gateway

mall-gateway和其他模块与mall-admin的创建任务方式基本一致,只需修改构建模块时的pom.xml文件位置和执行脚本位置即可。

  • 我们可以直接从mall-admin模块的任务复制一个过来创建:


jenkins 微服务 流水线_jenkins 微服务 流水线_12


修改第二个构建中的pom.xml文件位置,改为:${WORKSPACE}/mall-gateway/pom.xml


jenkins 微服务 流水线_Jenkins_13


修改第三个构建中的SSH执行脚本文件位置,改为:/mydata/sh/mall-gateway.sh


jenkins 微服务 流水线_自动化部署_14


  • 点击保存,完成mall-gateway的执行任务创建。

其他模块

其他模块的执行任务创建,参考mall-admin和mall-gateway的创建即可。

任务创建完成


jenkins 微服务 流水线_自动化部署_15


Docker网络问题

如果之前使用的是Docker Compose启动所有依赖服务,会默认创建一个网络,所有的依赖服务都会在此网络之中,不同网络内的服务无法互相访问。我这里创建的网络是deploy_default,所以需要指定sh脚本中服务运行的的网络,否则启动的应用服务会无法连接到依赖服务。

  • 可以使用docker inspect mysql命令来查看mysql服务所在的网络;


jenkins 微服务 流水线_jenkins 微服务 流水线_16


也可以通过docker network ls来查看所有网络;


jenkins 微服务 流水线_自动化部署_17


修改所有sh脚本,修改服务运行的网络,添加一行--network deploy_default 即可。


jenkins 微服务 流水线_jenkins 微服务 流水线_18


模块启动顺序问题

由于作为注册中心和配置中心的Nacos已经启动了,其他模块基本没有启动顺序的限制,但是最好还是按照下面的顺序启动。

推荐启动顺序:

  • mall-auth
  • mall-gateway
  • mall-monitor
  • mall-admin
  • mall-portal
  • mall-search

运行完成效果展示

  • 查看API文档信息,访问地址:http://192.168.3.101:8201/doc.html


jenkins 微服务 流水线_自动化部署_19


查看注册中心注册服务信息,访问地址:http://192.168.3.101:8848/nacos/


jenkins 微服务 流水线_Jenkins_20


监控中心应用信息,访问地址:http://192.168.3.101:8101


jenkins 微服务 流水线_jenkins 微服务 流水线_21


jenkins 微服务 流水线_Jenkins_22


jenkins 微服务 流水线_Docker_23


日志收集系统信息,访问地址:http://192.168.3.101:5601


jenkins 微服务 流水线_jenkins 微服务 流水线_24


总结

我们通过在Jenkins中创建任务,完成了mall-swarm项目的自动化部署工作,这样当我们每次修改完代码后,只需点击启动任务,就可以实现一键打包部署,省去了频繁打包部署的麻烦。

项目地址