SpringBoot+Vue项目部署（传统方式）_springboot+vue部署

一，后端部署

1，项目打包

1.1，引入插件

该插件会将SpringBoot项目打包成一个可以运行的jar包，可以用 java -jar jar包名称 启动。

<build>
        <!-- plugins 标签：定制化构建过程中所使用到的插件 -->
        <plugins>
            <!-- plugin 标签：一个具体插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
</build>
1
2
3
4
5
6
7
8
9
10

1.2，maven打包

可以通过maven命令行直接打包，也可以通过IDEA打包

# -Dmaven.test.skip=true表示打包的时候跳过测试
mvn clean install -Dmaven.test.skip=true
1
2

1.3，修改项目版本号

默认创建的项目是快照版本，比如1.0.SANPSHOT，想修改的话只需要在pom.xml文件中找到项目的配置信息进行修改。

1.4，验证

打包好的jar包是可以用java -jar 命令直接启动的，保险起见可以在上传到服务器之前先在本地启动测试一下。

1.5，生成配置文件

虽然项目打包后用jar包里的配置文件也可以启动，但是推荐将配置文件提取出来，一般开发环境和生产环境的配置是不一样的，通过加载外部配置文件的方式启动，更便于维护配置信息，这里生成一个web-server.yml的配置文件，里面是项目的配置信息，可以根据项目实际需要生成。

2，服务器环境搭建

项目在本地可以正常启动，这是因为本地有安装JDK，数据库等，若想要项目在服务器上也能正常启动，则同样需要
安装项目的依赖。

2.1，安装JDK

1）下载

• 地址: JDK8下载
  
  下载需要注册一个Oracle的地址，可以采用rpm的安装方式，也可以采用tar.gz的安装方式。

2）tar包安装

将下载好的tar包上传到服务器，可以通过Xshell+Xftp，也可以通过MobaXterm

# 1.将JDK解压缩到指定目录，-C参数是将JDK解压之后文件放入usr目录中
tar -zxvf jdk-8u171-linux-x64.tar.gz -C /usr/

# 2.进入jdk解压缩目录查看
cd /usr/jdk1.8.0_171/

# 3.查看详细信息
[root@localhost jdk1.8.0_171]# ls
bin        db       javafx-src.zip  lib      man          release THIRDPARTYLICENSEREADME-JAVAFX.txt  COPYRIGHT  include  jre             LICENSE  README.html  src.zip  THIRDPARTYLICENSEREADME.txt

# 4.配置环境变量
vi /etc/profile
	 
# 5.在文件末尾加入如下配置
export JAVA_HOME=/usr/jdk1.8.0_171
export PATH=$PATH:$JAVA_HOME/bin

# 6.加载配置生效
source /etc/profile    加载配置生效
reboot                 重启系统
#注意: 以上两个选项选择任意一个即可source可以不用重启立即生效,某些情况下source无法生效时,可以使用重启试试

# 7.测试环境变量
java
javac
java -version
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

3）rpm安装

# 1.安装jdk
[root@localhost ~]# rpm -ivh jdk-8u171-linux-x64.rpm 
		准备中...                          ################################# [100%]
		正在升级/安装...
   		1:jdk1.8-2000:1.8.0_171-fcs        ################################# [100%]
			Unpacking JAR files...
        tools.jar...
        plugin.jar...
        javaws.jar...
        deploy.jar...
        rt.jar...
        jsse.jar...
        charsets.jar...
        localedata.jar...

# 2.搜索默认安装位置
[root@localhost ~]# find / -name "java"
/usr/java/jdk1.8.0_171-amd64/bin/java
/usr/java/jdk1.8.0_171-amd64/jre/bin/java

# 3.配置环境变量
vi /etc/profile

# 4.在文件末尾加入如下配置
export JAVA_HOME=/usr/java/jdk1.8.0_171-amd64/
export PATH=$PATH:$JAVA_HOME/bin

