Jenkins一鍵打包部署SpringBoot應(yīng)用步驟詳解
本文介紹使用Jenkins一鍵將SpringBoot應(yīng)用打包并上傳到生產(chǎn)環(huán)境服務(wù)器運行,這里使用的是直接在服務(wù)器上運行FagJar的方式,首先確保服務(wù)器環(huán)境配置好,安裝必須的JDK運行時環(huán)境,運行目錄,日志存放目錄等。
一、服務(wù)器環(huán)境配置
??關(guān)于JDK的選擇,自1.8版本收費之后,我們大多數(shù)選擇openjdk作為生產(chǎn)環(huán)境的運行時環(huán)境,和大多數(shù)軟件安裝包一樣,在CentOS服務(wù)器上,我們可以選擇yum方式和下載壓縮包的方式進行安裝。大多數(shù)情況下使用yum方式比較簡單方便。也有特殊情況,一些安全要求高單位或系統(tǒng),只允許在局域網(wǎng)內(nèi)運行,此時就需要選擇壓縮包的方式進行安裝了。
1. yum方式安裝openjdk
- 查詢當前CentOS系統(tǒng)可以安裝的openjdk版本,我們只需要運行時環(huán)境,所以java-11-openjdk.x86_64是我們需要安裝的包,實際相當于jre運行時;里面還有一個包java-11-openjdk-devel.x86_64,這個包是傳統(tǒng)意義的jdk就是包含開發(fā)和打包工具,在生產(chǎn)環(huán)境,沒有需要我們可以不安裝。
yum search java | grep -i --color openjdk
[root@localhost ~]# yum search java | grep -i --color openjdk
openjdk-asmtools-javadoc.noarch : Javadoc for openjdk-asmtools
icedtea-web.x86_64 : Additional Java components for OpenJDK - Java browser
java-1.6.0-openjdk.x86_64 : OpenJDK Runtime Environment
java-1.6.0-openjdk-demo.x86_64 : OpenJDK Demos
java-1.6.0-openjdk-devel.x86_64 : OpenJDK Development Environment
java-1.6.0-openjdk-javadoc.x86_64 : OpenJDK API Documentation
java-1.6.0-openjdk-src.x86_64 : OpenJDK Source Bundle
java-1.7.0-openjdk.x86_64 : OpenJDK Runtime Environment
java-1.7.0-openjdk-accessibility.x86_64 : OpenJDK accessibility connector
java-1.7.0-openjdk-demo.x86_64 : OpenJDK Demos
java-1.7.0-openjdk-devel.x86_64 : OpenJDK Development Environment
java-1.7.0-openjdk-headless.x86_64 : The OpenJDK runtime environment without
java-1.7.0-openjdk-javadoc.noarch : OpenJDK API Documentation
java-1.7.0-openjdk-src.x86_64 : OpenJDK Source Bundle
java-1.8.0-openjdk.i686 : OpenJDK Runtime Environment 8
java-1.8.0-openjdk.x86_64 : OpenJDK 8 Runtime Environment
java-1.8.0-openjdk-accessibility.i686 : OpenJDK accessibility connector
java-1.8.0-openjdk-accessibility.x86_64 : OpenJDK accessibility connector
java-1.8.0-openjdk-demo.i686 : OpenJDK Demos 8
java-1.8.0-openjdk-demo.x86_64 : OpenJDK 8 Demos
java-1.8.0-openjdk-devel.i686 : OpenJDK Development Environment 8
java-1.8.0-openjdk-devel.x86_64 : OpenJDK 8 Development Environment
java-1.8.0-openjdk-headless.i686 : OpenJDK Headless Runtime Environment 8
java-1.8.0-openjdk-headless.x86_64 : OpenJDK 8 Headless Runtime Environment
java-1.8.0-openjdk-javadoc.noarch : OpenJDK 8 API documentation
java-1.8.0-openjdk-javadoc-zip.noarch : OpenJDK 8 API documentation compressed
java-1.8.0-openjdk-src.i686 : OpenJDK Source Bundle 8
java-1.8.0-openjdk-src.x86_64 : OpenJDK 8 Source Bundle
java-11-openjdk.i686 : OpenJDK Runtime Environment 11
java-11-openjdk.x86_64 : OpenJDK 11 Runtime Environment
java-11-openjdk-demo.i686 : OpenJDK Demos 11
java-11-openjdk-demo.x86_64 : OpenJDK 11 Demos
java-11-openjdk-devel.i686 : OpenJDK Development Environment 11
java-11-openjdk-devel.x86_64 : OpenJDK 11 Development Environment
java-11-openjdk-headless.i686 : OpenJDK Headless Runtime Environment 11
java-11-openjdk-headless.x86_64 : OpenJDK 11 Headless Runtime Environment
java-11-openjdk-javadoc.i686 : OpenJDK 11 API documentation
java-11-openjdk-javadoc.x86_64 : OpenJDK 11 API documentation
java-11-openjdk-javadoc-zip.i686 : OpenJDK 11 API documentation compressed in a
java-11-openjdk-javadoc-zip.x86_64 : OpenJDK 11 API documentation compressed in
java-11-openjdk-jmods.i686 : JMods for OpenJDK 11
java-11-openjdk-jmods.x86_64 : JMods for OpenJDK 11
java-11-openjdk-src.i686 : OpenJDK Source Bundle 11
java-11-openjdk-src.x86_64 : OpenJDK 11 Source Bundle
java-11-openjdk-static-libs.i686 : OpenJDK libraries for static linking 11
java-11-openjdk-static-libs.x86_64 : OpenJDK 11 libraries for static linking
openjdk-asmtools.noarch : To develop tools create proper & improper Java
openprops.noarch : An improved java.util.Properties from OpenJDK
- 選擇openjdk11,執(zhí)行安裝命令
sudo yum install java-11-openjdk.x86_64 -y
- 此時執(zhí)行java -version可以看到已安裝版本,使用which java可以看到j(luò)ava執(zhí)行路徑為/usr/bin/java,但這里不是openjdk的真實安裝路徑,需要通過命令dirname查看真實路徑。
[root@localhost /]# java -version
openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment (Red_Hat-11.0.20.0.8-1.el7_9) (build 11.0.20+8-LTS)
OpenJDK 64-Bit Server VM (Red_Hat-11.0.20.0.8-1.el7_9) (build 11.0.20+8-LTS, mixed mode, sharing)
[root@localhost /]# which java
/usr/bin/java
- 查看openjdk真實安裝路徑,用此路徑配置JAVA_HOME
[root@localhost /]# dirname $(readlink $(readlink $(which java)))
/usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64/bin
- 使用vi /etc/profile編輯profile文件,按i編輯,在文件底部加入一下配置,按:wq!保存退出。
JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64
PATH=$JAVA_HOME/bin:$PATH
export PATH JAVA_HOME
- 執(zhí)行source /etc/profile命令, 讓profile文件立即生效。
[root@localhost /]# source /etc/profile
[root@localhost /]# echo $JAVA_HOME
/usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64
??執(zhí)行完以上操作之后,Java運行時環(huán)境就安裝配置好了,但是一定要注意:PATH在配置的時候,一定要把$JAVA_HOME/bin放在前面,不然系統(tǒng)中安裝有多個版本的JDK,那么在使用java命令時,系統(tǒng)會找到其他版本的Java。還有以前很多教程配置中的CLASSPATH和tools.jar在JDK1.5以后就不需要配置了。
2. 部署及備份目錄準備
- 新建 /opt/tmp 目錄,用于Jenkins打包后,通過 Publish Over SSH插件將包傳輸?shù)椒?wù)器的臨時目錄。
- 新建 /opt/bak 目錄,用于存儲所有部署過的包備份,方便后續(xù)版本回滾。此目錄可能會占用很大空間,所以需要選擇一個磁盤空間大的掛載目錄。
- 新建 /opt/script 目錄,用于Jenkins將包傳輸完成之后,執(zhí)行安裝、備份操作的相關(guān)命令腳本。
- 新建 /data/container/server,作為服務(wù)的運行目錄,服務(wù)FatJar也會部署到此目錄。
mkdir -p /opt/tmp /opt/bak /opt/script /data/container/server
chmod -R 777 /opt/tmp /opt/bak /opt/script /data/container/server
3. 部署腳本編寫說明
- 定義入?yún)?,可以通過Jenkins任務(wù)將參數(shù)傳入腳本中,我們定義了下面3個參數(shù):
project_name=gitegg-server : 服務(wù)名稱server_port=8080 : 服務(wù)端口號server_path=“/data/container/server” : 服務(wù)運行路徑 - 對參數(shù)進行檢查,是否未傳入?yún)?shù),這里根據(jù)自己的實際情況判斷,比如必須傳入哪些參數(shù),就設(shè)置參數(shù)的個數(shù)不能小于幾。
echo "param validate"
if [ $# -lt 1 ]; then
echo "you must use like this : ./publish_gitegg_server.sh [projectname] [server port] [server home dir]"
exit
fi
- 入?yún)①x值,如果有參數(shù)傳入,則取服務(wù)參數(shù),如果沒有參數(shù)傳入則取默認值
if [ "$1" != "" ]; then
project_name="$1"
fi
if [ "$2" != "" ]; then
server_port="$2"
fi
if [ "$3" != "" ]; then
server_path="$3"
fi
- Jenkins調(diào)用sh命令時,可能會找不到JAVA_HOME,導(dǎo)致服務(wù)無法運行,所以在次數(shù)在配置一下
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64
- 停止服務(wù)
#check server process
server_pid=`/usr/sbin/lsof -n -P -t -i :$server_port`
echo "current :" $server_pid
#shutdown server
kill -9 $server_pid
echo "server shutting down"
while [ -n "$server_pid" ]
do
sleep 5
server_pid=`/usr/sbin/lsof -n -P -t -i :$server_port`
echo "scan server pid :" $server_pid
done
echo "server shutt down"
- 部署服務(wù)運行的FatJar
#publish project
echo "scan no server pid,$project_name publishing"
rm -rf "$server_path"/$project_name*.jar
cp /opt/tmp/$project_name*.jar "$server_path"/$project_name.jar
- 備份本次發(fā)布的FatJar
#bak project
BAK_DIR=/opt/bak/$project_name/`date +%Y%m%d`
mkdir -p "$BAK_DIR"
cp "$server_path"/$project_name.jar "$BAK_DIR"/"$project_name"_`date +%H%M%S`.jar
#remove tmp
rm -rf /opt/tmp/$project_name*.jar
- 執(zhí)行運行命令
cd "$server_path"
source /etc/profile
nohup java -jar -Xms4096m -Xmx4096m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m "$project_name".jar --server.port="$server_port" > log.file 2>&1 &
- 打印執(zhí)行完成的命令
echo "Server is starting,please try to access $container_name conslone url"
- 完整的安裝部署腳本
project_name=gitegg-server
server_port=8080
server_path="/data/container/server"
#param validate
if [ $# -lt 1 ]; then
echo "you must use like this : ./publish_qxq_server.sh [projectname] [server port] [server home dir]"
exit
fi
if [ "$1" != "" ]; then
project_name="$1"
fi
if [ "$2" != "" ]; then
server_port="$2"
fi
if [ "$3" != "" ]; then
server_path="$3"
fi
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64
#check server process
server_pid=`/usr/sbin/lsof -n -P -t -i :$server_port`
echo "current :" $server_pid
#shutdown server
kill -9 $server_pid
echo "server shutting down"
while [ -n "$server_pid" ]
do
sleep 5
server_pid=`/usr/sbin/lsof -n -P -t -i :$server_port`
echo "scan server pid :" $server_pid
done
echo "server shutt down"
#publish project
echo "scan no server pid,$project_name publishing"
rm -rf "$server_path"/$project_name*.jar
cp /opt/tmp/$project_name*.jar "$server_path"/$project_name.jar
#bak project
BAK_DIR=/opt/bak/$project_name/`date +%Y%m%d`
mkdir -p "$BAK_DIR"
cp "$server_path"/$project_name.jar "$BAK_DIR"/"$project_name"_`date +%H%M%S`.jar
#remove tmp
rm -rf /opt/tmp/$project_name*.jar
#start server
cd "$server_path"
source /etc/profile
nohup java -jar -Xms4096m -Xmx4096m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m "$project_name".jar --server.port="$server_port" > log.file 2>&1 &
echo "Server is starting,please try to access $project_name conslone url"
- 將部署腳本上傳到服務(wù)器的/opt/script目錄下,并賦予可執(zhí)行權(quán)限
chmod 755 publish_server.sh
二、新建Jenkins配置打包任務(wù),部署SpringBoot應(yīng)用
1. Dashboard > 新建任務(wù),輸入任務(wù)名稱,選擇“構(gòu)建一個maven項目”,點擊確定。
2. 項目配置,進入到任務(wù)配置頁
- 丟棄舊的構(gòu)建 :這里在保持構(gòu)建的最大個數(shù)填寫5,當然可以根據(jù)自己情況填寫,否則舊的構(gòu)建包會一直存在占用磁盤空間。
- 源碼管理:配置git代碼地址、用戶名密碼和版本分支,如果是需要用戶名密碼的git庫,那么下面需要選擇訪問的用戶名密碼,這里一定要使用用戶名密碼方式,使用token的方式無法選中??梢栽谙路絘dd,也可以在Jenkins全局Credentials 中添加,方便其它任務(wù)使用。
- 構(gòu)建觸發(fā)器:可選可不選,這個根據(jù)自己的需求選擇,任務(wù)在什么情況下出發(fā)構(gòu)建。
- 構(gòu)建環(huán)境:這里不需要選擇,在介紹構(gòu)建NodeJS項目時,需要選中NodeJS環(huán)境。
- Build:這里填寫Maven打包命令,可以添加參數(shù)選擇打包環(huán)境test或prod等。
- Post Steps:將打包后的文件發(fā)送到服務(wù)器,并執(zhí)行設(shè)置好的腳本,這里選擇Run only if build succeeds,當構(gòu)建成功時Post。
- Exec command:將打好的包發(fā)布到環(huán)境之后,在環(huán)境上執(zhí)行的部署腳本命令。/opt/script/publish_server.sh 是腳本文件、gitegg-application是項目名稱、8182 是項目端口號、/data/container/server 是jar包存放路徑。
/opt/script/publish_server.sh gitegg-application 8182 /data/container/server
3. 運行構(gòu)建任務(wù)
- 立即構(gòu)建
- 查看構(gòu)建日志:點擊立即構(gòu)建之后,下方會出現(xiàn)進度條,點擊進度條就可以進入構(gòu)建日志界面。
4、構(gòu)建成功后,下方會給出構(gòu)建成功提示,此時登錄遠程服務(wù)器查看文件是否部署成功即可。
舉報
評論 1