SpringBoot系列——jar包与war包的部署

  前言

  Spring Boot支持传统部署和更现代的部署形式。jar跟war都支持,这里参考springboot参考手册学习记录

  传统部署:https://docs.spring.io/spring-boot/docs/2.1.6.RELEASE/reference/html/howto-traditional-deployment.html

  更现代的部署:https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/reference/htmlsingle/#getting-started-first-application-executable-jar

 

  两种方式

  jar

  springboot项目支持创建可执行Jar,参考手册第11.5. Creating an Executable Jar就有对这样的介绍,我这里充当一回搬运工(大家好,我是大自然勤劳的搬运工~~):

  我们通过创建一个完全自包含的可执行jar文件来完成我们的示例,该文件可以在生产环境中运行。可执行jar(有时称为“胖jar”)是包含编译类和代码需要运行的所有jar依赖项的归档文件

  要创建一个可执行jar,我们需要将spring-boot-maven-plugin添加到我们的pom.xml中。为此,在dependencies部分下面插入以下几行:

    <!--构建工具-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

  如果需要制定jar包名称、生成路径,以及跳过测试

    <!--构建工具-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <!-- 文件名以及输出路径-->
                <configuration>
                    <finalName>${project.artifactId}</finalName>
                    <outputDirectory>../package</outputDirectory>
                </configuration>
            </plugin>

            <!-- 跳过启动测试 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skipTests>true</skipTests>
                </configuration>
            </plugin>
        </plugins>
    </build>

  如果是在父类的pom文件进行统一管理,然后子类引入父类,这需要加pluginManagement标签

    <!--构建工具-->
    <build>
        <pluginManagement>
...
</pluginManagement> </build>

  

  2019-08-23补充:之前打包都是一个多个工程管理,在父类的pom文件配置这个,打包会在目录下面生成,因为用的是../package

  最近打包一个单独的项目,路径我改成package,没有../了,打包后并没有在项目下面生成package目录,jar不知道打去哪了。。。我全局搜也搜不出来

  后面改成绝对路径F:/package,终于有jar包了,但文件名不对,我们明明设置读取的是${project.artifactId},但打出来还是带上了版本号。。。,原因暂时未知

  PS:实在不行可以直接指定一个文件夹,例如:F:\package

 

 

  可以使用命令行来打包,或者使用Maven Projects来打包

 

  同时也可以直接使用下面命令进行打包

  打包成功,在target目录下就会看到jar包

  要运行该应用程序,cmd命令,进入到jar所在路径文件,使用 java -jar 命令;win下直接双击用java方式打开即可运行(Ctrl+C退出)

   那么Linux下面如何部署运行呢?

=====Linux部署命令======
0、查看运行的项目 pgrep java | xargs ps 1、先kill掉旧服务 pkill -f myspringboot-0.0.1-SNAPSHOT 2、后台启动新服务(nohup后台运行,&后台运行的区别: 使用nohup运行程序: 结果默认会输出到nohup.out 使用Ctrl + C发送SIGINT信号,程序关闭 关闭session发送SIGHUP信号,程序免疫 使用&后台运行程序: 结果会输出到终端 使用Ctrl + C发送SIGINT信号,程序免疫 关闭session发送SIGHUP信号,程序关闭 ) nohup java -jar /home/myspringboot/myspringboot-0.0.1-SNAPSHOT.jar & 如需输出日志 nohup java -jar /home/myspringboot/myspringboot-0.0.1-SNAPSHOT.jar > /home/myspringboot/myspringboot-0.0.1-SNAPSHOT.log & 3、查看日志 tail -f /home/myspringboot/myspringboot-0.0.1-SNAPSHOT.log

 

  2019-07-08补充

  一、当我们打包后上传Linux服务器,发现有些代码还需要修改,重新打包、上传又比较慢,如果只是少量代码,并且是前端代码、配置文件等,那么我们可以直接修改jar包内容

    1、先cd进到jar位置,然后使用 vim 命令进入jar包  

    

    2、使用 / 命令模糊搜索定位文件,例如main.js  

    

    3、按回车进入文件,修改完成后使用 :wq 保存退出文件,回到jar包目录,使用 :q 退出jar包,即可成功修改文件内容

    PS:修改jar,重启生效

 

  二、如果我们需要改动的是后端java代码,那么我就需要在本地改好后重新编译代码,把对应的java、class文件都替换到jar包

 

   war

  springboot项目支持创建一个可部署的War文件,参考手册第92.1 Create a Deployable War File就有对这样的介绍,我这里充当一回搬运工(大家好,我是大自然勤劳的搬运工~~):

  由于Spring WebFlux并不严格依赖于Servlet API,并且应用程序默认部署在嵌入式反应器Netty服务器上,所以WebFlux应用程序不支持War部署。

  生成可部署war文件的第一步是提供SpringBootServletInitializer子类并覆盖其配置方法。这样做可以利用Spring Framework的Servlet 3.0支持,让您在Servlet容器启动应用程序时配置它。通常,您应该更新应用程序的主类以扩展SpringBootServletInitializer,同时,要将Spring应用程序部署到外部服务器,必须确保servlet初始化器直接实现WebApplicationInitializer(即使是从已经实现它的基类扩展而来)。如下例所示:

