SpringBoot从入门到精通(三十一)Spring Boot项目打包、发布与部署

简介: 我们知道Spring Boot使用了内嵌容器,因此它的部署方式也变得非常简单灵活,一方面可以将Spring Boot项目打包成独立的jar或者war包来运行,也可以单独打包成war包部署到Tomcat容器中运行,如果涉及到大规模的部署Jinkins成为最佳选择之一。接下来,开始介绍Spring Boot项目是如何打包、发布的。

我们知道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”的形式。如下图所示。

image.png


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目录下启动即可。

image.png


二、运行部署

以往我们开发部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服务。

image.png

如上图所示就是使用systemctl status springbootpackage命令查看服务状态,同时还可以通过journalctl -u springbootpackage命令查看服务完整日志。


此外,还需要设置服务开机启动,使用如下命令:

// 开机启动
systemctl enable springbootpackage

以上是打包成独立的jar包部署到服务器。如果是部署到Tomcat中,就按照Tomcat的相关命令来重新启动。


最后

以上,我们就把Spring Boot项目的打包和部署的方式题介绍完了。



推荐阅读:

SpringBoot从入门到精通(三十)如何使用JdbcTemplate操作数据库?

SpringBoot从入门到精通(二十九)使用Redis实现分布式Session共享

SpringBoot从入门到精通(二十八)JPA 的实体映射关系,一对一,一对多,多对多关系映射!

SpringBoot从入门到精通(二十七)JPA实现自定义查询,完全不需要写SQL!

SpringBoot从入门到精通(二十六)超级简单的数据持久化框架!Spring Data JPA 的使用!

SpringBoot从入门到精通(二十五)搞懂自定义系统配置

SpringBoot从入门到精通(二十四)3分钟搞定Spring Boot 多环境配置!

SpringBoot从入门到精通(二十三)Mybatis系列之——实现Mybatis多数据源配置

SpringBoot从入门到精通(二十二)使用Swagger2优雅构建 RESTful API文档

相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
27天前
|
Java 应用服务中间件 Maven
SpringBoot 项目瘦身指南
SpringBoot 项目瘦身指南
41 0
|
1月前
|
Java 测试技术 数据库
SpringBoot:@Profile注解和Spring EL
SpringBoot:@Profile注解和Spring EL
|
1月前
|
存储 安全 Java
Spring Boot整合Spring Security--学习笔记
Spring Boot整合Spring Security--学习笔记
53 0
|
1月前
|
消息中间件 Cloud Native Java
【Spring云原生系列】SpringBoot+Spring Cloud Stream:消息驱动架构(MDA)解析,实现异步处理与解耦合
【Spring云原生系列】SpringBoot+Spring Cloud Stream:消息驱动架构(MDA)解析,实现异步处理与解耦合
|
1月前
|
人工智能 JSON 前端开发
【Spring boot实战】Springboot+对话ai模型整体框架+高并发线程机制处理优化+提示词工程效果展示(按照框架自己修改可对接市面上百分之99的模型)
【Spring boot实战】Springboot+对话ai模型整体框架+高并发线程机制处理优化+提示词工程效果展示(按照框架自己修改可对接市面上百分之99的模型)
|
17天前
|
安全 数据安全/隐私保护
Springboot+Spring security +jwt认证+动态授权
Springboot+Spring security +jwt认证+动态授权
|
1月前
|
消息中间件 JSON Java
Spring Boot、Spring Cloud与Spring Cloud Alibaba版本对应关系
Spring Boot、Spring Cloud与Spring Cloud Alibaba版本对应关系
523 0
|
1天前
|
Java Nacos 开发者
Java从入门到精通:4.2.1学习新技术与框架——以Spring Boot和Spring Cloud Alibaba为例
Java从入门到精通:4.2.1学习新技术与框架——以Spring Boot和Spring Cloud Alibaba为例
|
1天前
|
Dubbo Java 应用服务中间件
Java从入门到精通:3.2.2分布式与并发编程——了解分布式系统的基本概念,学习使用Dubbo、Spring Cloud等分布式框架
Java从入门到精通:3.2.2分布式与并发编程——了解分布式系统的基本概念,学习使用Dubbo、Spring Cloud等分布式框架
|
7天前
|
安全 Java 应用服务中间件
江帅帅:Spring Boot 底层级探索系列 03 - 简单配置
江帅帅:Spring Boot 底层级探索系列 03 - 简单配置
24 0
江帅帅:Spring Boot 底层级探索系列 03 - 简单配置