前言
本文主要介绍 SpringBoot 的一些打包事项和项目部署以及在其中遇到一些问题的解决方案.
SpringBoot 打包
在 SpringBoot 打包这块, 我们就用之前的一个 web 项目来进行打包.
首先需要明确的是, 该项目打包的形态是可执行的 jar 包, 还是在 tomcat 下运行的 war 包.
虽然本项目是用 maven 构建的, 用 maven 打包也更加方便, 但是这里也说明普通非 maven 打包的项目如何打包.
Maven 打包
首先是 maven 方式打包:
如果是 jar 包
需在 pom.xml 指定打成的包为:
<packaging>jar</packaging>
如果是 war 包.
需在 pom.xml 指定打成的包为:
<packaging>war</packaging>
并通过 < scope > 标签在打包的时候排除 tomcat 依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
然后添加 SpringBoot 自带的打包方式
示例如下:
<build>
<defaultGoal>compile</defaultGoal>
<sourceDirectory>src</sourceDirectory>
<finalName>springboot-package</finalName>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin </artifactId>
<configuration>
<fork>true</fork>
<mainClass>com.pancm.App</mainClass>
</configuration>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
注:<finalName > 标签是指定打包之后的名称,<mainClass > 是指定 main 函数.
也可以不用 SpringBoot 自带的打包方式, 使用 maven 的 assembly 插件进行打包.
示例如下:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.5.5</version>
<configuration>
<archive>
<manifest>
<mainClass>com.pancm.App</mainClass>
- </manifest>
- </archive>
- <descriptorRefs>
- <descriptorRef>jar-with-dependencies</descriptorRef>
- </descriptorRefs>
- </configuration>
- </plugin>
- </plugins>
- </build>
在 pom.xml 中添加完相应的标签之后, 我们只需在项目同级 (pom.xml 同级) 输入
mvn clean package
即可完成打包
如果想排除测试代码, 则可以输入:
mvn clean package -Dmaven.test.skip=true
来进行打包.
一般我们是把 application.properties 和 logback.xml 文件放在 resources 文件夹中, 但是进行打包之后, 它们也会包含在 jar 或 war 包中, 如果我们想更改配置, 则会比较麻烦.
如果想将它们和项目放在同级目录下, application.properties 可以直接移出和项目同级的目录下, 因为 Spring 程序会按优先级从下面这些路径来加载 application.properties 配置文件:
当前目录下的 / config 目录
当前目录
classpath 里的 / config 目录
classpath 根目录
springboot 默认加载的 logback 是在 classpath 目录下, 这时我们只需要在 application.properties 配置文件指定 logback.xml 的路径即可.
添加如下:
logging.config=logback.xml
如果引入了第三方的 jar 包, 但是又无法通过 maven 私服进行下载, 这时可以手动进行编译.
例如, 我写了一个工具类为 Mytools, 然后把它打成了一个 jar 包, 然后放在我的这个项目中 lib 目录下, 并且需要引用它, 那么此时便可以对该 jar 包进行编译到本地仓库中, 然后再 pom.xml 添加相应的名称和版本号.
命令示例:
mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar
pom.xml 添加
<dependency>
<groupId>com.panncm.utils</groupId>
<artifactId>pancm-utils</artifactId>
<version>1.0</version>
</dependency>
便可以进行打包了.
普通项目打包
如果是普通的项目, 没有使用 maven 构建的话, 可以使用 eclipse 等工具进行打包.
如果是 jar 包
首先在 eclipse 中运行该项目(main 方法运行), 然后在 eclipse 中右键项目
export ->java -> runnable jar file-> package required libraries into generated jar
指定 main 方法, 然后选择打包的名称以及打包的路径. 点击 finish 完成打包.
如果是 war 包
在 eclipse 中右键项目
export ->web -> war file
, 然后选择打包的名称以及打包的路径. 点击 finish 完成打包.
Ant 打包
介绍了上述两种打包之后, 这里介绍下通过 ant 方法进行打包(需要安装 ant 环境, 安装方式基本和 maven 一致, 指定路径, 配置环境变量, 这里就不在过多讲述了).
一般打包之后, 我们需要将包和配置文件放在一个目录下, 这时我们又不想手动进行复制粘贴的话, 就可以用 ant 来进行打包, 将打包的文件整合在一起.
这里我们就编写一个 build.xml 的配置文件.
- <?xml version="1.0" encoding="UTF-8"?>
- <project name="springboot-package" default="copyAll" basedir=".">
- <property name="build" value="build" />
- <property name="target" value="target" />
- <target name="clean">
- <delete dir="${target}" />
- <delete dir="${build}" />
- </target>
- <target name="create-path" depends="clean">
- <mkdir dir="${build}" />
- </target>
- <target name="mvn_package" depends="create-path">
- <exec executable="cmd" failonerror="true">
- <arg line="/c mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar" />
- </exec>
- <exec executable="cmd" failonerror="true">
- <arg line="/c mvn clean package" />
- </exec>
- </target>
- <target name="copyAll" depends="mvn_package">
- <copy todir="${build}" file="${target}/springboot-package.jar"></copy>
- <copy todir="${build}" file="logback.xml"></copy>
- <copy todir="${build}" file="application.properties"></copy>
- <copy todir="${build}" file="run.bat"></copy>
- </target>
- </project>
注:
<mkdir dir="${build}" />
是指定文件存放的文件夹, executable 是使用 cmd 命令, line 是执行的语句, 标签是将文件复制到指定的文件夹中.
然后再新建一个 build.bat 文件, 里面只需要填写 ant 就行了.
准备完之后, 只需双击 build.bat, 项目和配置文件就自动到 build 文件中了, 省去了很多操作.
虽然现在流行通过 jenkins 进行打包部署, 不过使用 ant 加 maven 进行打包也不错的, 比较简单.
SpringBoot 部署
如果是 jar 项目
Windows 系统在项目同级目录下输入:
java -jar springboot-package
即可启动项目.
关闭项目, 只需关掉 dos 界面就可以了.
也可以写一个 bat 文件进行运行.
Linux 系统在项目同级目录下输入:
nohup -jar springboot-package &
即可启动.
关闭输入:
kill -9 pid(jar 的进程 id)
也可以在 init.d 注册一个服务
示例:
- ln -s /home/jars/app/springboot-package.jar /etc/init.d/springboot-package
- chmod +x /etc/init.d/springboot-package
然后输入:
service springboot-package start|stop|restart
进行启动或者停止.
当然也可以编写 xshell 脚本进行启动和关闭.
如果是 war 项目
将 war 放在 tomcat/webapp 目录下, 然后启动 tomcat 就可以了. Windows 系统 在 tomcat/bin 目录下双击 startup.bat 即可启动, 双击 shutdown.bat 关闭.
Linux 系统则在 tomcat/bin 目录下输入 startup.sh 即可启动, 输入 shutdown.sh 关闭.
来源: https://www.cnblogs.com/xuwujing/p/9471802.html