任何简单操作的背后,都有一套相当复杂的机制。本文将以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/
![619f656892c5d2d95e4fc770d4624b29.png](https://i-blog.csdnimg.cn/blog_migrate/9a057cec66dfba731206d6708ad142a7.jpeg)
- 使用管理员密码进行登录,可以使用以下命令从容器启动日志中获取管理密码:
docker logs jenkins
- 从日志中获取管理员密码:
![6cb741d6812b01a513cda76e00bf4f0b.png](https://i-blog.csdnimg.cn/blog_migrate/c67e38c68bb355c522ce1df41b1517d4.png)
- 选择安装插件方式,这里我们直接安装推荐的插件:
![80c9201138584beb3afb96e2db9d04ab.png](https://i-blog.csdnimg.cn/blog_migrate/d28e6bdaeb2fed20207021fb92454403.jpeg)
- 进入插件安装界面,联网等待插件安装:
![97ef1ccedc789eaba3a90ddbc8c81ee3.png](https://i-blog.csdnimg.cn/blog_migrate/d410192a1f386cad1adc568008385bb6.jpeg)
- 安装完成后,创建管理员账号:
![7c26808dbd17fed298a248a76ac15b72.png](https://i-blog.csdnimg.cn/blog_migrate/d140ded7108bf5e5f578a63fcf78ea00.jpeg)
- 进行实例配置,配置Jenkins的URL:
![1c28e727320dd33c12f8a4344a848572.png](https://i-blog.csdnimg.cn/blog_migrate/e016b2e2dba4194754238c3add6f1193.jpeg)
- 点击系统管理->插件管理,进行一些自定义的插件安装:
![dfb304fd4e260a85beacd94100d6f8f8.png](https://i-blog.csdnimg.cn/blog_migrate/0647869e4f1b62d8605a62ad230a6b55.jpeg)
确保以下插件被正确安装:
- 根据角色管理权限的插件:Role-based Authorization Strategy
- 远程使用ssh的插件:SSH plugin
通过系统管理->全局工具配置来进行全局工具的配置,比如maven的配置:
![d5deb9949ae190c5eb5346f0e3045b57.png](https://i-blog.csdnimg.cn/blog_migrate/c64ef828b52bc2785c116d062f309f51.jpeg)
- 新增maven的安装配置:
![7f1b154f4de588cc75041094c97d6ef7.png](https://i-blog.csdnimg.cn/blog_migrate/233960fa0a80306c93a314954250d319.png)
- 在系统管理->系统配置中添加全局ssh的配置,这样Jenkins使用ssh就可以执行远程的linux脚本了:
![913777bdc006bb7fbb5b1dfcbbf3dbe8.png](https://i-blog.csdnimg.cn/blog_migrate/99531a9c5f43bc0699c725fd71f56087.png)
角色权限管理
我们可以使用Jenkins的角色管理插件来管理Jenkins的用户,比如我们可以给管理员赋予所有权限,运维人员赋予执行任务的相关权限,其他人员只赋予查看权限。
- 在系统管理->全局安全配置中启用基于角色的权限管理:
![cea96e75c330790e004d5204fa60ca69.png](https://i-blog.csdnimg.cn/blog_migrate/a4c436fcfa7243b0910716c55a1a3a02.png)
- 进入系统管理->Manage and Assign Roles界面:
![8778fda02a2dc0e6567e8ea0958094a0.png](https://i-blog.csdnimg.cn/blog_migrate/4d567bd3ba3f94918b5a02acb6668011.jpeg)
- 添加角色与权限的关系:
![61be3c44572e1375f5e0ce168cdde607.png](https://i-blog.csdnimg.cn/blog_migrate/7e89e13d72bf69c5ba7535135c5553c0.png)
- 给用户分配角色:
![a70ad0dcc9c525be9827c626a139588b.png](https://i-blog.csdnimg.cn/blog_migrate/eb685fe5d9c89a0e4fbea134fa0ad74b.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中的展示效果如下:
![a30d2b9d288fdf148f4aea6a331eedfd.png](https://i-blog.csdnimg.cn/blog_migrate/f0a030741cc8ffb1d021c35ca4476872.jpeg)
- 有一点需要
注意
,要将pom.xml中的dockerHost地址改成你自己的Docker镜像仓库地址:
![6de1e73bd2e1481f56274c50c94e0eb3.png](https://i-blog.csdnimg.cn/blog_migrate/ec81f7f93ffb06f3d6f87e2b6198ed0c.jpeg)
执行脚本准备
- 将
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中创建执行任务
- 首先我们需要新建一个任务:
![2243007d93d2c6bbe07a924ca5aba671.png](https://i-blog.csdnimg.cn/blog_migrate/59057e50586dcc6bbde583817610624c.jpeg)
- 设置任务名称后选择构建一个自由风格的软件项目:
![e00643398fb1199af37525d4fad82328.png](https://i-blog.csdnimg.cn/blog_migrate/b0e08fe503bb9f8d87186bc1279006f0.jpeg)
- 然后在源码管理中添加我们的git仓库地址:http://192.168.6.132:1080/macrozheng/mall-tiny-jenkins
![38cb9c36b1a6047d276c2e888c8ddbc1.png](https://i-blog.csdnimg.cn/blog_migrate/82aa3395b655133a0435caa3873488ad.jpeg)
- 此时需要添加一个凭据,也就是我们git仓库的账号密码:
![cf043decb48af42f485b8c573e765e69.png](https://i-blog.csdnimg.cn/blog_migrate/cb73c60bb69731071bd5ecac0a527fc6.png)
- 填写完成后选择该凭据,就可以正常连接git仓库了;
![dc5948c34f8a794fb2bb15a932116d21.png](https://i-blog.csdnimg.cn/blog_migrate/d5623a49b380e07c7ba7bc86fc7f0ef6.jpeg)
- 之后我们需要添加一个构建,选择调用顶层maven目标,该构建主要用于把我们的源码打包成Docker镜像并上传到我们的Docker镜像仓库去:
![37d9ea8d9f0449f1e85a5f71a59a2e82.png](https://i-blog.csdnimg.cn/blog_migrate/9a66deb5eab789ea949cb95d85b1493b.png)
- 选择我们的maven版本,然后设置maven命令和指定pom文件位置:
![56fe65da2d4af28dec400c83e4f4ea74.png](https://i-blog.csdnimg.cn/blog_migrate/4482978a157fa6155b18c2784c3ac848.png)
- 之后添加一个执行远程shell脚本的构建,用于在我们的镜像打包完成后执行启动Docker容器的.sh脚本:
![2b13b7f1ec6f3305462ee96a22bb4171.png](https://i-blog.csdnimg.cn/blog_migrate/ce960e07aeefdb4965a02579f874bfc8.png)
- 需要设置执行的shell命令如下:/mydata/sh/mall-tiny-jenkins.sh
![56bbb150adfd74e01628f9bff8273cdf.png](https://i-blog.csdnimg.cn/blog_migrate/8338f6c67f40d7dac369bd67b19da87f.png)
- 之后点击保存操作,我们的任务就创建完成了,在任务列表中我们可以点击运行来执行该任务;
![86269f74365a91dd96ae1f78b3235c9e.png](https://i-blog.csdnimg.cn/blog_migrate/0bb324be41de8213be43d82b16bf4f68.jpeg)
- 我们可以通过控制台输出来查看整个任务的执行过程:
![6976e0af2eca84b31f0774472369e568.png](https://i-blog.csdnimg.cn/blog_migrate/ee9cd6f68cce262bcef76a94dfb7eb36.png)
- 运行成功后,访问该地址即可查看API文档:http://192.168.6.132:8088/swagger-ui.html
![4a8364ed2a1f7e27cc039a2ba778d15e.png](https://i-blog.csdnimg.cn/blog_migrate/927084ddd02bb29a72914a2ff222b153.png)
项目源码地址
https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-jenkins
推荐阅读
- 终于可以携号转网,三大运营商做了10年,技术难点到底在哪?
- “菜鸟”程序员 VS “大神”程序员,我差点吓出了翔。。。
- 仅需四步,整合SpringSecurity+JWT实现登录认证 !
- 看完这篇还不了解Nginx,那我就哭了!
- Nginx的这些妙用,你肯定有不知道的!
- Github标星25K+Star,SpringBoot实战电商项目mall出SpringCloud版本啦!
- 在Docker容器中部署整套基于Spring Cloud的微服务架构,看这篇就对了!
- “失败”的北漂十年,我真的尽力了。。。
- 涵盖大部分核心组件使用的 Spring Cloud 教程,一定要收藏哦!
- 我的Github开源项目,从0到20000 Star!
欢迎关注,点个在看