# 5.加载配置生效
source /etc/profile    加载配置生效
reboot                 重启系统
#注意: 以上两个选项选择任意一个即可source可以不用重启立即生效,某些情况下source无法生效时,可以使用重启试试

# 6.测试环境变量
java
javac
java -version
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

能显示JDK的版本号，就算安装成功了。

2.2，MySQL安装

MySQL既可以采用传统方式，也可以采用docker镜像安装，传统方式这里就不再赘述了，下面是docker的安装方式：

# 1.拉取mysql镜像到本地
docker pull mysql:tag (tag不加默认最新版本)

# 2.使用自定义配置参数
#-e: 代表environment，给容器中的某个环境设置值
#--restart=always：docker重启后，该容器也会重启，不加得话docker重启，这个容器就没了
docker run --name mysql -v /root/mysql/conf.d:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=root -d mysql:tag
1
2
3
4
5
6
7

2.3，Windows开放MySQL远程连接

为了方便，有时候我们会连接本地的MySQL数据库，数据库安装成功后默认远程连接是关闭的，3306端口也是不对外开发的，需要做如下配置。

1）开放远程连接

①，命令行中输入如下命令，进入到MySQL

②，执行如下命令，开放远程连接

use mysql;

GRANT ALL PRIVILEGES ON . TO ‘root’@’%’ IDENTIFIED BY ‘root’ WITH GRANT OPTION;
1
2
3
4

③，权限刷新

flush privileges;
1

④，查看权限

select host,user from user;
1

root的权限是%，远程连接权限已开放

2）开放3306端口

如果开放了远程连接发现还是连接不上，那可能是防火墙的端口还未开放
创建入站规则

新建入站规则：

类型选端口：

只开放一个端口3306

选择允许连接：

默认下一步：

填写名称，以便和其它规则区分，最后点击完成即可

可以看到，入站规则新建成功

3，上传jar包，编写shell脚本

jar包上传后可以通过java -jar来启动，不过那样每次都要输入命令，我们编写一个简单的脚本来启动项目

#!/bin/sh

# jar包名称
 JAR_NAME="web-server-1.0-20230323.jar"
 JAR_CONFIG_FILE_PATH="web-server.yml"

#日志文件的位置
 LOG_DIR=logs
 LOG_FILE=$LOG_DIR/web-server.log

BIN_DIR=`dirname $0`
SHELL_NAME=`basename $0`
cd $BIN_DIR/..
#`pwd`是得到你当前执行脚本的位置，而不是脚本存放的位置(需要注意，很容易出现路径不对，建议echo输出看一下)
WORK_DIR=`pwd`/project/

#java程序启动命令
JAVA_CMD_FILE="java"
JAVA_OPT=""

# 定义一个函数，如果传入的参数既不是start，也不是stop，就调用该函数
function usage()
{
   echo -e "usage:$SHELL_NAME start|stop"
}

function pre_do()
{
   sleep 0.1
}

if [ -z $1 ]; then
    usage
    exit 1
fi

#日志目录若不存在，则创建
if [ ! -d "$WORK_DIR/$LOG_DIR" ]; then
     mkdir -p "$WORK_DIR/$LOG_DIR"
fi

#日志文件若不存在，则创建
if [ ! -f "$WORK_DIR/$LOG_FILE" ]; then
     touch "$WORK_DIR/$LOG_FILE"
fi

