Springboot基于assembly的服務(wù)化打包方案及spring boot部署方式
在使用assembly來打包springboot微服務(wù)項目前,我想說一說,目前springboot項目的幾種常見的部署方式。
使用docker容器去部署,將springboot的應(yīng)用構(gòu)建成一個docker image,然后通過容器去啟動鏡像 ,這種方式在需要部署大規(guī)模的應(yīng)用和應(yīng)用擴展時是非常方便的,屬于目前工業(yè)級的部署方案,但是需要掌握docker的生態(tài)圈技術(shù)。
使用fatjar直接部署啟動,這是很多初學(xué)者或者極小規(guī)模情況下的一個簡單應(yīng)用部署方式。
本文主要針對第二種部署方式提供一種更加友好的打包方案,是部署管理更加輕松,第一種方式可能未來我會在自己博客中寫。
一、為什么要將springboot服務(wù)化打包 ?
最近我看到一個項目團隊,他們在采用springboot開發(fā)完項目構(gòu)建交互給運維團隊就是一個spring boot 的fatjar。而且這種原始打出的包在傳統(tǒng)型項目開發(fā)公司,對于運維人員來說無疑是很致命的,項目交付后整個配置文件都被隱藏到打成的jar中,針對不同的環(huán)境修改配置文件就變成了一件很困難的事情。因此,我們在公司引入任何新技術(shù)時,一定要考慮怎么去做服務(wù)化和工程化,如果僅僅引用技術(shù)框架,很多時候可能只需要加入幾個依賴,看下api寫幾行代碼就能跑起來。
針對上面的這種問題,要去做服務(wù)化和工程化,大致要解決兩點問題:
讓springboot能夠加載jar外的配置文件。
提供一個服務(wù)化的啟動腳本,這個腳本一般是shell或者windows下的bat ,有了springboot的應(yīng)用服務(wù)腳本后,就可以容器的去啟動和停止springboot的應(yīng)用了。
二、打包后的springboot應(yīng)用結(jié)構(gòu)圖
這里先來看下使用assembly將springboot服務(wù)化打包后的效果圖。

三、服務(wù)化打包重要步驟
下面是打包springboot的詳細步驟。
3.1 加入assembly打包插件
<plugin> <artifactId>maven-assembly-plugin</artifactId> <version>3.0.0</version> <configuration> <descriptors> <descriptor>src/main/assembly/assembly.xml</descriptor> </descriptors> </configuration> <executions> <execution> <id>make-assembly</id> <phase>package</phase> <goals> <goal>single</goal> </goals> </execution> </executions> </plugin>
從上面代碼看出了我把assembly的配置放在main目錄下,這個是習(xí)慣,可以不放這里也可以,下面就是一個assembly在項目中的大致結(jié)構(gòu)圖:

