Spring Boot 部署与服务配置

Posted 2020-09-27 zhchoutai

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。也很easy。就是把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 命令打包，以我的项目project为例：

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 方法

public class SpringBootSampleApplication extends SpringBootServletInitializer{

    private static final Logger logger = LoggerFactory.getLogger(SpringBootSampleApplication.class);

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(this.getClass());
    }

}

1. 改动pom文件里jar 为 war

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

1. 改动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>

1. 打包部署到容器
   使用命令 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}‘`
if [ ${tpid} ]; then
    echo ‘Kill Process!‘
    kill -9 $tpid
fi

六、使用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 将project打成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 相应的文件夹文件夹要必须存在，假设文件夹不存在。服务并不会自从创建文件夹。

（结束）