#$0:是指你所写的shell脚本本身的名字；
#$1:是指你写的shell脚本所传入的第一个参数 ；
#$2:是指你写的shell脚本所传入的第二个参数；
#这里是启动程序的方法
if [ "$1" == "start" ];then
     # 进程号不为空，说明程序已启动，无法重复启动
     ulimit -HSn 5120
     PIDS=`ps --no-heading -C java -f --width 1000 | grep $JAR_NAME | awk '{print $2}'`
     if [ -n "$PIDS" ]; then
         echo -e "ERROR: the $JAR_NAME already started and the PID is ${PIDS}."
	 exit 1
     fi

     echo "starting the $JAR_NAME..."

     pre_do
     # $? 是一个特殊的 shell 变量，用于存储上一个命令的执行状态。
     if [ "$?" != "0" ]; then
        exit 1
     fi
     cd $WORK_DIR
     # 日志位置就用程序里配置的日志位置，这里不再额外生成日志
     nohup $JAVA_CMD_FILE $JAVA_OPT -jar $JAR_NAME --spring.config.location=$JAR_CONFIG_FILE_PATH >/dev/null 2>&1 &
     
     # 这段脚本的意思是等待程序启动完成
     # -eq ：equal（相等）-ne ：not equal（不等）-gt ：greater than（大于）-ge ：greater than or equal（大于或等于）
     # -lt ：less than（小于）-le ：less than or equal（小于或等于）
     # 注意：在shell中进行比较时，结果为0代表真，为1代表假。-eq，-ne等比较符只能用于数字比较，有字符也会先转换成数字然后进行比较。

     COUNT=0
     while [[ $COUNT -lt 1 ]]; do
         sleep 1
	 COUNT=`ps --no-heading -C java -f --width 1000 | grep $JAR_NAME | awk '{print $2}' | wc -l`
	 if [[ $COUNT -gt 0 ]]; then
	     break
	 fi
     done
     
     # 上面的循环跳出，说明程序已经启动好了，在屏幕上输出程序的进程号和日志文件的位置
     PIDS=`ps  --no-heading -C java -f --width 1000 | grep "$JAR_NAME --spring.config.location=$JAR_CONFIG_FILE_PATH" | awk '{print $2}'`
     echo "${JAR_NAME} started and the PID is ${PIDS}."
     echo "logging file: $WORK_DIR/$LOG_FILE"

# 这里是停止程序的方法
elif [ "$1" == "stop" ];then
 
     PIDS=`ps --no-heading -C java -f --width 1000 | grep $JAR_NAME | awk '{print $2}'`
     # -z字符串：表示如果字符串为空
     if [ -z "$PIDS" ]; then
	 echo "ERROR: the $JAR_NAME does not started!"
         exit 1
     fi
			    
    echo -e "stopping the $JAR_NAME..."
				      
    for PID in $PIDS; do
        PIDSONS=`pstree -n -p $PID |  awk 'BEGIN{ FS="(" ; RS=")" } NF>1 { print $NF }' | sort -r`
	for PSON in $PIDSONS; do
	    kill -9 $PSON > /dev/null 2>&1
	done
    done

    COUNT=0
    while [ $COUNT -lt 1 ]; do
	sleep 1
	COUNT=1
	for PID in $PIDS ; do
	    PID_EXIST=`ps --no-heading -p $PID`
	    if [ -n "$PID_EXIST" ]; then
		COUNT=0
		break
            fi
	 done
    done
    
    echo -e "${JAR_NAME} stopped and the PID is ${PIDS}."
else
      usage
      exit 1
fi

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

上面的脚本经过本地测试是可以启动项目的，如果项目启动失败，可以着重检查一下路径是否正确。另外脚本提供了项目启动和停止两个方法，在执行脚本之前可以先给脚本加上可执行的权限，假设脚本名为web-server.sh

chmod +7 web-server.sh
1

之后就可以通过脚本来启动项目了：

# 启动项目
./web-server.sh start

#停止项目
./web-server.sh stop
1
2
3
4
5

4，验证

项目有集成swagger，该功能不需要前端项目的支持，我们通过它来验证后端项目是否部署成功。
swagger地址：http://192.168.1.9:7080/tick_tack/swagger-ui/index.html

• 说明： 刚开始测试的时候swagger页面一直进不去，最后发现是防火墙的原因，我们可以关闭防火墙，如果觉得不安全，也开放防火墙的端口，具体操作如下：

