教你1秒將本地SpringBoot專案jar包部署到Linux環境(超詳細!)

2023-09-06 22:00:11

目標

一鍵將本地已經打包好的SpringBoot專案部署到linux環境，實現秒級部署
前置知識：需掌握Maven的打包

迭代步驟

在windows環境使用命令啟動SpringBoot專案
在Linux環境使用命令啟動專案
在Linux環境使用指令碼啟動專案
優化指令碼，每次重啟時先關閉專案
分離依賴，每次上傳Linux環境只上傳幾百k的程式碼包
搭配IDEA外掛，實現在IDEA中一鍵部署

一、前提：

有一個Windows環境可以啟動的SpringBoot專案jar包

1、使用Maven的package命令打出一個攜帶依賴的jar包

例如：

2、Window啟動jar包

java -jar SpringBootTest-0.0.1-SNAPSHOT.jar

啟動完畢，說明jar包是可以正常啟動的。

二、linux環境啟動jar包

1、先將jar包扔到linux環境

2、測試是否可以啟動（需要有Java環境）

java -jar SpringBootTest-0.0.1-SNAPSHOT.jar

說明在Linux環境也是可以正常啟動的

但是以上的啟動方式有個問題，視窗一關專案就自動關閉了

3、優化啟動指令碼，改為後臺啟動，並將紀錄檔輸出到springboot.log

nohup java -jar SpringBootTest-0.0.1-SNAPSHOT.jar > springboot.log &

啟動成功，程序號為9777

以上的指令碼也存在問題，第二次啟動的時候，會因為已經啟動了一個服務，埠佔用啟動不了

4、完善指令碼，啟動時，如果存在已經啟動的服務，先關閉，再啟動

建立指令碼

vim start.sh

指令碼內容

# 關閉程式
# fileName為jar包的名稱
fileName=SpringBootTest-0.0.1-SNAPSHOT.jar
pid=$(ps -ef | grep $fileName| grep -v "grep" | awk '{print $2}')
kill -9 $pid

# 啟動專案
nohup java -jar $fileName > springboot.log &

之後，啟動專案就可以

sh start.sh

至此，SpringBoot專案在Linux的啟動就說明完畢。

但是，以上的部署方式還存在一些問題，在只有web依賴的時候，jar的大小就已經達到17M，

而在實際開發中，jar包的大小甚至會到達一百多兆。例如這樣：

為什麼明明沒有多少程式碼，包的大小卻這麼大呢？

解壓SpringBootTest-0.0.1-SNAPSHOT.jar包檢視內容

可以看出，lib資料夾佔用了16.7M，而lib資料夾裡面是什麼東西呢？

可以看到，就是各種的依賴。

所以，就引發了新的優化方向，能不能將依賴包直接放在伺服器上，每次只更新自己的程式碼？

答案是：可以！在實際開發中，依賴包一般來說是不會動的，於是開始第三步。

三、分離依賴部署

1.上傳依賴jar包Linux伺服器

（1）建立lib資料夾

mkdir lib

（2）將jar包中的/BOOT-INF/lib目錄底下的jar包全部上傳到Linux伺服器的lib資料夾

2.改造專案的pom.xml檔案

增加設定：

    <build>
        <plugins>
            <!-- 解決jar中沒有主清單屬性問題 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>com.example.springboottest.SpringBootTestApplication</mainClass>
                    <!-- jar包不攜帶依賴設定開始-->
                    <layout>ZIP</layout>
                    <includes>
                        <include>
                            <groupId>nothing</groupId>
                            <artifactId>nothing</artifactId>
                        </include>
                    </includes>
                    <!-- jar包不攜帶依賴部署設定結束-->
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

3.重新package

新生成的jar包僅僅只有156kb！

4.上傳到伺服器

這時候，如果使用原本的指令碼啟動就會報錯：

5.使用-Dloader.path指定外部依賴包

（1）增加啟動檔案start2.sh

cp start.sh start2.sh

（2）在java -jar後追加-Dloader.path=./lib

# 關閉程式
fileName=SpringBootTest-0.0.1-SNAPSHOT.jar
pid=$(ps -ef | grep $fileName| grep -v "grep" | awk '{print $2}')
kill -9 $pid

# 啟動專案
nohup java -jar -Dloader.path=./lib  $fileName > springboot.log &

使用外部依賴啟動成功

到此，使用外部依賴啟動就完成了，只要加上-Dloader.path=./lib就可以了

6.合併start.sh和start2.sh指令碼

第五步還存在的一個問題，雖然這個方法很好用，但是又增加了一個指令碼。公司內部，總是有人想要打全量包，使用自帶的依賴，有的人想要打不攜帶依賴的包，可以快速部署啟動，這時候，就需要區分，到底是要用start.sh指令碼還是start2.sh指令碼，於是，將start.sh和start2.sh指令碼進行合併，大於10M的時候，就使用內部依賴，小於10M的時候就使用外部依賴

合併後的start.sh指令碼：

# 關閉程式
fileName=SpringBootTest-0.0.1-SNAPSHOT.jar
pid=$(ps -ef | grep $fileName| grep -v "grep" | awk '{print $2}')
kill -9 $pid

# 獲取jar包的大小
filesize=`ls -l $fileName | awk '{ print $5 }'`
# 多少M以上使用外部依賴
maxsize=$((1024 * 1024 * 10)) # 10M

if [ $filesize -gt $maxsize ]
then
  echo "檔案大小為【$filesize】，使用內部依賴啟動"
  nohup java -jar -Dloader.path=./lib  $fileName > springboot.log &
else
  echo "檔案大小為【$filesize】,使用外部依賴啟動"
  nohup java -jar $fileName > springboot.log &
fi

適配兩種情況

小於10M的jar包使用外部依賴