首頁  >  文章  >  Java  >  SpringBoot中如何部署Jar文件

SpringBoot中如何部署Jar文件

WBOY
WBOY轉載
2023-05-24 13:15:23780瀏覽

主要配置:

<build>
    <finalName>${project.artifactId}</finalName>
    <!--
    特别注意:
    项目仅仅是为了演示配置方便,直接在parent的build部分做了插件配置和运行定义。
    但是实际项目中需要把这些定义只放到spring boot模块项目(可优化使用pluginManagement形式),避免干扰其他util、common等模块项目
    -->
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

#設定輸出:

cd package-optimize-level0
mvn clean install

ls -lh package-optimize-app1/target/package-optimize-app1.jar
-rw-r--r--  1 lixia  wheel    16M Feb 24 21:06 package-optimize-app1/target/package-optimize-app1.jar

java -jar package-optimize-app1/target/package-optimize-app1.jar

重點說明:

(目前演示應用僅依賴了spring-boot-starter-web極少組件,所有構建輸出只有十來MB)實際情況單一構建根據項目依賴組件量輸出jar一般在幾十MB到一兩百MB甚至更大。

如果需要部署十幾個微服務,就需要傳輸數GB的文件,這將消耗大量時間。就算是單一更新個別微服務也需要傳輸一、兩百MB。

    Level 1:常見的依賴jar分離建置方式
  • #參考專案目錄:package-optimize-level1

#關解決問題:

降低單一微服務jar的檔案大小,以便部署流程秒傳檔案。主要配置:

重點配置說明請詳見如下註解說明:

    <build>
        <finalName>${project.artifactId}</finalName>
        <!--
        特别注意:
        项目仅仅是为了演示配置方便,直接在parent的build部分做了插件配置和运行定义。
        但是实际项目中需要把这些定义只放到spring boot模块项目(可优化使用pluginManagement形式),避免干扰其他util、common等模块项目
        -->
        <plugins>
            <!-- 拷贝项目所有依赖jar文件到构建lib目录下 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>false</stripVersion>
                            <silent>true</silent>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- Spring Boot模块jar构建 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includes>
                        <!-- 不存在的include引用,相当于排除所有maven依赖jar,没有任何三方jar文件打入输出jar -->
                        <include>
                            <groupId>null</groupId>
                            <artifactId>null</artifactId>
                        </include>
                    </includes>
                    <layout>ZIP</layout>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
  • 設定輸出:

  • cd package-optimize-level1
    mvn clean install
    
    ls -lh package-optimize-app1/target/package-optimize-app1.jar
    -rw-r--r--  1 lixia  wheel   149K Feb 24 20:56 package-optimize-app1/target/package-optimize-app1.jar
    
    java -jar -Djava.ext.dirs=lib package-optimize-app1/target/package-optimize-app1.jar
  • 實現效果:

  • 單一建置根據專案依賴元件量輸出jar一般僅有一兩百KB,基本上可以做到秒傳。

    這個是網路上可見最常見的最佳化方案,值得繼續深入:假如有十來個微服務,每個服務一個jar和一個lib目錄文件,首次部署也差不多需要傳輸一兩個GB檔案。

      Level 2:合併所有模組依賴jar到同一個lib目錄
    • 參考專案目錄:package-optimize-level2
    • #解決問題:

    合併所有模組依賴jar到同一個lib目錄,一般由於各模組專案依賴jar重疊程度很高,合併所有服務部署檔案總計大小基本上也就兩三百MB

    但是如果採用-Djava.ext.dirs=lib加載所有jar到每個JVM,一來每個JVM都完整加載了所有jar耗費資源,二來各微服務元件版本不同會出現版本衝突問題

    #主要設定:##重點配置說明請詳請參閱如下註解說明:

    <build>
        <finalName>${project.artifactId}</finalName>
        <!--
        特别注意:
        项目仅仅是为了演示配置方便,直接在parent的build部分做了插件配置和运行定义。
        但是实际项目中需要把这些定义只放到spring boot模块项目(可优化使用pluginManagement形式),避免干扰其他util、common等模块项目
        -->
        <plugins>
            <!-- 基于maven-jar-plugin插件实现把依赖jar定义写入输出jar的META-INFO/MANIFEST文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <classpathPrefix>lib/</classpathPrefix>
                            <useUniqueVersions>false</useUniqueVersions>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
            <!-- 拷贝项目所有依赖jar文件到构建lib目录下 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <!--
                            各子模块按照实际层级定义各模块对应的属性值,检查所有微服务模块依赖jar文件合并复制到同一个目录
                            详见各子模块中 boot-jar-output 属性定义
                            -->
                            <outputDirectory>${boot-jar-output}/lib</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>false</stripVersion>
                            <silent>false</silent>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- Spring Boot模块jar构建 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includes>
                        <!-- 不存在的include引用,相当于排除所有maven依赖jar,没有任何三方jar文件打入输出jar -->
                        <include>
                            <groupId>null</groupId>
                            <artifactId>null</artifactId>
                        </include>
                    </includes>
                    <layout>ZIP</layout>
                    <!--
                    基于maven-jar-plugin输出微服务jar文件进行二次spring boot重新打包文件的输出目录
                    所有微服务构建输出jar文件统一输出到与lib同一个目录,便于共同引用同一个lib目录
                    详见各子模块中boot-jar-output属性定义
                    -->
                    <!--  -->
                    <outputDirectory>${boot-jar-output}</outputDirectory>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

    所有lib目錄檔案及各微服務建置jar聚合到devops公共目錄。 微服務 jar檔案中的META-INFO/MANIFEST檔案中會產生根據模組依賴元件清單的Class-Path屬性,從而避免了不同版本jar:

    Class-Path: lib/spring-boot-starter-web-2.4.3.jar lib/spring-boot-starte
     r-2.4.3.jar lib/spring-boot-2.4.3.jar lib/spring-boot-autoconfigure-2.4
     .3.jar lib/spring-boot-starter-logging-2.4.3.jar lib/logback-classic-1.
     2.3.jar lib/logback-core-1.2.3.jar lib/slf4j-api-1.7.30.jar lib/log4j-t
     o-slf4j-2.13.3.jar lib/log4j-api-2.13.3.jar lib/jul-to-slf4j-1.7.30.jar
      lib/jakarta.annotation-api-1.3.5.jar lib/spring-core-5.3.4.jar lib/spr
     ing-jcl-5.3.4.jar lib/snakeyaml-1.27.jar lib/spring-boot-starter-json-2
     .4.3.jar lib/jackson-databind-2.11.4.jar lib/jackson-annotations-2.11.4
     .jar lib/jackson-core-2.11.4.jar lib/jackson-datatype-jdk8-2.11.4.jar l
     ib/jackson-datatype-jsr310-2.11.4.jar lib/jackson-module-parameter-name
     s-2.11.4.jar lib/spring-boot-starter-tomcat-2.4.3.jar lib/tomcat-embed-
     core-9.0.43.jar lib/jakarta.el-3.0.3.jar lib/tomcat-embed-websocket-9.0
     .43.jar lib/spring-web-5.3.4.jar lib/spring-beans-5.3.4.jar lib/spring-
     webmvc-5.3.4.jar lib/spring-aop-5.3.4.jar lib/spring-context-5.3.4.jar 
     lib/spring-expression-5.3.4.jar
    • 配置輸出:

      cd package-optimize-level2
      mvn clean install
      
      ls -lh devops/
      total 912
      drwxr-xr-x  34 lixia  wheel   1.1K Feb 24 22:27 lib
      -rw-r--r--   1 lixia  wheel   150K Feb 24 22:31 package-optimize-app1.jar
      -rw-r--r--   1 lixia  wheel   149K Feb 24 22:31 package-optimize-app2.jar
      -rw-r--r--   1 lixia  wheel   149K Feb 24 22:31 package-optimize-app3.jar
      
      java -jar devops/package-optimize-app1.jar
    • 實作效果:

    • #啟動過程不再需要-Djava.ext.dirs=lib 參數定義。

    所有微服務jar引用所有項目合併依賴元件的公共目錄,部署檔案總計大小一般在兩三百MB。

    透過自訂每個微服務jar檔案中的META-INFO/MANIFEST檔案中的Class-Path明確指明依賴版本元件類,解決各微服務不同元件版本衝突問題。

    Level 3:支援system引入的非官方的三方依賴元件
    • 參考項目目錄:package-optimize-level3

    • #解決問題:

    有些非官方三方的諸如sdk jar,一種做法是提交到Maven本地私服中去引用,那和普通依賴jar處理相同;但在沒有maven私服的情況下,常見的簡化做法都是直接在專案中放置依賴jar然後在pom中以system scope方式定義。

    對於在pom中是以systemPath方式引入的,maven-jar-plugin元件沒有直接參數宣告包含指定scope的元件, 如果不做特殊處理META-INFO/MANIFEST中不會出現這些scope定義的元件,導致執行時期類別找不到。

    主要設定:

    重點設定說明請詳見下列註解說明:

    <build>
        <finalName>${project.artifactId}</finalName>
        <!--
        特别注意:
        项目仅仅是为了演示配置方便,直接在parent的build部分做了插件配置和运行定义。
        但是实际项目中需要把这些定义只放到spring boot模块项目(可优化使用pluginManagement形式),避免干扰其他util、common等模块项目
        -->
        <plugins>
            <!-- 基于maven-jar-plugin插件实现把依赖jar定义写入输出jar的META-INFO/MANIFEST文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <classpathPrefix>lib/</classpathPrefix>
                            <useUniqueVersions>false</useUniqueVersions>
                        </manifest>
                        <manifestEntries>
                            <!--
                            有些非官方三方的诸如sdk jar在pom中是以systemPath方式引入的,maven-jar-plugin组件没有直接参数声明包含指定scope的组件
                            通过使用额外定义 Class-Path 值来追加指定依赖组件列表,在子模块按实际情况指定 jar-manifestEntries-classpath 值即可
                            例如(注意前面个点字符及各空格分隔符):. lib/xxx-1.0.0.jar lib/yyy-2.0.0.jar
                            详见各子模块中 boot-jar-output 属性定义示例
                            -->
                            <Class-Path>${jar-manifestEntries-classpath}</Class-Path>
                        </manifestEntries>
                    </archive>
                </configuration>
            </plugin>
            <!-- 拷贝项目所有依赖jar文件到构建lib目录下 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <!--
                            各子模块按照实际层级定义各模块对应的属性值,检查所有微服务模块依赖jar文件合并复制到同一个目录
                            详见各子模块中 boot-jar-output 属性定义
                            -->
                            <outputDirectory>${boot-jar-output}/lib</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>false</stripVersion>
                            <silent>false</silent>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- Spring Boot模块jar构建 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includes>
                        <!-- 不存在的include引用,相当于排除所有maven依赖jar,没有任何三方jar文件打入输出jar -->
                        <include>
                            <groupId>null</groupId>
                            <artifactId>null</artifactId>
                        </include>
                    </includes>
                    <layout>ZIP</layout>
                    <!--
                    基于maven-jar-plugin输出微服务jar文件进行二次spring boot重新打包文件的输出目录
                    所有微服务构建输出jar文件统一输出到与lib同一个目录,便于共同引用同一个lib目录
                    详见各子模块中boot-jar-output属性定义
                    -->
                    <!--  -->
                    <outputDirectory>${boot-jar-output}</outputDirectory>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

    子模組主要設定:

        <properties>
            <!-- 按各模块实际目录层次定义相对数据,使所有服务模块输出资源汇聚到相同目录 -->
            <boot-jar-output>../devops</boot-jar-output>
            <!--
            有些供应商的sdk jar在pom中是以systemPath方式引入的,maven-jar-plugin组件没有直接参数声明包含指定scope的组件
            通过使用额外定义 Class-Path 值来追加指定依赖组件列表,按实际情况指定 jar-manifestEntries-classpath 值即可
            例如(注意前面个点字符及各空格分隔符,lib后面部分是 artifactId-version.jar 格式而不是实际文件名):. lib/xxx-1.0.0.jar lib/yyy-2.0.0.jar
            -->
            <jar-manifestEntries-classpath>. lib/hik-sdk-1.0.0.jar</jar-manifestEntries-classpath>
        </properties>
        <dependencies>
            <!-- 以相对路径方式定义非官方三方依赖组件 -->
            <dependency>
                <groupId>com.hik</groupId>
                <artifactId>hik-sdk</artifactId>
                <version>1.0.0</version>
                <scope>system</scope>
                <systemPath>${project.basedir}/lib/hik-sdk-1.0.0.jar</systemPath>
            </dependency>
    
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
        </dependencies>
    微服務輸出jar檔中的META-INFO/MANIFEST檔中會產生根據模組依賴元件清單的Class-Path屬性, 最前面會追加 jar-manifestEntries-classpath 屬性定義值:

    Class-Path: . lib/hik-sdk-1.0.0.jar lib/spring-boot-starter-web-2.4.3.ja
     r lib/spring-boot-starter-2.4.3.jar lib/spring-boot-2.4.3.jar lib/sprin
     g-boot-autoconfigure-2.4.3.jar lib/spring-boot-starter-logging-2.4.3.ja
     r lib/logback-classic-1.2.3.jar lib/logback-core-1.2.3.jar lib/slf4j-ap
     i-1.7.30.jar lib/log4j-to-slf4j-2.13.3.jar lib/log4j-api-2.13.3.jar lib
     /jul-to-slf4j-1.7.30.jar lib/jakarta.annotation-api-1.3.5.jar lib/sprin
     g-core-5.3.4.jar lib/spring-jcl-5.3.4.jar lib/snakeyaml-1.27.jar lib/sp
     ring-boot-starter-json-2.4.3.jar lib/jackson-databind-2.11.4.jar lib/ja
     ckson-annotations-2.11.4.jar lib/jackson-core-2.11.4.jar lib/jackson-da
     tatype-jdk8-2.11.4.jar lib/jackson-datatype-jsr310-2.11.4.jar lib/jacks
     on-module-parameter-names-2.11.4.jar lib/spring-boot-starter-tomcat-2.4
     .3.jar lib/tomcat-embed-core-9.0.43.jar lib/jakarta.el-3.0.3.jar lib/to
     mcat-embed-websocket-9.0.43.jar lib/spring-web-5.3.4.jar lib/spring-bea
     ns-5.3.4.jar lib/spring-webmvc-5.3.4.jar lib/spring-aop-5.3.4.jar lib/s
     pring-context-5.3.4.jar lib/spring-expression-5.3.4.jar
    • 設定輸出:

      cd package-optimize-level3
      mvn clean install
      
      ls -lh devops/
      total 912
      drwxr-xr-x  36 lixia  wheel   1.1K Feb 24 23:14 lib
      -rw-r--r--@  1 lixia  wheel   150K Feb 24 23:14 package-optimize-app1.jar
      -rw-r--r--   1 lixia  wheel   150K Feb 24 23:14 package-optimize-app2.jar
      -rw-r--r--   1 lixia  wheel   150K Feb 24 23:14 package-optimize-app3.jar
      
      java -jar devops/package-optimize-app1.jar
    • 最終實作效果

    • #所有服務的依賴元件合併到一個目錄,總計大小在兩三百MB,首次部署傳輸效率明顯加速。

    • 各微服務jar一兩百KB大小,日常緊急修復Bug更新個別jar基本上就是瞬間秒傳。

    ###各微服務jar中各自定義依賴指定版本元件列表,不會出現元件不同版本載入衝突問題。 ############非官方的三方依賴元件也能正常引用處理。 ##########

    以上是SpringBoot中如何部署Jar文件的詳細內容。更多資訊請關注PHP中文網其他相關文章!

    陳述:
    本文轉載於:yisu.com。如有侵權,請聯絡admin@php.cn刪除