# 方法一：关闭防火墙（不推荐）
systemctl stop firewalld;
# 方法二：开放端口
firewall-cmd --add-port=7080/tcp --permanent
# 重启防火墙，使端口设置生效
systemctl restart firewalld
1
2
3
4
5
6

二，前端部署

1，Vue项目打包

前端项目打包只需要在命令行中输入：

npm run build
1

打包完成后的文件会生成到dist文件夹下，我们先将整个dist文件夹上传到服务器。本次采用前后端分别打包部署的方式，所以还需要Nginx来做一个代理。

2，Nginx的安装与配置

2.1，Nginx安装

• 1，安装依赖和相关库

[root@desktop-7q3ot0s project]# yum -y install gcc-c++ zlib-devel openssl-devel libtool
1

• 2，下载Nginx安装包并解压
  • Nginx安装包
  • 可以先将安装包下载好再上传到Linux服务器，也可以直接通过wget方式安装
  • 如果wget方式安装提示：wget: command not found
  • 则需要先安装wget，执行：yum -y install wget 即可

[root@desktop-7q3ot0s project]# cd /usr/local
[root@desktop-7q3ot0s local]# wget http://nginx.org/download/nginx-1.22.1.tar.gz
[root@desktop-7q3ot0s local]# tar -zxvf nginx-1.22.1.tar.gz
1
2
3

• 3，配置和安装

[root@desktop-7q3ot0s local]# cd nginx-1.22.1
[root@desktop-7q3ot0s nginx-1.22.1]# ./configure --prefix=/usr/local/nginx
[root@desktop-7q3ot0s nginx-1.22.1]# make && make install
1
2
3

安装完成后会多出一个Nginx的文件夹，此时nginx-1.22.1文件夹和nginx-1.22.1.tar.gz压缩包都可以删掉了。

• 4，启动Nginx

[root@desktop-7q3ot0s local]# cd ../nginx/sbin
[root@desktop-7q3ot0s sbin]# ./nginx
1
2

• 5，查看Nginx

[root@desktop-7q3ot0s sbin]# ps -ef|grep nginx
1

能出现上述的页面，则表明Nginx已经安装成功了。（如果无法访问，试试开放防火墙的80端口）

• 6，停止和重启Nginx

[root@desktop-7q3ot0s sbin]# ./nginx -s reload  #重启
1

• 7，编写配置文件

[root@desktop-7q3ot0s sbin]# cd ../conf/
[root@desktop-7q3ot0s sbin]# vim nginx.conf
1
2

2.2，编写配置文件

Nginx.conf文件：

location / {
	  # 打包后上传到服务器中的index.html的位置
      root /home/project/dist;
      index index.html index.htm;
      try_files $uri $uri/ /index.html;
    }
1
2
3
4
5
6

写配置文件时注意 root后的路径是打包上传到服务器的index.html所在的路径。如果项目在本地能正常启动，打包过程中未出现错误，一般就能够正常访问了。

三，说明：

针对本次部署过程中出现的问题，在此做一下记录：

• 1，项目运行成功，但是浏览器无法访问，先考虑防火墙端口是否未开放。
• 2，项目部署到服务器后，前端访问后端的IP和端口会发生改变，记得将本地ip和端口修改为服务器的。
• 3，如果是在内网环境部署，那安装Nginx可以选择离线安装，步骤都是一样的，先上传C++需要的各项依赖，再将Nginx安装包上传。
• 4，除了用Nginx这种方式外，还可以选择将前后端打包到一起的方式部署，可以省去安装Nginx。
• 5，后端打好的jar包因为包含很多依赖的jar包，它的体积会很大，随便一下就在百兆左右，每次更新会比较麻烦，可以对项目进行瘦身，将各个依赖分别打包，这样每次更新时只用更新编写得业务代码（瘦身后就几十K左右）即可。
• 6，这种方式的部署相对还是比较麻烦，要先安装JDK，还要一步步安装Nginx，如果只是测试，推荐用docker容器化部署，会方便很多。