任何简单操作的背后,都有一套相当复杂的机制。本文将以SpringBoot应用的在Docker环境下的打包部署为例,详细讲解如何使用Jenkins一键打包部署SpringBoot应用。
Jenkins简介
Jenkins是开源CI&CD软件领导者,提供超过1000个插件来支持构建、部署、自动化,满足任何项目的需要。我们可以用Jenkins来构建和部署我们的项目,比如说从我们的代码仓库获取代码,然后将我们的代码打包成可执行的文件,之后通过远程的ssh工具执行脚本来运行我们的项目。
Jenkins的安装及配置
Docker环境下的安装
下载Jenkins的Docker镜像:
docker pull jenkins/jenkins:lts
在Docker容器中运行Jenkins:
docker run -p 8080:8080 -p 50000:5000 --name jenkins \
-u root \
-v /mydata/jenkins_home:/var/jenkins_home \
-d jenkins/jenkins:lts
Jenkins的配置
运行成功后访问该地址登录Jenkins,第一次登录需要输入管理员密码:http://192.168.6.132:8080/
![](https://i-blog.csdnimg.cn/blog_migrate/8a27fd1a7308ad28e13c855bcee73a4a.png)
使用管理员密码进行登录,可以使用以下命令从容器启动日志中获取管理密码:
docker logs jenkins
从日志中获取管理员密码:
![](https://i-blog.csdnimg.cn/blog_migrate/21334ecd02a6e7962a69894859959622.png)
选择安装插件方式,这里我们直接安装推荐的插件:
![](https://i-blog.csdnimg.cn/blog_migrate/a2cb74ee8904dfd445e31e385b1943b0.png)
进入插件安装界面,联网等待插件安装:
![](https://i-blog.csdnimg.cn/blog_migrate/7ac40207234730bcbc4f954d679db7a8.png)
安装完成后,创建管理员账号:
![](https://i-blog.csdnimg.cn/blog_migrate/ab416fd4aa668701ab852a5be4b315fe.png)
进行实例配置,配置Jenkins的URL:
![](https://i-blog.csdnimg.cn/blog_migrate/7b8260c90ba44f1ed0227d6ee87731c6.png)
点击系统管理->插件管理,进行一些自定义的插件安装:
![](https://i-blog.csdnimg.cn/blog_migrate/92350bbd0c295473376c62093aa05564.png)
确保以下插件被正确安装:
根据角色管理权限的插件:Role-based Authorization Strategy
远程使用ssh的插件:SSH plugin
通过系统管理->全局工具配置来进行全局工具的配置,比如maven的配置:
![](https://i-blog.csdnimg.cn/blog_migrate/d2d8edac2e358c99375ca889e3072654.png)
新增maven的安装配置:
![](https://i-blog.csdnimg.cn/blog_migrate/dfed47bfb2e7a30eeb28bf5468a676ad.png)
在系统管理->系统配置中添加全局ssh的配置,这样Jenkins使用ssh就可以执行远程的linux脚本了:
![](https://i-blog.csdnimg.cn/blog_migrate/2d0b65fb1363cef5a1059e932d3f5298.png)
角色权限管理
我们可以使用Jenkins的角色管理插件来管理Jenkins的用户,比如我们可以给管理员赋予所有权限,运维人员赋予执行任务的相关权限,其他人员只赋予查看权限。
在系统管理->全局安全配置中启用基于角色的权限管理:
![](https://i-blog.csdnimg.cn/blog_migrate/6492c9634eeebabaef340314f7a7be85.png)
进入系统管理->Manage and Assign Roles界面:
![](https://i-blog.csdnimg.cn/blog_migrate/cba0faaee2f0c2081211d229c0895579.png)
添加角色与权限的关系:
![](https://i-blog.csdnimg.cn/blog_migrate/b8a5b42adc897d0137266a5456afec58.png)
给用户分配角色:
![](https://i-blog.csdnimg.cn/blog_migrate/e352426ee014facac4fcfef0b13fb3bd.png)
打包部署SpringBoot应用
这里我们使用
mall-learning
项目中的mall-tiny-jenkins
模块代码来演示下如何使Jenkins一键打包部署SpringBoot应用。
将代码上传到Git仓库
首先我们需要安装Gitlab(当然你也可以使用Github或者Gitee),然后将
mall-tiny-jenkins
中的代码上传到Gitlab中去,Gitlab的使用请参考:10分钟搭建自己的Git仓库mall-tiny-jenkins
项目源码地址:https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-jenkins上传完成后Gitlab中的展示效果如下:
![](https://i-blog.csdnimg.cn/blog_migrate/c6208addb011a10fb58677461ef3bcad.png)
有一点需要
注意
,要将pom.xml中的dockerHost地址改成你自己的Docker镜像仓库地址:
![](https://i-blog.csdnimg.cn/blog_migrate/8dcbc4a3c6af8f621339f9945bc774a8.png)
执行脚本准备
将
mall-tiny-jenkins.sh
脚本文件上传到/mydata/sh
目录下,脚本内容如下:
#!/usr/bin/env bash
app_name='mall-tiny-jenkins'
docker stop ${app_name}
echo '----stop container----'
docker rm ${app_name}
echo '----rm container----'
docker run -p 8088:8088 --name ${app_name} \
--link mysql:db \
-v /etc/localtime:/etc/localtime \
-v /mydata/app/${app_name}/logs:/var/logs \
-d mall-tiny/${app_name}:1.0-SNAPSHOT
echo '----start container----'
给.sh脚本添加可执行权限:
chmod +x ./mall-tiny-jenkins.sh
windows下的.sh脚本上传到linux上使用,需要修改文件格式,否则会因为有特殊格式存在而无法执行:
#使用vim编辑器来修改
vi mall-tiny-jenkins.sh
# 查看文件格式,windows上传上来的默认为dos
:set ff
#修改文件格式为unix
:set ff=unix
#保存并退出
:wq
执行.sh脚本,测试使用,可以不执行:
./mall-tiny-jenkins.sh
在Jenkins中创建执行任务
首先我们需要新建一个任务:
![](https://i-blog.csdnimg.cn/blog_migrate/b177f39743d21418a6e843294847210e.png)
设置任务名称后选择构建一个自由风格的软件项目:
![](https://i-blog.csdnimg.cn/blog_migrate/bf117090ab041d02163fa180b8fa60cb.png)
然后在源码管理中添加我们的git仓库地址:http://192.168.6.132:1080/macrozheng/mall-tiny-jenkins
![](https://i-blog.csdnimg.cn/blog_migrate/aea5dfcf1a69c66fab9bf4a5fba0f59a.png)
此时需要添加一个凭据,也就是我们git仓库的账号密码:
![](https://i-blog.csdnimg.cn/blog_migrate/fe9a46689be16a40dd0d09dcd144d308.png)
填写完成后选择该凭据,就可以正常连接git仓库了;
![](https://i-blog.csdnimg.cn/blog_migrate/e09aed0a9a7b92571d9fe61eeb08e11a.png)
之后我们需要添加一个构建,选择调用顶层maven目标,该构建主要用于把我们的源码打包成Docker镜像并上传到我们的Docker镜像仓库去:
![](https://i-blog.csdnimg.cn/blog_migrate/edb28b2de178b003fce99abf99cb6046.png)
选择我们的maven版本,然后设置maven命令和指定pom文件位置:
![](https://i-blog.csdnimg.cn/blog_migrate/c4bc7e95b5667c81e0ce749b3210b453.png)
之后添加一个执行远程shell脚本的构建,用于在我们的镜像打包完成后执行启动Docker容器的.sh脚本:
![](https://i-blog.csdnimg.cn/blog_migrate/9e95db69b7498c89cf615c2dcc1ee18c.png)
需要设置执行的shell命令如下:/mydata/sh/mall-tiny-jenkins.sh
![](https://i-blog.csdnimg.cn/blog_migrate/9c08384d4790032ceef799af5dd9fb0e.png)
之后点击保存操作,我们的任务就创建完成了,在任务列表中我们可以点击运行来执行该任务;
![](https://i-blog.csdnimg.cn/blog_migrate/fdc119d6093a402077e559f8567209c4.png)
我们可以通过控制台输出来查看整个任务的执行过程:
![](https://i-blog.csdnimg.cn/blog_migrate/2b0cc769dc0034435f48e03441ffd0ac.png)
运行成功后,访问该地址即可查看API文档:http://192.168.6.132:8088/swagger-ui.html
![](https://i-blog.csdnimg.cn/blog_migrate/dc113c639110f8e3c710c3c350938b63.png)
项目源码地址
https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-jenkins
推荐阅读
欢迎关注,点个在看