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

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

我们知道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项目的打包和部署的方式题介绍完了。

相关实践学习
通过日志服务实现云资源OSS的安全审计
本实验介绍如何通过日志服务实现云资源OSS的安全审计。
相关文章
|
3月前
|
XML Java 应用服务中间件
【SpringBoot(一)】Spring的认知、容器功能讲解与自动装配原理的入门,带你熟悉Springboot中基本的注解使用
SpringBoot专栏开篇第一章,讲述认识SpringBoot、Bean容器功能的讲解、自动装配原理的入门,还有其他常用的Springboot注解!如果想要了解SpringBoot,那么就进来看看吧!
527 2
|
4月前
|
人工智能 Java 机器人
基于Spring AI Alibaba + Spring Boot + Ollama搭建本地AI对话机器人API
Spring AI Alibaba集成Ollama,基于Java构建本地大模型应用,支持流式对话、knife4j接口可视化,实现高隐私、免API密钥的离线AI服务。
4157 2
基于Spring AI Alibaba + Spring Boot + Ollama搭建本地AI对话机器人API
存储 JSON Java
672 0
|
5月前
|
监控 Java API
Spring Boot 3.2 结合 Spring Cloud 微服务架构实操指南 现代分布式应用系统构建实战教程
Spring Boot 3.2 + Spring Cloud 2023.0 微服务架构实践摘要 本文基于Spring Boot 3.2.5和Spring Cloud 2023.0.1最新稳定版本,演示现代微服务架构的构建过程。主要内容包括: 技术栈选择:采用Spring Cloud Netflix Eureka 4.1.0作为服务注册中心,Resilience4j 2.1.0替代Hystrix实现熔断机制,配合OpenFeign和Gateway等组件。 核心实操步骤: 搭建Eureka注册中心服务 构建商品
1031 3
|
6月前
|
Java 测试技术 Spring
简单学Spring Boot | 博客项目的测试
本内容介绍了基于Spring Boot的博客项目测试实践,重点在于通过测试驱动开发(TDD)优化服务层代码,提升代码质量和功能可靠性。案例详细展示了如何为PostService类编写测试用例、运行测试并根据反馈优化功能代码,包括两次优化过程。通过TDD流程,确保每项功能经过严格验证,增强代码可维护性与系统稳定性。
306 0
|
6月前
|
存储 Java 数据库连接
简单学Spring Boot | 博客项目的三层架构重构
本案例通过采用三层架构(数据访问层、业务逻辑层、表现层)重构项目,解决了集中式开发导致的代码臃肿问题。各层职责清晰,结合依赖注入实现解耦,提升了系统的可维护性、可测试性和可扩展性,为后续接入真实数据库奠定基础。
567 0
|
6月前
|
JSON 分布式计算 大数据
springboot项目集成大数据第三方dolphinscheduler调度器
springboot项目集成大数据第三方dolphinscheduler调度器
421 3
|
SQL 安全 Java
SpringBoot整合SpringSecurity
SpringBoot整合SpringSecurity
SpringBoot整合SpringSecurity