注意:本文基于Java 11环境下的配置。现在大多数都运行在Java 8上,而当前Jenkins主推的也是Java 8,即便如此Jenkins官方也提供了如何在Java 11上运行:
Java11上运行Jenkins
一、运行并配置Jenkins
- 运行命令:
docker run -d --restart=always -p 8080:8080 -v jenkins-home:/var/jenkins_home -v /usr/local/apache-maven-3.6.3:/usr/local/maven -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker --name jenkins jenkins/jenkins:jdk11
- 参数说明
-v /usr/local/apache-maven-3.6.3:/usr/local/maven
注意上述命令中的maven配置,表示与宿主机的maven进行挂载,这样我们就可以用本地的maven来构建项目了。此配置根据个人情况设置。
-v /var/run/docker.sock:/var/run/docker.sock
和-v $(which docker):/usr/bin/docker
将jenkins容器内的docker命令指向了宿主机,否则在Jenkins中执行Shell脚本调用docker命令时无法执行。
jenkins/jenkins:jdk11
表示基于Java 11环境下运行Jenkins,而当前Jenkins官方默认基于Java 8的。
二、部署Spring Boot
1. 配置全局Maven的配置文件
此举主要是为了加快Maven在拉取依赖时的速度,这里采用阿里云的镜像。
按照步骤打开配置页面:系统管理 -> 管理文件(Managed files) -> 添加新的配置(Add a new Config)。
在这里为了方便起见,以及后续所有的配置都使用全局配置,我选择“Global Maven settings.xml”,并做如下设置提交即可。
2. 配置构建环境
配置Maven
参数说明:
clean package -pl quickpick-dispatch -am
由于我的是多模块项目,各个模块直接存在层级关系,因此为了构建对应的模块必须增加-pl
参数以指定,同时增加-am
参数以打包当前模块所依赖的模块,这样此模块打包后就是一个完整的jar包了。
填写Shell脚本
需要注意的是,由于Jenkins是运行在Docker中,部署的Spring Boot项目也是在Docker中,而上述Shell脚本需要使用Docker
命令来执行,因此我们在使用Docker运行Jenkins的时候必须配置-v /var/run/docker.sock:/var/run/docker.sock
和-v $(which docker):/usr/bin/docker
,否则上述的Shell脚本无法正常执行。
3. 开始部署
启动部署后可以在控制台看到如下信息,此信息说明我们在上面配置的全局Maven生效了。
紧接着可以看到依赖也是从阿里云
上下载的。
当所有依赖下载完成,项目打包完成之后,开始执行步骤2中配置的Shell脚本了。
从图上可知,Spring Boot项目被下载到这个目录,并且Maven打包的jar包也在此目录下。但需要注意的是,此目录并非磁盘中真实的目录,而是Docker内部的目录,真正的目录在这里:
上图中的Dockerfile
文件也会在Shell脚本中使用到。由于本项目是基于Java 11
来运行的,因此我的Dockerfile文件内容如下:
FROM openjdk:11.0
ADD target/*.jar target/quickpick-dispatch.jar
EXPOSE 10001
ENTRYPOINT ["java", "-jar", "target/quickpick-dispatch.jar"]
最后控制台输出以下内容,至此Spring Boot项目构建并运行成功。
其它
如果需要把打包后的文件发送到其它服务器,则需要安装插件Publish Over SSH
,然后做相应的配置即可。