SpringBoot项目war包部署

服务部署

记录原因

将本地SpringBoot项目通过war包部署到虚拟机中，验证服务器部署。

使用war包是为了方便替换配置文件等。

工具

对象	版本
Spring Boot	2.4.0
VMware Workstation Pro	16
Git	2.9.4
maven	3.3.9
JDK	jdk1.8.0_281
Tomcat	9.0.45
Redis	6.2.1

Tomcat版本需要与SpringBoot内置版本保存大版本上一致，否则会出现问题

虚拟机这里安装不赘述。

Git

• 进入虚拟机的cd /usr/local/src目录，输入下载链接：

  wget https://www.kernel.org/pub/software/scm/git/git-2.9.4.tar.gz
  

• 解压缩

  tar -zxvf git-2.9.4.tar.gz
  

• 安装编译Git时需要的包(一句一句执行)

  yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel
  yum install gcc perl-ExtUtils-MakeMaker
  

• 删除已有的Git

  yum remove git
  

• 编译安装

  进入根目录：cd /usr/local/src/git-2.9.4
  安装到/usr/local/git目录：./configure --prefix=/usr/local/git
  编译安装：make && make install
  

• 创建软链：

  ln -s /usr/local/git/bin/*  /usr/local/bin/
  

• 验证安装完成

  git --version
  

  

maven

• 检查maven是否安装

  mvn -v
  

• 在/usr/local/src目录下下载maven压缩包

  wget https://archive.apache.org/dist/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
  

• 解压压缩包

  tar -zxvf apache-maven-3.3.9-bin.tar.gz
  

• 移动到/usr/local

  mv apache-maven-3.3.9 /usr/local/maven3
  

• 配置环境变量

  • 打开环境变量文件profile

    vim /etc/profile
    

  • 在最末尾添加环境变量

    export MAVEN_HOME=/usr/local/maven3
    export PATH=$MAVEN_HOME/bin:$PATH
    

  • tips：这里准备部分Linix 文本编辑命令

    i 进入编辑模式-在光标所在位置开始输入
    esc  退出编辑模式
    :wq 退出编辑模式后进行文件保存并推出
    
    更多 https://www.linuxprobe.com/linux-vim-commend.html
    

  • 使配置生效

    source /etc/profile
    

• 检查是否安装成功

  mvn -v
  

  

JDK

• 检查是否安装

  java -version
  

• 安装JDK时建议在本地下载好安装包之后使用winSCP等软件从本地上传到服务器中，注意一定要下载正确的版本（jdk-8uxxx-linux-x64.tar.gz）。JDK下载地址如下：

  https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
  

• 将下载好的JDK安装包上传到服务器的/usr/local/src目录下，上传完成后解压。

  tar -zxvf jdk-8u201-linux-x64.tar.gz
  

• 将解压好的JDK移动到/usr/local下

  mv  jdk1.8.0_201 /usr/local
  

• 配置环境变量

  • 进入配置文件

    vim /etc/profile
    

  • 在最后添加如下环境变量配置后保存并退出：

    export JAVA_HOME=/usr/local/jdk1.8.0_201
    export JRE_HOME=/usr/local/jdk1.8.0_201/jre
    export PATH=$JAVA_HOME/bin:$PATH
    export CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib
    

  • 使配置生效

    source /etc/profile
    

• 验证安装

  java -version
  

Tomcat

• 下载Tomcat到本级，通过filezilla等工具上传到/usr/local中

  https://tomcat.apache.org/download-90.cgi#9.0.45
  

• 解压缩

  tar -zxvf apache-tomcat-9.0.45.tar.gz
  

• 如果有强迫症，可删除压缩包

  rm /usr/local/apache-tomcat-9.0.45.tar.gz
  

• 启动

  sh /usr/local/apache-tomcat-9.0.45/bin/startup.sh
  

• 关闭

  sh /usr/local/apache-tomcat-9.0.45/bin/shutdown.sh
  

• 实时日志查看

  tail -500f /usr/local/apache-tomcat-9.0.45/logs/catalina.out
  

Redis

• 通过本地下载redis上传到服务器或直接在服务器下载。我是选择稳定版本下载，传到虚拟机上。

  https://redis.io/download
  

• 解压缩

  tar -zxvf redis-6.2.1.tar.gz
  

• Yum安装gcc依赖，并编译安装redis

  cd /usr/local/redis-6.2.1
  
  yum install gcc
  make MALLOC=libc
  cd src && make install
  

• 启动redis(另外可将其配置成一个服务)

  ./redis-server
  

连接不同问题解决

1. ping ip

   ip不同检查防火墙

2. 虚拟机检查端口号是否开启

   修改端口后需要重启防火墙服务才能生效

   centos8 检查端口是否开启
   firewall-cmd --query-port=8080/tcp
   开启端口
   firewall-cmd --zone=public --add-port=8080/tcp --permanent
   重启防火墙：
   systemctl restart firewalld.service
   

   这里centos8与之前的版本端口号开启有差异。

   最开始虚拟机Tomcat起来后我windows访问8080端口不通，后根据这两步访问成功。

项目准备

如果是使用Idea构建一个新项目，可以在创建时选择打包方式，如果构建时选择的是jar包方式，则需要一些变动。

新项目

构建时选择打包方式为war包

Jar包项目

指的是打包方式为jar的项目。

• 打包时需要忽略内置Tomcat，本地运行时需要使用。因此本地运行时关闭注释。

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <!--忽略内置tomcat容器-->
      <exclusions>
          <exclusion>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-tomcat</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 忽略内置Tomcat的同时，需要额外添加servlet依赖

  <!--由于忽略内置tomcat容器，因此使用javax.servlet方法需要额外添加依赖-->
  <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
  </dependency>
  

• 添加war包名，忽略打包文件（可选）

  <build>
      <finalName>demo</finalName>
      <plugins>
          <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
              <configuration>
                  <excludes>
                      <!--打包时忽略自定义类配置提示工具-->
                      <exclude>
                          <groupId>org.springframework.boot</groupId>
                          <artifactId>spring-boot-configuration-processor</artifactId>
                      </exclude>
                  </excludes>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

打包

提供两种方法。

• Idea 点击Bulid>Build Artifacts>选择 demo.war

• 使用maven的打包命令

  mvn clean package
  

启动

• 将打包好的war包通过filezilla等工具上传到虚拟机 tomcat下的webapp目录中

• 启动虚拟机上的Tomcat，并访问，请求得到响应即成功

  http://192.168.xxx.xxx:8080/demo/
  

踩坑

Tomcat启动后，使用如下日志命令监控项目启动，出现问题直观明了。

tail -500f /usr/local/apache-tomcat-9.0.45/logs/catalina.out

• 不管项目本地配置的端口号、访问url是什么，部署到虚拟机上都是使用Tomcat的端口号加war包名，如8080/demo/

• 由于我访问的是本地数据库，因此需要修改项目配置文件中数据库地址，部署项目时报错

  java.sql.SQLException: null, message from server: “Host ‘xxx’ is not allowed to connect...
  

  这是由于数据库服务器未给服务部署服务器访问权限，具体修改参考 https://blog.csdn.net/xionglangs/article/details/50385057