我们知道Spring Boot使用了内嵌容器,因此它的部署方式也变得非常简单灵活,一方面可以将Spring Boot项目打包成独立的jar或者war包来运行,也可以单独打包成war包部署到Tomcat容器中运行,如果涉及到大规模的部署Jinkins成为最佳选择之一。
接下来,开始介绍Spring Boot项目是如何打包、发布的。
一、项目打包
现在Maven、Gradle已经成了我们日常开发必不可少的构建工具,使用这些工具很容易地将项目打包成jar或者war包。下面就以Maven项目为例演示Spring Boot项目如何打包发布。
1. 生成jar包
Maven默认会将项目打成jar包,也可以在pom.xml文件中指定打包方式。配置示例如下:
<groupId>com.weiz</groupId> <artifactId>spring-boot-package</artifactId> <version>1.0.0</version> <name>spring-boot-package</name> <!--指定打包方式--> <packaging>jar</packaging>
上面的示例中,使用packaging标签知道打包方式,版本号为1.0.0。Maven打包会根据pom包中的packaging配置来决定是生成jar包或者war包。
然后,在项目根目录下,在控制台执行如下命令:
mvn clean package -Dmaven.test.skip=true
(1)mvn clean package其实是两条命令,mvn clean是清除项目target目录下的文件,mvn package打包命令。两个命令可以一起执行。
(2)-Dmaven.test.skip=true:排除测试代码后进行打包。
命令执行完成后,jar包会生成到target目录下,命名一般是“项目名+版本号.jar”的形式。如下图所示。
2. 生成war包
Spring Boot项目既可以生成war发布,也可以生成jar包发布。那么他们有什么区别呢?
- jar包:通过内置tomcat运行,不需要额外安装tomcat。如需修改内置tomcat的配置,只需要在spring boot的配置文件中配置。内置tomcat没有自己的日志输出,全靠jar包应用输出日志。但是部署简单方便,适合快速部署。
- war包:传统的应用交付方式,需要安装tomcat,然后将war包放到waeapps目录下运行,这样可以灵活选择tomcat版本,也可以直接修改tomcat的配置,同时有自己的tomcat日志输出,可以灵活配置安全策略。相对jar包来说没那么快速方便。
Spring Boot生成war包的方式和生成jar包的方式基本一样。只需要添加一些额外的配置,下面演示生成war包的方式:
步骤1:修改项目中的pom.xml文件
将<packaging>jar</packaging>改为<packaging>war</packaging>。示例代码如下:
<groupId>com.weiz</groupId> <artifactId>spring-boot-package</artifactId> <version>1.0.0</version> <name>spring-boot-package</name> <!--指定打包方式--> <packaging>war</packaging>
上面的示例中,修改packaging标签,将jar包的形式改成了war包的形式,版本号为1.0.0。
步骤2:排除Tomcat
部署war包在Tomcat中运行,并不需要Spring Boot自带的Tomcat组件,所以需要在pom.xml文件中排除自带的Tomcat。示例代码如下:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency>
上面的示例中,将Tomcat组件的scope属性设置为provided,这样在打包产生的war中就不会包含Tomcat相关的jar。
步骤3:注册启动类
在项目的启动类中继承SpringBootServletInitializer并重写configure( )方法,示例代码如下所示:
@SpringBootApplication public class PackageApplication extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(PackageApplication.class); } public static void main(String[] args) { SpringApplication.run(PackageApplication.class, args); } }
步骤4:生成war包
生成war包的命令与jar包的方式是一样的,具体命令如下:
mvn clean package -Dmaven.test.skip=true
执行完成后,会在target目录下生成:项目名+版本号.war文件,将打包好的war包复制到Tomcat服务器中webapps目录下启动即可。
二、运行部署
以往我们开发部Web项目时非常繁琐,而使用Spring Boot开发部署一个命令就能解决,不需要再关注容器的环境问题,专心写业务代码即可。
Spring Boot内嵌的内置Tomcat、Jetty等容器对项目部署带来了更多的改变,在服务器上仅仅需要几条命令即可部署项目。一般开发环境直接java -jar命令启动,正式环境需要将程序部署成服务。下面开始演示Spring Boot项目是如何运行、部署的。
1. 启动运行
简单就是直接启动jar包。启动jar包命令如下:
java -jar spring-boot-package-1.0.0.jar
这种方式是前台运行的,只要将控制台关闭,服务就会停止。实际生产中我们肯定不会前台运行,一般使用后台运行的方式来启动。
nohup java -jar spring-boot-package-1.0.0.jar &
上面的示例中,使用nohup java –jar xxx.jar &命令让程序以后台运行的方式执行。日志会被重定向到nohup.out文件中。也可以用“>filename 2>&1”来更改缺省的重定向文件名。命令如下:
nohup java -jar spring-boot-package-1.0.0.jar >spring.log 2>&1 &
上面的示例中,使用“>spring.log 2>&1”参数将系统的运行日志保存到spring.log中。
以上就是简单的启动jar包的方式,使用简单。
Spring Boot支持在启动时添加定制,比如设置应用的堆内存、垃圾回收机制、日志路径等。
(1)设置jvm参数
通过设置jvm的参数,优化程序的性能。
java -Xms10m -Xmx80m -jar spring-boot-package-1.0.0.jar
(2)选择运行环境
在配置多运行环境一节中,介绍了如何配置多运行环境。那么在启动项目时,选择对应的启动环境即可:
java -jar spring-boot-package-1.0.0.jar --spring.profiles.active=dev
一般项目打包时指定默认的运行环境,在启动运行时也可以再次设置运行的环境。
2. 生产环境部署
上一节介绍的运行方式比较传统和简单的,实际生产环境中考虑到后期的运维,建议大家使用服务的方式来部署。
下面通过示例演示Spring Boot项目配置成系统服务。
步骤1:将之前的jar包spring-boot-package-1.0.0.jar复制到/usr/local/目录下。
步骤2:进入服务文件目录,命令如下:
cd /etc/systemd/system/
步骤3:使用vim springbootpackage.service创建服务文件,示例代码如下:
[Unit] Description=springbootpackage After=syslog.target [Service] ExecStart=/usr/java/jdk1.8.0_221-amd64/bin/java -Xmx4096m -Xms4096m -Xmn1536m -jar /usr/local/spring-boot-package-1.0.0.jar [Install] WantedBy=multi-user.target
上面的示例中,主要是定义服务的名字,以及启动的命令和参数。使用只要修改Description和ExecStart即可。
步骤4:启动服务
// 启动服务 systemctl start springbootpackage // 停止服务 systemctl stop springbootpackage // 查看服务状态 systemctl status springbootpackage // 查看服务日志 journalctl -u springbootpackage
上面的命令,通过systemctl start|stop|status springbootpackage命令启动、停止创建的springbootpackage服务。
如上图所示就是使用systemctl status springbootpackage命令查看服务状态,同时还可以通过journalctl -u springbootpackage命令查看服务完整日志。
此外,还需要设置服务开机启动,使用如下命令:
// 开机启动 systemctl enable springbootpackage
以上是打包成独立的jar包部署到服务器。如果是部署到Tomcat中,就按照Tomcat的相关命令来重新启动。
最后
以上,我们就把Spring Boot项目的打包和部署的方式题介绍完了。