0%

Spring Boot 项目自动发布

Spring Boot 项目自动发布


简介

在公司从移动端转后端已经快一年了,使用的技术框架一直是Spring Boot,和以前大学时候基于Tomcat的不太一样。

这篇文章简单介绍下如何发布Spring Boot 项目,原先使用Tomcat时候,发布的文件是war文件,现在使用Spring Boot就变得很简单了,直接是一个jar文件,启动方式按照启动jar文件方式即可。

准备工作

使用Idea创建一个带Spring Boot的项目,使用gradle管理项目。

使用gradle依赖很简单,同时创建两个Controller,一个用户表示线上api接口,一个表示心跳接口,用于测试。

1
dependencies {
2
    compileOnly('org.projectlombok:lombok')
3
4
    compile('org.springframework.boot:spring-boot-starter-web')
5
6
    testCompile('org.springframework.boot:spring-boot-starter-test')
7
}
1
@Slf4j
2
@RestController
3
public class HelloWorldController {
4
5
    @Value("${app.env}")
6
    String env;
7
8
    @RequestMapping(path = "/hello", method = RequestMethod.GET)
9
    public Object hello() {
10
        log.info("hello>>>");
11
12
        Map<String, Object> map = new HashMap<>();
13
        map.put("hello", "world");
14
        map.put("env", env);
15
16
        log.info("map = " + map);
17
        return map;
18
    }
19
}
1
@Slf4j
2
@RestController
3
public class HeartbeatController {
4
5
    @RequestMapping(path = "/heartbeat")
6
    public Object heartbeat() {
7
        return "success";
8
    }
9
}

同时配置好对应的配置文件,我这有三个配置文件,一个dev环境,一个表示prod环境,还有一个表示开关。

image

Spring支持选择对应的config文件,开发时候,配置成dev,则生效的文件application-dev.properties

1
spring.profiles.active=dev
2
#spring.profiles.active=prod

dev

1
server.port=8080
2
app.env=dev
3
logging.config=classpath:logback-spring.xml

prod

1
server.port=8088
2
app.env=prod
3
logging.config=classpath:logback-spring.xml

我这边用app.env字段表示不同环境的内容,实际情况,可以配置数据库的内容,开发和线上的数据库是不一样的。

启动程序,然后测试下请求。

1
curl http://127.0.0.1:8080/hello    
2
{"hello":"world","env":"dev"}

数据是正常的,env读取的也是dev数据。

编译和发布

由于项目使用gradle管理,那么在发布时候,直接使用gradle命令编译即可,命令如下,clean是可选的,不过一般在本地开发然后再发布,建议先clean下。

1
./gradlew clean build

编译成功后,在项目生成目录中可以找到对应的jar文件,路径是./build/libs/springboot-deploy-demo-0.0.1-SNAPSHOT.jar

可以直接使用java命令来启动。

image

为了方便起见我在项目中写个简单脚本,编译成功后,复制目标文件到相应的目录,然后直接同步到服务器即可。