@SpringBootApplication
public class MyspringbootApplication  extends SpringBootServletInitializer implements WebApplicationInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(MyspringbootApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(MyspringbootApplication.class, args);
    }
}

 

  在创建springboot项目时,默认是jar包,如果是想要打成war包,需要修改pom.xml,打包方式跟生成路径跟jar的一样,过程的最后一步是确保嵌入的servlet容器不会干扰部署war文件的servlet容器。为此,需要将嵌入式servlet容器依赖项标记为所提供的。

<!--默认jar-->
<packaging>war</packaging>

<!-- 如需打成war包 确保嵌入的servlet容器不会干扰部署war文件的servlet容器 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

<!--构建工具-->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

 

  得到war包后把它丢到服务容器里(放在webapps文件夹下)run起来就行了,要注意的是使用了外部容器,要记得改Tomcat的端口,在server.xml的Connector节点

 

  友情翻译:如果使用Spring引导构建工具,将嵌入的servlet容器依赖项标记为提供,将生成一个可执行的war文件,并将提供的依赖项打包在lib提供的目录中。这意味着,除了可以部署到servlet容器之外,还可以在命令行上使用java -jar运行应用程序。

 

  后记

  打成war包丢到服务器里面运行启动报错,还不知道是什么问题,都是照着参考手册来的...,先记录到这里;推荐直接使用jar的方式运行,war报错的原因,有空再去研究。

  

  补充

  2019-06-24补充:我将我们前面写的IM系统按照步骤打成war包,但启动Tomcat报错

 

  2019-07-12补充,后面看文档后发现,我们漏了一下东西,如果使用Logback,还需要告诉WebLogic选择打包版本,而不是预先安装在服务器上的版本。而SpringBoot默认使用Logback,同时,之前我们也漏了 implements WebApplicationInitializer

 

  将所有的东西都补全后还是报错... 

 

 

  上网查了一下,说两种问题:1、Tomcat问题,2、jar包问题

  我们之前的Tomcat版本是apache-tomcat-7.0.53,去官网看来下,支持6 and later(7 and later for WebSocket)

  发现9.0.x版的Tomcat也支持1.8及1.8以上,我们项目用的jdk版本是1.8.0_131,我们直接下载最新版Tomcat试一下

  成功启动

 

  同时我们也注意到,springboot 2.x的内置Tomcat使用的是9.x

 

 

  PS:

  1、由于使用外部服务器,我们在项目的配置文件配置的server.port=10081已经没有用了,端口信息需要咋Tomcat的server.xml进行配置

    <Connector port="10081" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               URIEncoding="UTF-8"/>

 

  2、解决Tomcat中文乱码,修改conf/logging.properties

java.util.logging.ConsoleHandler.encoding = GBK

  3、为了安全,webapps只保留项目文件

  4、Tomcat的本质是文件夹,默认配置下访问项目要加war包名称,例如: :端口/war包名/路径

    这是因为我们server.xml的host节点的默认appBase="webapps"

    

    新增一个默认访问路径就可以不用加war包名称了,例如:

    

     然后就可以这样访问了

     

  到这里war包启动报错的问题终于解决!

 

  2019-08-26补充:补充一下如何云安装java的jdk,以及mysql数据库,这里主要参考以下博客文章(亲测可用):

  linux在线安装JDK(1.8版本):https://blog.csdn.net/zxb730916/article/details/80899429?tdsourcetag=s_pctim_aiomsg

  Linux之yum安装MySQL:https://www.jianshu.com/p/136003ffce41

 

  jdk

//查看是否已安装JDK,卸载
yum list installed |grep java  

//卸载CentOS系统Java环境
//         *表时卸载所有openjdk相关文件输入  
yum -y remove java-1.8.0-openjdk*
//         卸载tzdata-java  
yum -y remove tzdata-java.noarch

//列出java环境安装包
yum -y list java*    

// 安装JDK,如果没有java-1.8.0-openjdk-devel就没有javac命令 
yum  install  java-1.8.0-openjdk   java-1.8.0-openjdk-devel

  使用 java -version 查看版本号确认是否安装成功

 

  mysql

  下载、安装

//下载
wget -i -c http://dev.mysql.com/get/mysql57-community-release-el7-10.noarch.rpm

//安装
yum -y install mysql57-community-release-el7-10.noarch.rpm

yum -y install mysql-community-server

  启动、配置

//启动
systemctl start  mysqld.service

//查看root初始密码
grep "password" /var/log/mysqld.log

//使用root登录mysql
mysql -uroot -p  

//设置安全级别
set global validate_password_policy=0

//默认密码长度为8,可以设置为其它值,最小4位
set global validate_password_length=4

//修改root密码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'root';

//可视化工具的登录授权:(如果授权不成功,请查看防火墙)
grant all on *.* to root@'%' identified by 'root';

  配置到这里就可以使用数据库工具去连接操作数据库了

 

  代码开源

  代码已经开源、托管到我的GitHub、码云:

  GitHub:https://github.com/huanzi-qch/springBoot

  码云:https://gitee.com/huanzi-qch/springBoot

posted @ 2018-11-12 17:59  huanzi-qch  阅读(15827)  评论(4编辑  收藏  举报