友情提示:目前是 Boot 项目的部署,后续会调整成 Cloud 项目的部署
本小节,讲解如何将前端 + 后端项目,使用 Shell 脚本 ,部署到 dev 开发环境下的一台 Linux 服务器上。如下图所示:
1. 配置 MySQL 1.1 安装 MySQL(可选) 友情提示:安装 MySQL 是可选步骤,也可以购买 MySQL 云服务。
① 执行如下命令,进行 MySQL 的安装。
1 2 3 4 5 6 7 8 rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm yum install mysql-server --nogpgcheck mysqld --version
② 修改 /etc/my.cnf
文件,在文末加上 lower_case_table_names=1
和 validate_password=off
配置,执行 systemctl restart mysqld
命令重启。
③ 执行 grep password /var/log/mysqld.log
命令,获得 MySQL 临时密码。
1 2022-04-16T09:39:57.365086Z 1 [Note] A temporary password is generated for root@localhost: ZOKUaehW2e.e
④ 执行如下命令,修改 MySQL 的密码,设置允许远程连接。
1 2 3 4 5 6 7 8 9 10 mysql -uroot -p alter user 'root' @'localhost' identified by '123456' ; use mysql; update user set host = '%' where user = 'root' ; FLUSH PRIVILEGES;
1.2 导入 SQL 脚本
创建一个名字为 ruoyi-vue-pro
数据库,执行数据库对应的
sql
(
opens new window) 目录下的 SQL
文件,进行初始化。
2. 配置 Redis 友情提示:安装 Redis 是可选步骤,也可以购买
Redis 云服务。
执行如下命令,进行 Redis 的安装。
1 2 3 4 5 6 7 8 9 10 11 yum install http://rpms.famillecollet.com/enterprise/remi-release-7.rpm yum --enablerepo=remi install redis redis-server --version systemctl restart redis
3. 部署后端 3.1 修改配置 后端 dev 开发环境对应的是 application-dev.yaml
(opens new window) 配置文件,主要是修改 MySQL 和 Redis 为你的地址。如下图所示:
3.2 编译后端 在项目的根目录下,执行 mvn clean package -Dmaven.test.skip=true
命令,编译后端项目,构建出它的 Jar 包。如下图所示:
疑问:-Dmaven.test.skip=true 是什么意思?
跳过单元测试的执行。如果你项目的单元测试写的不错,建议使用 mvn clean package
命令,执行单元测试,保证交付的质量。
3.3 上传 Jar 包 在 Linux 服务器上创建 /work/projects/yudao-server
目录,使用 scp
命令或者 FTP 工具,将 yudao-server.jar
上传到该目录下。如下图所示:
3.4 编写脚本 在 /work/projects/yudao-server
目录下,新建 Shell 脚本 deploy.sh
,用于启动后端项目。编写内容如下:
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 #!/bin/bash set -e DATE=$(date +%Y%m%d%H%M) BASE_PATH=/work/projects/yudao-server SERVER_NAME=yudao-server PROFILES_ACTIVE=dev HEAP_ERROR_PATH=$BASE_PATH /heapError JAVA_OPS="-Xms512m -Xmx512m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$HEAP_ERROR_PATH " function stop () { echo "[stop] 开始停止 $BASE_PATH /$SERVER_NAME " PID=$(ps -ef | grep $BASE_PATH /$SERVER_NAME | grep -v "grep" | awk '{print $2}' ) if [ -n "$PID " ]; then echo "[stop] $BASE_PATH /$SERVER_NAME 运行中,开始 kill [$PID ]" kill -15 $PID for ((i = 0 ; i < 120 ; i++)) do sleep 1 PID=$(ps -ef | grep $BASE_PATH /$SERVER_NAME | grep -v "grep" | awk '{print $2}' ) if [ -n "$PID " ]; then echo -e ".\c" else echo '[stop] 停止 $BASE_PATH/$SERVER_NAME 成功' break fi done if [ -n "$PID " ]; then echo "[stop] $BASE_PATH /$SERVER_NAME 失败,强制 kill -9 $PID " kill -9 $PID fi else echo "[stop] $BASE_PATH /$SERVER_NAME 未启动,无需停止" fi }function start () { echo "[start] 开始启动 $BASE_PATH /$SERVER_NAME " echo "[start] JAVA_OPS: $JAVA_OPS " echo "[start] JAVA_AGENT: $JAVA_AGENT " echo "[start] PROFILES: $PROFILES_ACTIVE " nohup java -server $JAVA_OPS $JAVA_AGENT -jar $BASE_PATH /$SERVER_NAME .jar --spring.profiles.active=$PROFILES_ACTIVE > nohup.out 2>&1 & echo "[start] 启动 $BASE_PATH /$SERVER_NAME 完成" }function deploy () { cd $BASE_PATH stop start } deploy
如果你想要修改脚本,主要关注 BASE_PATH
、PROFILES_ACTIVE
、JAVA_OPS
三个参数。如下图所示:
3.5 启动后端 ① 【可选】执行 yum install -y java-1.8.0-openjdk
命令,安装 OpenJDK 8 。
友情提示:如果已经安装 JDK,可不安装。建议使用的 JDK 版本为 8、11、17 这三个。
② 执行 sh deploy.sh
命令,启动后端项目。日志如下:
1 2 3 4 5 6 7 [stop] 开始停止 /work/projects/yudao-server/yudao-server [stop] /work/projects/yudao-server/yudao-server 未启动,无需停止 [start] 开始启动 /work/projects/yudao-server/yudao-server [start] JAVA_OPS: -Xms512m -Xmx512m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/work/projects/yudao-server/heapError [start] JAVA_AGENT: [start] PROFILES: dev [start] 启动 /work/projects/yudao-server/yudao-server 完成
③ 执行 tail -f nohup.out
命令,查看启动日志。看到如下内容,说明启动完成:
1 2022-04-13 00:06:20.049 INFO 1395 --- [main] [TID: N/A] c.i.yudao.server.YudaoServerApplication : Started YudaoServerApplication in 35.315 seconds (JVM running for 36.282)
4.
部署前端 4.1 修改配置 前端 dev
开发环境对应的是
.env.dev
(
opens new window) 配置文件,主要是修改 VUE_APP_BASE_API
为你的后端项目的访问地址。如下图所示:
4.2 编译前端 在 yudao-ui-admin
目录下,执行 npm run build:dev
命令,编译前端项目,构建出它的 dist
文件,里面是 HTML、CSS、JavaScript
等静态文件。如下图所示:
如下想要打包其它环境,可使用如下命令:
1 2 npm run build:prod npm run build:stage
其它高级参数说明【可暂时不看】:
① PUBLIC_PATH
:静态资源地址,可用于七牛等 CDN 服务回源读取前端的静态文件,提升访问速度,建议 prod 生产环境使用。示例如下:
② VUE_APP_APP_NAME
:二级部署路径,默认为 /
根目录,一般不用修改。
③ mode
:前端路由的模式,默认采用 history
路由,一般不用修改。可以通过修改 router/index.js
(opens new window) 来设置为 hash
路由,示例如下:
4.3 上传 dist
文件 在 Linux 服务器上创建 /work/projects/yudao-ui-admin
目录,使用 scp
命令或者 FTP 工具,将 dist
上传到该目录下。如下图所示:
4.4 启动前端? 前端无法直接启动,而是通过 Nginx 转发读取 /work/projects/yudao-ui-admin
目录的静态文件。
5. 配置 Nginx 5.1 安装 Nginx 参考 Nginx 官方文档 (opens new window) ,安装 Nginx 服务。命令如下:
1 2 3 4 5 6 7 yum install epel-release yum update yum install nginx nginx
Nginx 默认配置文件是 /etc/nginx/nginx.conf
。
下面,来看两种 Nginx 的配置,分别满足服务器 IP、独立域名的不同场景。
5.2 方式一:服务器 IP 访问 ① 修改 Nginx 配置,内容如下:
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 worker_processes 1 ;events { worker_connections 1024 ; }http { include mime.types; default_type application/octet-stream; sendfile on ; keepalive_timeout 65 ; gzip on ; gzip_min_length 1k ; gzip_buffers 4 16k ; gzip_http_version 1 .1 ; gzip_comp_level 2 ; gzip_types gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; gzip_proxied any; server { listen 80 ; server_name 192.168.225.2 ; location / { root /work/projects/yudao-ui-admin; index index.html index.htm; try_files $uri $uri / /index.html; } location /admin-api/ { proxy_pass http://localhost:48080/admin-api/; proxy_set_header Host $http_host ; proxy_set_header X-Real-IP $remote_addr ; proxy_set_header REMOTE-HOST $remote_addr ; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ; } location /app-api/ { proxy_pass http://localhost:48080/app-api/; proxy_set_header Host $http_host ; proxy_set_header X-Real-IP $remote_addr ; proxy_set_header REMOTE-HOST $remote_addr ; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ; } } }
② 执行 nginx -s reload
命令,重新加载 Nginx 配置。
③ 请求 http://192.168.225.2/admin-api/ (opens new window) 地址,成功访问后端项目,返回结果如下:
1 { "code" : 401 , "data" : null , "msg" : "账号未登录" }
④ 请求 http://192.168.225.2 (opens new window) 地址,成功访问前端项目,返回前端界面如下:
5.3 方式二:独立域名访问 友情提示:在前端项目的编译时,需要把 `VUE_APP_BASE_API` 修改为后端项目对应的域名。
例如说,这里使用的是 http://api.iocoder.cn
① 修改 Nginx 配置,内容如下:
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 worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; gzip on; gzip_min_length 1k; gzip_buffers 4 16k; gzip_http_version 1.1; gzip_comp_level 2; gzip_types text/plain application/x-javascript text/css application/xml application/javascript; gzip_proxied any; server { listen 80; server_name admin.iocoder.cn; location / { root /work/projects/yudao-ui-admin; index index.html index.htm; try_files $uri $uri / /index.html; } } server { listen 80; server_name api.iocoder.cn; location /admin-api/ { proxy_pass http://localhost:48080/admin-api/; proxy_set_header Host $http_host ; proxy_set_header X-Real-IP $remote_addr ; proxy_set_header REMOTE-HOST $remote_addr ; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ; } location /app-api/ { proxy_pass http://localhost:48080/app-api/; proxy_set_header Host $http_host ; proxy_set_header X-Real-IP $remote_addr ; proxy_set_header REMOTE-HOST $remote_addr ; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ; } } }
② 执行 nginx -s reload
命令,重新加载 Nginx 配置。
③ 请求 http://api.iocoder.cn/admin-api/ (opens new window) 地址,成功访问后端项目,返回结果如下:
1 { "code" : 401 , "data" : null , "msg" : "账号未登录" }
④ 请求 http://admin.iocoder.cn (opens new window) 地址,成功访问前端项目,返回前端界面如下: