SpringBoot部署与服务配置方式_Java

spring boot 其默认是集成web容器的，启动方式由像普通java程序一样，main函数入口启动。其内置tomcat容器或jetty容器，具体由配置来决定（默认tomcat）。

当然你也可以将项目打包成war包，放到独立的web容器中（tomcat、weblogic等等），当然在此之前你要对程序入口做简单调整。

项目构建我们使用maven或gradle，这将使项目依赖、jar包管理、以及打包部署变的非常方便。

一、内嵌 server 配置

spring boot将容器内置后，它通过配置文件的方式类修改相关server配置。

先看一下下面的图，为关于server的配置列项：

其中常用的配置只有少数几个，已经用紫色标记起来。红框圈起来的部分，看名称分类就可以明白其作用。

对server的几个常用的配置做个简单说明：

# 项目contextpath，一般在正式发布版本中，我们不配置
server.context-path=/myspringboot
# 错误页，指定发生错误时，跳转的url。请查看basicerrorcontroller源码便知
server.error.path=/error
# 服务端口
server.port=9090
# session最大超时时间(分钟)，默认为30
server.session-timeout=60
# 该服务绑定ip地址，启动服务器时如本机不是该ip地址则抛出异常启动失败，只有特殊需求的情况下才配置
# server.address=192.168.16.11

tomcat

tomcat为spring boot的默认容器，下面是几个常用配置：

# tomcat最大线程数，默认为200
server.tomcat.max-threads=800
# tomcat的uri编码
server.tomcat.uri-encoding=utf-8
# 存放tomcat的日志、dump等文件的临时文件夹，默认为系统的tmp文件夹（如：c:\users\shanhy\appdata\local\temp）
server.tomcat.basedir=h:/springboot-tomcat-tmp
# 打开tomcat的access日志，并可以设置日志格式的方法：
#server.tomcat.access-log-enabled=true
#server.tomcat.access-log-pattern=
# accesslog目录，默认在basedir/logs
#server.tomcat.accesslog.directory=
# 日志文件目录
logging.path=h:/springboot-tomcat-tmp
# 日志文件名称，默认为spring.log
logging.file=myapp.log

jetty

如果你要选择jetty，也非常简单，就是把pom中的tomcat依赖排除，并加入jetty容器的依赖，如下：

<dependencies>
  <dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-web</artifactid>
    <exclusions>
      <exclusion>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-tomcat</artifactid>
      </exclusion>
    </exclusions>
  </dependency>
  <dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-jetty</artifactid>
  </dependency>
<dependencies>

打包

打包方法：

cmd进入项目目录，使用 mvn clean package 命令打包，以我的项目工程为例：

e:\spring-boot-sample>mvn clean package

可以追加参数 -dmaven.test.skip=true 跳过测试。

打包后的文件存放于项目下的target目录中，如：spring-boot-sample-0.0.1-snapshot.jar

如果pom配置的是war包，则为spring-boot-sample-0.0.1-snapshot.war

二、部署到javaee容器

1.修改启动类，继承 springbootservletinitializer 并重写 configure 方法

@springbootapplication
public class springbootsampleapplication extends springbootservletinitializer{
	
	private static final logger logger = loggerfactory.getlogger(springbootsampleapplication.class);
	
	// 这里原来有的 springboot 的main方法，也可以保留不删除的，不影响
	
	@override
	protected springapplicationbuilder configure(springapplicationbuilder builder) {
		return builder.sources(this.getclass());
	}

}

2.修改pom文件中jar 为 war

<!-- <packaging>jar</packaging> -->
<packaging>war</packaging>

3.修改pom，排除tomcat插件

		<dependency>
			<groupid>org.springframework.boot</groupid>
			<artifactid>spring-boot-starter-web</artifactid>
			<exclusions>
				<exclusion>
					<groupid>org.springframework.boot</groupid>
					<artifactid>spring-boot-starter-tomcat</artifactid>
				</exclusion>
			</exclusions>
		</dependency>
		<dependency>
			<groupid>org.springframework.boot</groupid>
			<artifactid>spring-boot-starter-tomcat</artifactid>
			<scope>provided</scope><!--注意这里是provided，打包阶段不包含该包-->
		</dependency>

4.打包部署到容器

使用命令 mvn clean package 打包后，同一般j2ee项目一样部署到web容器。

三、使用profile区分环境

spring boot 可以在 “配置文件”、“java代码类”、“日志配置” 中来配置profile区分不同环境执行不同的结果

1、配置文件

使用配置文件application.yml 和 application.properties 有所区别

以application.properties 为例，通过文件名来区分环境 application-{profile}.properties

application.properties

app.name=myapp
server.port=8080
spring.profiles.active=dev

application-dev.properties

server.port=8081

application-stg.properties

server.port=8082

在启动程序的时候通过添加 --spring.profiles.active={profile} 来指定具体使用的配置

例如我们执行 java -jar demo.jar --spring.profiles.active=dev 那么上面3个文件中的内容将被如何应用？

spring boot 会先加载默认的配置文件，然后使用具体指定的profile中的配置去覆盖默认配置。

app.name 只存在于默认配置文件 application.properties 中，因为指定环境中不存在同样的配置，所以该值不会被覆盖
server.port 默认为8080，但是我们指定了环境后，将会被覆盖。如果指定stg环境，server.port 则为 8082
spring.profiles.active 默认指定dev环境，如果我们在运行时指定 --spring.profiles.active=stg 那么将应用stg环境，最终 server.port 的值为8082

2、java类中@profile注解

下面2个不同的类实现了同一个接口，@profile注解指定了具体环境

// 接口定义
public interface sendmessage {

	// 发送短信方法定义
	public void send();
	
}

// dev 环境实现类
@component
@profile("dev")
public class devsendmessage implements sendmessage {

	@override
	public void send() {
		system.out.println(">>>>>>>>dev send()<<<<<<<<");
	}

}

// stg环境实现类
@component
@profile("stg")
public class stgsendmessage implements sendmessage {

	@override
	public void send() {
		system.out.println(">>>>>>>>stg send()<<<<<<<<");
	}

}

// 启动类
@springbootapplication
public class profiledemoapplication {
	
	@value("${app.name}")
	private string name;
	
	@autowired
	private sendmessage sendmessage;
	
	@postconstruct
	public void init(){
		sendmessage.send();// 会根据profile指定的环境实例化对应的类
	}

}

3、logback-spring.xml也支持有节点来支持区分

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<include resource="org/springframework/boot/logging/logback/base.xml" />
	<logger name="org.springframework.web" level="info"/>

	<springprofile name="default">
		<logger name="org.springboot.sample" level="trace" />
	</springprofile>
	
	<springprofile name="dev">
		<logger name="org.springboot.sample" level="debug" />
	</springprofile>

	<springprofile name="staging">
		<logger name="org.springboot.sample" level="info" />
	</springprofile>

</configuration>

再说一遍文件名不要用logback.xml 请使用logback-spring.xml

四、指定外部的配置文件

有些系统，关于一些数据库或其他第三方账户等信息，由于安全问题，其配置并不会提前配置在项目中暴露给开发人员。

对于这种情况，我们在运行程序的时候，可以通过参数指定一个外部配置文件。

以 demo.jar 为例，方法如下：

java -jar demo.jar --spring.config.location=/opt/config/application.properties

其中文件名随便定义，无固定要求。

五、创建一个linux 应用的sh脚本

下面几个脚本仅供参考，请根据自己需要做调整

start.sh

#!/bin/sh

rm -f tpid

nohup java -jar myapp.jar --spring.config.location=application.yml > /dev/null 2>&1 &

echo $! > tpid

echo start success!

stop.sh

#!/bin/sh
app_name=myapp

tpid=`ps -ef|grep $app_name|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
	echo 'stop process...'
	kill -15 $tpid
fi
sleep 5
tpid=`ps -ef|grep $app_name|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
	echo 'kill process!'
	kill -9 $tpid
else
	echo 'stop success!'
fi

check.sh

#!/bin/sh
app_name=myapp

tpid=`ps -ef|grep $app_name|grep -v grep|grep -v kill|awk '{print $2}'`
if [ ${tpid} ]; then
        echo 'app is running.'
else
        echo 'app is not running.'
fi

kill.sh

#!/bin/sh
app_name=myapp

tpid=`ps -ef|grep $app_name|grep -v grep|grep -v kill|awk '{print $2}'`
for p in $tpid
do
    echo 'kill processid '$p
    kill -9 $p
done

六、使用linux服务的方式启动、停止、重启

1、首先在 pom.xml 中配置插件

	<build>
		<plugins>
			<plugin>
				<groupid>org.springframework.boot</groupid>
				<artifactid>spring-boot-maven-plugin</artifactid>
				<configuration>
					<executable>true</executable>
				</configuration>
			</plugin>
		</plugins>
	</build>

特别注意一下 <executable>true</executable>

2、然后正常使用 mvn clean package -dmaven.test.skip=true 将工程打成jar包

3、上传jar包到服务器，假设部署路径为 /var/apps/myapp.jar ，使用命令做一个软连接到 /etc/init.d 目录，命令：

ln -s /var/apps/myapp.jar /etc/init.d/myapp

其中 /etc/init.d/myapp 最后的 myapp 可以是别的名字，这个就是服务名，我们后面使用 service [服务名] start 来启动（下面有说明）。

4、给jar文件授予可执行权限，命令：

chmod +x myapp.jar

5、接下来，就可以使用我们熟悉的 service myapp start|stop|restart|status 来对应用进行启停了。

执行命令后将得到形如 started|stopped [pid] 的结果反馈。
默认pid文件路径：/var/run/appname/appname.pid
默认服务日志文件路径：/var/log/appname.log（可以通过下面.conf 的方式修改log_folder）

6、使用自定义的.conf文件来变更默认配置，方法如下：

在jar包相同路径下创建一个.conf文件，名称应该与.jar的名称相同，如myapp.conf（如果我们打包的文jar文件为 myapp-1.0.0.jar 那么这里的conf文件也应该是 myapp-1.0.0.conf），其内容配置可以如下：

java_home=/usr/local/jdk
java_opts=-xmx1024m
log_folder=/data/logs/myapp

注：log_folder 对应的文件夹目录要必须存在，如果目录不存在，服务并不会自从创建目录。

华丽丽的分割线

如果你是centos 7或红帽7以上，你还可以用下面的方法处理，为什么要用这样的方法（请自行研究），这里直接提供结果，哈哈

编辑服务文件 vim /usr/lib/systemd/system/myapp.service

[unit]
description=myapp
after=network.target

[service]
workingdirectory=/var/apps/myapp
execstart=/usr/local/java/bin/java -dsun.misc.urlclasspath.disablejarchecking=true -jar /var/apps/myapp.jar
execstop=kill $mainpid
restart=always

[install]
wantedby=multi-user.target

使用linux 7 以后服务新的启动方式，相关命令

启动
systemctl start myapp
停止
systemctl stop myapp
重启
systemctl restart myapp
查看日志
journalctl -u myapp
关于更多 systemctl 命令的使用方法，度娘有很多。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持代码网。

SpringBoot部署与服务配置方式

2024年06月12日 • Java •我要评论