Jenkins一鍵打包部署SpringBoot應用步驟詳解

作者：AI全棧程序猿 2023-09-08 23:30:19

關于JDK的選擇，自1.8版本收費之后，我們大多數選擇openjdk作為生產環境的運行時環境，和大多數軟件安裝包一樣，在CentOS服務器上，我們可以選擇yum方式和下載壓縮包的方式進行安裝。

本文介紹使用Jenkins一鍵將SpringBoot應用打包并上傳到生產環境服務器運行，這里使用的是直接在服務器上運行FagJar的方式，首先確保服務器環境配置好，安裝必須的JDK運行時環境，運行目錄，日志存放目錄等。

一、服務器環境配置

??關于JDK的選擇，自1.8版本收費之后，我們大多數選擇openjdk作為生產環境的運行時環境，和大多數軟件安裝包一樣，在CentOS服務器上，我們可以選擇yum方式和下載壓縮包的方式進行安裝。大多數情況下使用yum方式比較簡單方便。也有特殊情況，一些安全要求高單位或系統，只允許在局域網內運行，此時就需要選擇壓縮包的方式進行安裝了。

1. yum方式安裝openjdk

查詢當前CentOS系統可以安裝的openjdk版本，我們只需要運行時環境，所以java-11-openjdk.x86_64是我們需要安裝的包，實際相當于jre運行時；里面還有一個包java-11-openjdk-devel.x86_64，這個包是傳統意義的jdk就是包含開發和打包工具，在生產環境，沒有需要我們可以不安裝。

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，執行安裝命令

sudo yum install java-11-openjdk.x86_64 -y

此時執行java -version可以看到已安裝版本，使用which java可以看到java執行路徑為/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

執行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

??執行完以上操作之后，Java運行時環境就安裝配置好了，但是一定要注意：PATH在配置的時候，一定要把$JAVA_HOME/bin放在前面，不然系統中安裝有多個版本的JDK，那么在使用java命令時，系統會找到其他版本的Java。還有以前很多教程配置中的CLASSPATH和tools.jar在JDK1.5以后就不需要配置了。

2. 部署及備份目錄準備

新建 /opt/tmp 目錄，用于Jenkins打包后，通過 Publish Over SSH插件將包傳輸到服務器的臨時目錄。
新建 /opt/bak 目錄，用于存儲所有部署過的包備份，方便后續版本回滾。此目錄可能會占用很大空間，所以需要選擇一個磁盤空間大的掛載目錄。
新建 /opt/script 目錄，用于Jenkins將包傳輸完成之后，執行安裝、備份操作的相關命令腳本。
新建 /data/container/server，作為服務的運行目錄，服務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. 部署腳本編寫說明

定義入參，可以通過Jenkins任務將參數傳入腳本中，我們定義了下面3個參數：
project_name=gitegg-server ：服務名稱server_port=8080 ：服務端口號server_path=“/data/container/server” ：服務運行路徑
對參數進行檢查，是否未傳入參數，這里根據自己的實際情況判斷，比如必須傳入哪些參數，就設置參數的個數不能小于幾。

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

入參賦值，如果有參數傳入，則取服務參數，如果沒有參數傳入則取默認值

if [ "$1" != "" ]; then
   project_name="$1"
fi
if [ "$2" != "" ]; then
   server_port="$2"
fi
if [ "$3" != "" ]; then
   server_path="$3"
fi

Jenkins調用sh命令時，可能會找不到JAVA_HOME，導致服務無法運行，所以在次數在配置一下

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"

部署服務運行的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

備份本次發布的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

執行運行命令

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 $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"

將部署腳本上傳到服務器的/opt/script目錄下，并賦予可執行權限

chmod 755 publish_server.sh

二、新建Jenkins配置打包任務，部署SpringBoot應用

1. Dashboard > 新建任務，輸入任務名稱，選擇“構建一個maven項目”，點擊確定。

2. 項目配置，進入到任務配置頁

丟棄舊的構建：這里在保持構建的最大個數填寫5，當然可以根據自己情況填寫，否則舊的構建包會一直存在占用磁盤空間。

源碼管理：配置git代碼地址、用戶名密碼和版本分支，如果是需要用戶名密碼的git庫，那么下面需要選擇訪問的用戶名密碼，這里一定要使用用戶名密碼方式，使用token的方式無法選中。可以在下方add，也可以在Jenkins全局Credentials 中添加，方便其它任務使用。

構建觸發器：可選可不選，這個根據自己的需求選擇，任務在什么情況下出發構建。

構建環境：這里不需要選擇，在介紹構建NodeJS項目時，需要選中NodeJS環境。

Build：這里填寫Maven打包命令，可以添加參數選擇打包環境test或prod等。

Post Steps：將打包后的文件發送到服務器，并執行設置好的腳本，這里選擇Run only if build succeeds，當構建成功時Post。

Exec command：將打好的包發布到環境之后，在環境上執行的部署腳本命令。/opt/script/publish_server.sh 是腳本文件、gitegg-application是項目名稱、8182 是項目端口號、/data/container/server 是jar包存放路徑。

/opt/script/publish_server.sh gitegg-application 8182 /data/container/server

3. 運行構建任務

立即構建

查看構建日志：點擊立即構建之后，下方會出現進度條，點擊進度條就可以進入構建日志界面。

4、構建成功后，下方會給出構建成功提示，此時登錄遠程服務器查看文件是否部署成功即可。

舉報

評論 1

責任編輯：武曉燕來源：今日頭條

JDK openjdk