3.2 assembly.xml配置
assembly的配置不同的應(yīng)用和下面配置也差不多,無非就是打包服務(wù)腳本、jar、配置文件等。從下面的代碼中config配置就會發(fā)現(xiàn), assembly將配置文件打到了config下。
<assembly>
<id>1.0</id>
<formats>
<format>tar.gz</format>
</formats>
<fileSets>
<fileSet>
<directory>src/main/assembly/bin</directory>
<outputDirectory>bin</outputDirectory>
<fileMode>0755</fileMode>
</fileSet>
<fileSet>
<directory>src/main/assembly/config</directory>
<outputDirectory>config</outputDirectory>
<fileMode>0644</fileMode>
</fileSet>
<fileSet>
<directory>target</directory>
<outputDirectory>lib</outputDirectory>
<includes>
<include>*.jar</include>
</includes>
</fileSet>
<fileSet>
<directory>src/main/resources</directory>
<outputDirectory>logs</outputDirectory>
<fileMode>0755</fileMode>
<excludes>
<exclude>**/*</exclude>
</excludes>
</fileSet>
</fileSets>
</assembly>
3.3 編寫服務(wù)腳本
現(xiàn)在寫linux環(huán)境的腳本。
第一個:start.sh啟動腳本
#!/bin/bash
SERVER_NAME='spring-vue'
# jar名稱
JAR_NAME='springboot-vue.jar'
cd `dirname $0`
BIN_DIR=`pwd`
cd ..
DEPLOY_DIR=`pwd`
CONF_DIR=$DEPLOY_DIR/config
# SERVER_PORT=`sed '/server.port/!d;s/.*=//' config/application.properties | tr -d '\r'`
# 獲取應(yīng)用的端口號
SERVER_PORT=`sed -nr '/port: [0-9]+/ s/.*port: +([0-9]+).*/\1/p' config/application.yml`
PIDS=`ps -f | grep java | grep "$CONF_DIR" |awk '{print $2}'`
if [ "$1" = "status" ]; then
if [ -n "$PIDS" ]; then
echo "The $SERVER_NAME is running...!"
echo "PID: $PIDS"
exit 0
else
echo "The $SERVER_NAME is stopped"
exit 0
fi
fi
if [ -n "$PIDS" ]; then
echo "ERROR: The $SERVER_NAME already started!"
echo "PID: $PIDS"
exit 1
fi
if [ -n "$SERVER_PORT" ]; then
SERVER_PORT_COUNT=`netstat -tln | grep $SERVER_PORT | wc -l`
if [ $SERVER_PORT_COUNT -gt 0 ]; then
echo "ERROR: The $SERVER_NAME port $SERVER_PORT already used!"
exit 1
fi
fi
LOGS_DIR=$DEPLOY_DIR/logs
if [ ! -d $LOGS_DIR ]; then
mkdir $LOGS_DIR
fi
STDOUT_FILE=$LOGS_DIR/stdout.log
JAVA_OPTS=" -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true "
JAVA_DEBUG_OPTS=""
if [ "$1" = "debug" ]; then
JAVA_DEBUG_OPTS=" -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n "
fi
JAVA_JMX_OPTS=""
if [ "$1" = "jmx" ]; then
JAVA_JMX_OPTS=" -Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false "
fi
JAVA_MEM_OPTS=""
BITS=`java -version 2>&1 | grep -i 64-bit`
if [ -n "$BITS" ]; then
JAVA_MEM_OPTS=" -server -Xmx512m -Xms512m -Xmn256m -XX:PermSize=128m -Xss256k -XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+UseCMSCompactAtFullCollection -XX:LargePageSizeInBytes=128m -XX:+UseFastAccessorMethods -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 "
else
JAVA_MEM_OPTS=" -server -Xms512m -Xmx512m -XX:PermSize=128m -XX:SurvivorRatio=2 -XX:+UseParallelGC "
fi
CONFIG_FILES=" -Dlogging.path=$LOGS_DIR -Dlogging.config=$CONF_DIR/log4j2.xml -Dspring.config.location=$CONF_DIR/application.properties "
echo -e "Starting the $SERVER_NAME ..."
nohup java $JAVA_OPTS $JAVA_MEM_OPTS $JAVA_DEBUG_OPTS $JAVA_JMX_OPTS $CONFIG_FILES -jar $DEPLOY_DIR/lib/$JAR_NAME > $STDOUT_FILE 2>&1 &
COUNT=0
while [ $COUNT -lt 1 ]; do
echo -e ".\c"
sleep 1
if [ -n "$SERVER_PORT" ]; then
COUNT=`netstat -an | grep $SERVER_PORT | wc -l`
else
COUNT=`ps -f | grep java | grep "$DEPLOY_DIR" | awk '{print $2}' | wc -l`
fi
if [ $COUNT -gt 0 ]; then
break
fi
done
echo "OK!"
PIDS=`ps -f | grep java | grep "$DEPLOY_DIR" | awk '{print $2}'`
echo "PID: $PIDS"
echo "STDOUT: $STDOUT_FILE"
腳本用例:
# 啟動應(yīng)用
./start.sh
# 以debug方式啟動
./start debug
# 啟動任務(wù)并開啟jmx監(jiān)控
./start jmx
# 獲取當前的運行狀態(tài)
./start status
停止腳本:stop.sh
#!/bin/bash
cd `dirname $0`
BIN_DIR=`pwd`
cd ..
DEPLOY_DIR=`pwd`
CONF_DIR=$DEPLOY_DIR/config
SERVER_NAME=$DEPLOY_DIR
PIDS=`ps -ef | grep java | grep "$CONF_DIR" |awk '{print $2}'`
if [ -z "$PIDS" ]; then
echo "ERROR: The $SERVER_NAME does not started!"
exit 1
fi
if [ "$1" != "skip" ]; then
$BIN_DIR/dump.sh
fi
echo -e "Stopping the $SERVER_NAME ...\c"
for PID in $PIDS ; do
kill $PID > /dev/null 2>&1
done
COUNT=0
while [ $COUNT -lt 1 ]; do
echo -e ".\c"
sleep 1
COUNT=1
for PID in $PIDS ; do
PID_EXIST=`ps -f -p $PID | grep java`
if [ -n "$PID_EXIST" ]; then
COUNT=0
break
fi
done
done
echo "OK!"
echo "PID: $PIDS"
windows環(huán)境的啟動腳本:
echo off set APP_NAME=springboot-vue.jar set CONFIG= -Dlogging.path=../logs -Dlogging.config=../config/log4j2.xml -Dspring.config.location=../config/application.yml set DEBUG_OPTS= if ""%1"" == ""debug"" ( set DEBUG_OPTS= -Xloggc:../logs/gc.log -verbose:gc -XX:+PrintGCDetails -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=../logs goto debug ) set JMX_OPTS= if ""%1"" == ""jmx"" ( set JMX_OPTS= -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9888 -Dcom.sun.management.jmxremote.ssl=FALSE -Dcom.sun.management.jmxremote.authenticate=FALSE goto jmx ) echo "Starting the %APP_NAME%" java -Xms512m -Xmx512m -server %DEBUG_OPTS% %JMX_OPTS% %CONFIG% -jar ../lib/%APP_NAME% goto end :debug echo "debug" java -Xms512m -Xmx512m -server %DEBUG_OPTS% %CONFIG% -jar ../lib/%APP_NAME% goto end :jmx java -Xms512m -Xmx512m -server %JMX_OPTS% %CONFIG% -jar ../lib/%APP_NAME% goto end :end pause
對于不同的springboot項目,只需要適當修改一下腳本就可以了,為了節(jié)約篇幅這里就不列出其他的腳本了,可以參考我提交的demo:https://github.com/Shalousun/springboot-vue.git
注意:以上腳本參考自dubbo官方。其實對于dubbo項目的輕量化構(gòu)建也是類似的。
四、打包后應(yīng)用的日志路徑處理
在第二節(jié)的圖中可以看到打包的應(yīng)用日志一般統(tǒng)一輸出到logs目錄中,但是對于不同的系統(tǒng)平臺,雖然配置的日志輸出路徑是一樣的,但是最后不一定輸出到logs中。經(jīng)過測試在windows平臺中使用相對的日志路徑../logs是沒有問題的,但是對于linux系統(tǒng)下使用相對路徑就不能輸出到logs下,因此建議在linux平臺下就寫絕對路徑吧。不過在我提供的腳本中設(shè)置輸出日志的路徑
-Dlogging.path=../logs
因此結(jié)合log4j2的強大解析能力完全可以設(shè)置log42的日志路徑:
<property name="LOG_HOME">${sys:logging.path}</property>
但是對于springboot應(yīng)用的訪問日志在linux下似乎只能使用絕對路徑了。
# server config server: port: 8080 undertow: accesslog: enabled: true dir: /usr/xxx/logs logging: path: /usr/xxx/logs
當然后面有使用配置解決的同學(xué)可以提醒糾正下。
總結(jié):
這個方案本身并沒有帶來什么新東西,甚至腳本大多數(shù)是參考了dubbo官方的腳本,只是在上面做了些完善。但是重要的一點是怎么去根據(jù)實際的技術(shù)應(yīng)用場景,思考使用這項技術(shù)需要做的服務(wù)化和工程化。
以上所述是小編給大家介紹的Springboot基于assembly的服務(wù)化打包方案,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復(fù)大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
相關(guān)文章
Java ArrayList.add 的實現(xiàn)方法
這篇文章主要介紹了Java ArrayList.add 的實現(xiàn)方法,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-11-11
SpringBoot深入刨析數(shù)據(jù)層技術(shù)
這篇文章主要介紹了SpringBoot數(shù)據(jù)層技術(shù)的解析,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-08-08
Java二維數(shù)組與稀疏數(shù)組相互轉(zhuǎn)換實現(xiàn)詳解
在某些應(yīng)用場景中需要大量的二維數(shù)組來進行數(shù)據(jù)存儲,但是二維數(shù)組中卻有著大量的無用的位置占據(jù)著內(nèi)存空間,稀疏數(shù)組就是為了優(yōu)化二維數(shù)組,節(jié)省內(nèi)存空間2022-09-09
java阿拉伯數(shù)字轉(zhuǎn)中文數(shù)字
這篇文章主要為大家詳細介紹了java實現(xiàn)阿拉伯數(shù)字轉(zhuǎn)換為中文數(shù)字,具有一定的參考價值,感興趣的小伙伴們可以參考一下2019-04-04