1
#!/usr/bin/env bash
2
3
./gradlew clean build
4
5
cp build/libs/* deploy/

deploy 目录除了有目标文件外,还有线上环境的配置文件,几个服务启动停止shell文件。

start.sh,很简单,在启动前,检查是否已经启动,在没有启动情况下,在启动服务。

1
#!/bin/sh
2
3
4
#get pwd
5
DIR_HOME="${BASH_SOURCE-$0}"
6
DIR_HOME="$(dirname "$DIR_HOME")"
7
PRGDIR="$(cd "${DIR_HOME}"; pwd)"
8
9
jarfile=$PRGDIR/springboot-deploy-demo-0.0.1-SNAPSHOT.jar
10
11
#get runing pid
12
pid=$(ps -ef | grep java | grep $jarfile | awk '{print $2}')
13
14
#create log dir
15
mkdir -p $PRGDIR/log/
16
17
if [ "$pid" != "" ];then
18
    echo "ERROR: $jarfile is running! pid=$pid. You must stop it first!"
19
else
20
    nohup java -jar $jarfile -Dfile.encoding=UTF-8 --spring.config.location=$PRGDIR/ >$PRGDIR/log/start.log 2>&1 &
21
    pid=$(ps -ef | grep java | grep $jarfile | awk '{print $2}')
22
    echo "INFO: $jarfile is running! pid=$pid"
23
24
    url="http://127.0.0.1:8088/heartbeat";
25
    echo $url
26
    while [ true ]
27
    do
28
        sleep 1
29
        HTTP_CODE=`curl -G -m 10 -o /dev/null -s -w %{http_code} $url`
30
        echo "http code: ${HTTP_CODE}"
31
        if [ ${HTTP_CODE} -eq 200 ]
32
        then
33
            echo "server start success..."
34
            exit 0
35
        fi
36
    done
37
fi

同时启动前,需要配置spring boot运行的参数,最重要的有Spring Boot启动的配置文件的位置--spring.config.location,我配置的位置是./

需要注意的是,prod的配置文件,一些参数需要注意路径,开发中路径是classpath:开头,线上是不需要的,当然了也是根据实际情况来看。

1
server.port=8088
2
app.env=prod
3
logging.config=logback-spring.xml

在启动服务后,会尝试调用相应的接口,测试启动是否成功。

1
url="http://127.0.0.1:8088/heartbeat";
2
echo $url
3
while [ true ]
4
do
5
    sleep 1
6
    HTTP_CODE=`curl -G -m 10 -o /dev/null -s -w %{http_code} $url`
7
    echo "http code: ${HTTP_CODE}"
8
    if [ ${HTTP_CODE} -eq 200 ]
9
    then
10
        echo "server start success..."
11
        exit 0
12
    fi
13
done

stop.sh

停止服务很简单,直接查找对应的进程,然后杀掉,这里需要注意进程名字是以jar文件来查找的。

1
#!/bin/sh
2
3
process=springboot-deploy-demo-0.0.1-SNAPSHOT.jar
4
5
ifrun=$(ps -ef | grep $process | grep java)
6
if [ "$ifrun" != "" ];then
7
    kill -9 `ps -ef | grep $process | grep java | awk '{print $2}'`
8
    echo "INFO: $process is stoped!"
9
else
10
    echo "WARN: Not found $process running."
11
fi

restart.sh

这个比较简单,就是先停止,再启动。

1
#!/bin/sh
2
3
./stop.sh
4
./start.sh

同步到服务器

这里做简单演示,我使用的是Ubuntu虚拟机,使用scp命令上传到服务器上,实际情况可以根据自己需求来选择,比如使用svn,ftp等。

1
scp deploy/* xiaqiulei@192.168.153.134:~/deploy

然后ssh登陆上192.168.153.134机器,进入deploy目录,执行./start即可。

示例:

1
$ scp deploy/* xiaqiulei@192.168.153.134:~/deploy
2
xiaqiulei@192.168.153.134's password: 
3
application-prod.properties                                                                                                                                                                  100%   63    84.7KB/s   00:00    
4
application.properties                                                                                                                                                                       100%   27    26.4KB/s   00:00    
5
deploy/log: not a regular file
6
logback-spring.xml                                                                                                                                                                           100%  881   753.4KB/s   00:00    
7
restart.sh                                                                                                                                                                                   100%   32    23.3KB/s   00:00    
8
springboot-deploy-demo-0.0.1-SNAPSHOT.jar                                                                                                                                                    100%   15MB  32.5MB/s   00:00    
9
start.sh                                                                                                                                                                                     100%  970     1.5MB/s   00:00    
10
stop.sh                                                                                                                                                                                      100%  291   169.0KB/s   00:00    
11
12
$ ssh xiaqiulei@192.168.153.134
13
xiaqiulei@192.168.153.134's password: 
14
Welcome to Ubuntu 16.04.3 LTS (GNU/Linux 4.4.0-109-generic x86_64)
15
16
 * Documentation:  https://help.ubuntu.com
17
 * Management:     https://landscape.canonical.com
18
 * Support:        https://ubuntu.com/advantage
19
20
299 packages can be updated.
21
161 updates are security updates.
22
23
Last login: Tue Apr 24 23:04:57 2018 from 192.168.153.1
24
25
# xiaqiulei @ ubuntu in ~ [23:07:59] 
26
$ cd deploy 
27
28
# xiaqiulei @ ubuntu in ~/deploy [23:08:01] 
29
$ ./start.sh 
30
INFO: /home/xiaqiulei/deploy/springboot-deploy-demo-0.0.1-SNAPSHOT.jar is running! pid=4645
31
http://127.0.0.1:8088/heartbeat
32
http code: 000
33
http code: 000
34
http code: 000
35
http code: 000
36
http code: 000
37
http code: 200
38
server start success...

总结

本文只是简单介绍使相关脚本发布Spring Boot服务到linux机器上,基本满足小项目需求。

当然了,还有不够完善的地方,比如启动的方式是nohup,当进程挂掉以后,不能够自动重启,高级的用法是使用supervisor

再比如,scp同步的时候,都是简单的文件覆盖,比较友好的方式是,先备份原先的文件,然后再同步文件,这样如果服务有问题,还可以回滚。

源码地址

源码地址 https://github.com/LiushuiXiaoxia/springboot-deploy-demo

坚持原创技术分享,您的支持将鼓励我继续创作!