Spring Boot程序正确停止的姿势
Spring Boot提供了2种优雅关闭进程的方式:
- 基于管理端口关闭进程
- 基于系统服务方式关闭进程
基于管理端口关闭进程
基于管理端口方式实现进程关闭实际上是模块spring-boot-actuator
提供的功能。
首先,需要在项目中添加对应模块依赖配置。
- 添加Maven依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
- 添加Gradle依赖
dependencies {
compile("org.springframework.boot:spring-boot-starter-actuator")
}
其次,在配置文件中添加对应的参数配置(以文件application.properties为例说明)。
# 允许执行关闭操作
management.endpoint.shutdown.enabled=true
# 处于安全考虑,只允许在本地指定关闭操作
management.server.address=127.0.0.1
# 管理端口
management.server.port=8000
# 管理URL基础路径,默认为“/”
management.endpoints.web.base-path=/ops
# 配置关闭进程Endpoint
management.endpoints.web.path-mapping.shutdown=shutdown
# 对外暴露管理Endpoint
management.endpoints.web.exposure.include=info, health, shutdown
完成上述准备工作以后,启动Spring Boot应用,通过调用POST http://localhost:8000/ops/shutdown
即可关闭进程。
实践中通常将上述关闭进程的URL调用写到脚本中,同时还可以结合别的方式一起确保进程一定能退出,如下为脚本示例(pname指进程名称):
#!/bin/bash
# 先通过管理端口关闭进程
curl -X POST http://127.0.0.1:8000/ops/shutdown --connect-timeout 3 --max-time 5
# 再次通过名称检查进程是否被成功停止
count=`ps -ef |grep pname |grep -v "grep" |wc -l`
if [ $count -gt 0 ]; then
if [ -f "$pid_file" ]; then
# 如果存在进程ID文件,则读取进程ID使用信号量通知方式关闭进程
pid=`cat $pid_file`
kill -15 $pid
else
# 通过名称方式查找到进程ID,使用信号量通知方式关闭进程
pid=`ps -ef |grep pname |grep -v "grep"| awk '{print $2}'`
kill -15 $pid
fi
fi
关于通过管理端口关闭Spring Boot进程的详细说明参见:https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#production-ready-endpoints 。
通过系统服务方式停止进程
Spring Boot支持直接将打包好的可执行jar包以系统服务方式运行,具体实现方式如下所述。
首先,将应用打包为完全可执行的jar包。
- Maven打包配配置
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<!-- 这个配置非常重要,使打包好的jar包具备可执行权限-->
<executable>true</executable>
</configuration>
</plugin>
- Gradle打包配置
bootJar {
launchScript()
}
其次,将打包好的应用jar包添加为系统服务(在ubuntu18.04 LTS上实现,基于systemd)
1.假设将Spring Boot应用安装到/var/myapp目录下:将上述打包好的jar包拷贝到/var/myapp(目录不存在,手动创建)
2.在/etc/systemd/system下添加指定名称的系统服务:myapp.service,内容如下:
[Unit]
Description=myapp
After=syslog.target
[Service]
User=root ## 注意:这里配置的是将来启动该服务的Linux系统用户名,影响权限
ExecStart=/var/myapp/myapp.jar
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
3.启动服务
$ sudo systemctl enable myapp.service
$ sudo systemctl start myapp.service
如果需要查看应用启动日志,请执行:$ journalctl -f
。
如果启动服务失败,请检查对应名称的服务文件是否放在正确位置(如:systemd系统需要放在/etc/systemd/system目录下),或者检查启动服务的用户权限,一些错误情形可以参考:https://springjavatricks.blogspot.com/2018/06/installing-spring-boot-services-in.html 。
关于将Spring Boot应用部署为系统服务的详细说明参见: https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#deployment-install 。
写在最后
我在如何优雅地停止Java进程中有讲到如何实现在进程退出之前做一些收尾的工作,这在Spring Boot中同样适用,只需要监听对应的信号量并注册JVM关闭钩子即可。
@SpringBootApplication
public class SpringbootApplication {
private static final Logger logger = LoggerFactory.getLogger(SpringbootApplication.class);
public static void main(String[] args) {
// 在Spring Boot应用中通过监听信号量和注册关闭钩子来实现在进程退出之前执行收尾工作
// 监听信号量
Signal sg = new Signal("TERM");
Signal.handle(sg, new SignalHandler() {
@Override
public void handle(Signal signal) {
logger.info("do signal handle: {}", signal.getName());
System.exit(0);
}
});
// 注册关闭钩子
Runtime.getRuntime().addShutdownHook(new Thread(){
@Override
public void run() {
// 执行收尾工作
logger.info("do something on shutdown hook");
}
});
SpringApplication.run(SpringbootApplication.class, args);
logger.info("Start DONE.");
}
}
另外,需要注意的是:在普通的Java应用程序中,当出现RuntimeExeception或OOM时会触发关闭钩子的执行;但是在Spring Boot应用中,当出现RuntimeException或OOM时并不会触发关闭钩子的执行(Spring Boot使用了嵌入式Tomcat)。
【参考】
https://www.jianshu.com/p/44ef43b282f0 正确、安全地停止SpringBoot应用服务
Spring Boot程序正确停止的姿势的更多相关文章
- 第一章 第一个spring boot程序(转载)
第一章 第一个spring boot程序 本编博客转发自:http://www.cnblogs.com/java-zhao/p/5324185.html 环境: jdk:1.8.0_73 mave ...
- 我的第一个spring boot程序(spring boot 学习笔记之二)
第一个spring boot程序 写在前面:鉴于spring注解以及springMVC的配置有大量细节和知识点,在学习理解之后,我们将直接进入spring boot的学习,在后续学习中用到注解及其他相 ...
- 构建Spring Boot程序有用的文章
构建Spring Boot程序有用的文章: http://www.jb51.net/article/111546.htm
- Spring Boot从入门到精通(一)搭建第一个Spring Boot程序
Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程.该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置.通过 ...
- Spring Boot程序接收命令行参数
Spring Boot程序接收命令行参数 输入一行,回车,触发一次.如果想要调用service层,也是可以,能调用service层,就可以做很多事,触发一次就好比调用了一次http接口一样 packa ...
- Postman发送POST请求到Spring Boot的正确姿势
最近用Spring Boot搭建了一些restful api,写起来真的很爽.但是当用Postman测试一些POST请求的接口的时候却遇到一些问题,上网冲浪查了一堆博客资料,发现都讲得不清不楚,于是记 ...
- spring boot 服务 正确关闭方式
引言 Spring Boot,作为Spring框架对“约定优先于配置(Convention Over Configuration)”理念的最佳实践的产物,它能帮助我们很快捷的创建出独立运行.产品级别的 ...
- Spring Boot程序的执行流程
Spring Boot的执行流程如下图所示:(图片来源于网络) 上图为SpringBoot启动结构图,我们发现启动流程主要分为三个部分,第一部分进行SpringApplication的初始化模块,配置 ...
- 第一个Spring Boot程序
Windows 10家庭中文版,java version "1.8.0_152", Eclipse Oxygen.1a Release (4.7.1a),Spring Tools ...
随机推荐
- MVC 自己创建URL 对象处理路径
var url = new UrlHelper(filterContext.RequestContext); var url = new UrlHelper(HttpContext.Current.R ...
- git 学习记录—— git 中的仓库、文件状态、修改和提交操作等
最近开始学习使用版本控制工具 git .学习方式主要通过阅读 git 网站上的 Pro git 和动手实践,使用的系统为 Ubuntu16.04LTS,以及 Windows 8.1. 本文主要关注 ...
- react 沉思录
react = Virtual DOM + component + data flow + jsx 核心是Virtual DOM结构的状态维护.渲染机制及UI系统的DOM组织功能: 基于Virtual ...
- 第9章 MyBatis的关系映射
在实际开发中,对数据库的操作通常涉及多张表,涉及了对象和对象之间的关联关系.针对多表之间的操作,MyBatis提供了关联映射,通过关联映射就可以很好的处理对象与对象之间的关联关系 9.1 关联关系概述 ...
- 2019 CSP-J复赛游记
不出行?不出行考屁呢? 今天的CSP-J似乎比去年简单了一些,可它... 好了,来说一说我的情况. T1:太水,5分钟秒 T2:这个数据有点尴尬,双重循环铁定爆,用链表有有一点小题大做.本蒟蒻在考场上 ...
- Redis笔记搬迁
Redis原理 从不同的角度来详细介绍redis 存储方式 数据结构 Redis的过期策略 数据淘汰策略 高可用 主从复制 分布式缓存 哨兵 缓存异常 缓存穿透 缓存雪崩 缓存与数据库数据一致性 ...
- MongoDB Map Reduce(转载)
MongoDB Map Reduce Map-Reduce是一种计算模型,简单的说就是将大批量的工作(数据)分解(MAP)执行,然后再将结果合并成最终结果(REDUCE). MongoDB提供的Map ...
- Numpy | 10 广播(Broadcast)
广播(Broadcast)是 numpy 对不同形状(shape)的数组进行数值计算的方式, 对数组的算术运算通常在相应的元素上进行. 下面的图片展示了数组 b 如何通过广播来与数组 a 兼容. 4x ...
- [PHP] Laravel 5.5 打印SQL语句
[PHP] Laravel 5.5 打印SQL语句 四种方法 第一种方法: 打印SQL默认是关闭的,需要在/vendor/illuminate/database/Connection.php中打开. ...
- spl_autoload_register 和 __autoload()魔术方法
在 PHP 5.3 之前,__autoload 函数抛出的异常不能被 catch 语句块捕获并会导致一个致命错误(Fatal Error). 尽管 __autoload() 函数也能自动加载类和接口 ...