SpringBoot 项目打包分开lib,配置和资源文件

Posted 一群abc

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot 项目打包分开lib,配置和资源文件相关的知识,希望对你有一定的参考价值。

原文地址:https://blog.csdn.net/u012811805/article/details/80878848

1 jar启动分离依赖lib和配置
  先前发布boot项目的时候,改动一点东西,就需要将整个项目重新打包部署,十分不便,故把依赖lib从项目分离出来,每次部署只需要发布代码即可。
1.1 半自动化步骤
1.1.1 更换maven的jar打包插件
  先前使用的是spring-boot-maven-plugin来打包,这个插件会将项目所有的依赖打入BOOT-INF/lib下,替换为maven-jar-plugin:

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-jar-plugin</artifactId>
      <version>3.1.1</version>
      <configuration>
         <archive>
            <manifest>
               <addClasspath>true</addClasspath>
               <classpathPrefix>lib/</classpathPrefix>
               <mainClass>org.orcrtech.pvpsddp.registry.center.PvpsddpRegistryCenterApplication</mainClass>
            </manifest>
         </archive>
      </configuration>
   </plugin>

  解释:
    a addClasspath表示需要加入到类构建路径
    b classpathPrefix指定生成的Manifest文件中Class-Path依赖lib前面都加上路径,构建出lib/xx.jar

1.1.2 拷贝依赖到jar外面的lib目录

  

<plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-dependency-plugin</artifactId>
      <executions>
         <execution>
            <id>copy-lib</id>
            <phase>package</phase>
            <goals>
               <goal>copy-dependencies</goal>
            </goals>
            <configuration>
               <outputDirectory>target/lib</outputDirectory>
               <excludeTransitive>false</excludeTransitive>
               <stripVersion>false</stripVersion>
               <includeScope>runtime</includeScope>
            </configuration>
         </execution>
      </executions>
   </plugin>

  

1.1.3 在和jar包同级的目录下新建一个config目录,放入application.yml文件
  这里可能有小伙伴有疑问了,打包的jar里面不是应该有application.yml文件吗,这里为什么再放一份?
  这是因为boot读取配置有一个优先级,放在jar包外面config目录优先级最高,主要是便于从外部修改配置,而不是改jar包中的application.yml文件。优先级如下:
    当前目录的config目录下
    当前目录
    classpath的config目录下
    classpath的根目录

1.1.4 启动项目
  加入–debug可以让你可以看到比较详细的启动日志:
    java -jar xxx-1.0.0.jar --debug

 

1.2 全自动化步骤
  前面介绍的步骤中,需要手动的拷贝application.yml文件,并且jar包内外都存在配置,总感觉怪怪的(偷笑…)。这里引入一种自动化配置,将所有东西打成zip文件,直接发布到服务目录,解压后,即可启动。
1.2.1 指定打包插件
  如上。
1.2.2 拷贝依赖的插件。
  如上。
1.2.3 自动化步骤2
  排除resources下面的yml(因为我们需要把它放在jar外部,不能让jar打包插件将其打入jar包classpath下去)

<resources>
        <resource>
            <directory>src/main/resources</directory>
            <excludes>
                <exclude>**/application.yml</exclude>
            </excludes>
        </resource>
</resources>

  上面这种排除*.yml配置文件的办法,会在IDEA编译器启动的时候报错,下面的排除方法不会引起报错:

<plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-jar-plugin</artifactId>
   <configuration>
      <archive>
         <manifest>
            <addClasspath>true</addClasspath>
            <classpathPrefix>lid/</classpathPrefix>
            <mainClass>org.orcrtech.pvpsddp.structure.management.PvpsddpStructureManagementApplication</mainClass>
         </manifest>
      </archive>
      <!-- 排除配置文件 -->
      <excludes >
         <exclude>*.yml</exclude>
      </excludes>
   </configuration>
</plugin>

1.2.4 使用maven-assembly-plugin自定义打包
  具体打包详情在assembly.xml配置中指定

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
         <!-- 打包后的包名是否包含assembly的id名 -->
        <appendAssemblyId>false</appendAssemblyId>
          <!-- 指定最后tar或者zip包的名字 -->
          <finalName>gateway</finalName>
          <!-- tar或者zip包的输出目录 -->
          <!-- ../ 是指当前项目的根目录 ,例如:F:\\pvpsddp\\pvpsddp-gateway 的上一级-->
          <outputDirectory>F:\\pvpsddp\\tar</outputDirectory>
        <descriptors>
              <!-- 引用的assembly配置文件,可以用多个,即可以同时打包多个格式的包 -->
            <descriptor>src/main/resources/assembly.xml</descriptor>
        </descriptors>
    </configuration>
    <executions>
      <!-- phase加入package后,则在执行maven package时就可以调用maven-assembly-plugin插件定义的打包方式 -->
        <execution>
          <!--名字任意 -->
            <id>make-assembly</id>
           <!-- 绑定到package生命周期阶段上 -->
            <phase>package</phase>
            <goals>
               <!-- 只运行一次 --> 
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

  注:
    生成的tar.gz文件的名字为:maven-assembly-plugin插件中配置的 “finalName-assembly.xml配置的id”(若assembly中没有指定id,则只有前半部分。
    assembly.xml具体配置如下:
    将application.yml放在外部config目录下
    所有依赖打成zip压缩包(还可以打成其他类型包https://www.cnblogs.com/f-zhao/p/6929814.html

<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd">
<id>package</id>
<formats>
    <format>zip</format>
</formats>
<includeBaseDirectory>true</includeBaseDirectory>
<fileSets>
    <fileSet>
        <directory>${basedir}/src/main/resources</directory>
        <includes>
            <include>*.yml</include>
        </includes>
        <filtered>true</filtered>
        <outputDirectory>${file.separator}config</outputDirectory>
    </fileSet>

    <fileSet>
        <!-- 需要打包的路径 -->
        <directory>src/main/resources/runScript</directory>
        <!-- 打包后输出的路径,自定义 -->
        <outputDirectory>${file.separator}bin</outputDirectory>
    </fileSet>
    <fileSet>
        <directory>${project.build.directory}/lib</directory>
        <outputDirectory>${file.separator}lib</outputDirectory>
        <!-- 打包需要包含的文件 -->
        <includes>
            <include>*.jar</include>
        </includes>
    </fileSet>
    <fileSet>
        <directory>${project.build.directory}</directory>
        <outputDirectory>${file.separator}</outputDirectory>
        <includes>
            <include>*.jar</include>
        </includes>
    </fileSet>
</fileSets>
</assembly>

 

以上是关于SpringBoot 项目打包分开lib,配置和资源文件的主要内容,如果未能解决你的问题,请参考以下文章

Springboot项目打包引入lib目录下jar包

SpringBoot – 将项目代码与依赖jar包分开打包教程

SpringBoot微服务项目打包成Docker镜像详解

SpringBoot应用打包瘦身配置总结

springboot项目打包优化(迁移第三方依赖jar配置文件到项目jar外)

springboot项目打包优化(迁移第三方依赖jar配置文件到项目jar外)