# Skins 业务后端 — 详细部署文档

> 适用项目：chengdu-backend（基于若依 RuoYi 开发，Spring Boot 4.0.3 + JDK 21）
> 适用场景：本地开发、测试环境、生产环境
> 项目根 README 见 [README.md](README.md)，本文为补充的详细部署手册

## 1. 部署架构总览

- 后端单进程：ruoyi-admin.jar，监听28081
- 基础设施：MySQL 8.x、Redis、RabbitMQ（参考 docker/docker-compose.yml）
- 前端：ruoyi-ui（Vue2 经典管理端），promo-ui2（Vue3 主播后台），cocos前端


## 2. 环境准备

### 2.1 必备软件

JDK  21（项目使用 /root/jdk-21.0.10） 必须为 JDK 21 
Maven  3.6.x（/root/apache-maven-3.6.3） 

### 2.2 安装示例

# JDK 21
cd /root
# 上传 jdk-21.x.tar.gz 到 /root
tar -xzf jdk-21.0.10_linux-x64_bin.tar.gz
mv jdk-21.0.10 /root/jdk-21.0.10

# Maven
cd /root
tar -xzf apache-maven-3.6.3-bin.tar.gz

# 配置全局环境变量（在脚本内配置，见 ry.sh / package.sh）
cat >> /etc/profile <<'EOF'
export JAVA_HOME=/root/jdk-21.0.10
export MAVEN_HOME=/root/apache-maven-3.6.3
export PATH=$JAVA_HOME/bin:$MAVEN_HOME/bin:$PATH
EOF
source /etc/profile

# 验证
java -version
mvn -v


## 3. 基础设施部署（MySQL / Redis / RabbitMQ）

### 3.1 使用仓库自带 docker-compose

仓库 docker/ 目录下已提供文件，采用 compose override 模式，通过 deploy.sh 自动选择镜像源和资源规格。

bash
cd chengdu-backend/docker/compose

# 自动检测环境并启动（默认：国内镜像 + 自动检测 CPU 规格）
./deploy.sh up -d

# 开发环境
ENV=dev ./deploy.sh up -d

# 海外镜像源（如国内镜像不可用）
PROXY=overseas ./deploy.sh up -d

# 停止 / 删除
./deploy.sh stop
./deploy.sh down

容器常用操作：

./deploy.sh up -d                         # 启动
./deploy.sh stop                          # 停止

### 3.2 首次部署：数据卷迁移

如果之前使用旧版 docker-compose（自动命名卷），需要迁移数据到 external 卷：

bash
cd docker/compose
bash migrate-mysql-volume.sh


## 4. 后端配置yml说明（Spring Profile）

入口配置文件：[ruoyi-admin/src/main/resources/application.yml](ruoyi-admin/src/main/resources/application.yml)

### 4.1 Profile 文件

| Profile   | 文件                      
| dev       | application-dev.yml     
| pro       | application-pro.yml

### 4.2 生产关键配置（节选自 application-pro.yml）

yaml
ruoyi:
  profile: /www/static       # 上传文件存储目录
  demoEnabled: true         

spring:
  datasource:
    druid:
      master:
        url: jdbc:mysql://127.0.0.1:23306/chengdu?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
        username: chengdu
        password: <数据库密码>
  data:
    redis:
      host: 127.0.0.1
      port: 26379
      password: <Redis 密码>
  rabbitmq:
    host: 127.0.0.1
    port: 25672
    username: skins
    password: <RabbitMQ 密码>
    virtual-host: /skins

token:
  secret: <强随机 32 位以上字符串>      # JWT 密钥，必须修改
  expireTime: 1440                  # 分钟

### 4.3 项目文件上传目录

ruoyi.profile 指上传文件物理路径（默认 /www/static），创建并赋权（宝塔直接手动创建）：


## 5. 编译与打包
### 5.1 服务器编译（脚本封装）

仓库根目录提供 [package.sh](package.sh)：

package.sh
主要工作：
1. 检查 mvn 和 java 命令是否可用。
2. git pull 拉取最新代码。
3. 调用 mvn clean package -Dmaven.test.skip=true。
4. 将 ruoyi-admin/target/ruoyi-admin.jar 复制到仓库根目录 ./ruoyi-admin.jar，供 ry.sh 启动。


## 6. 一键部署脚本（宝塔推荐）

仓库根 [publish.sh](publish.sh) 封装「备份旧jar → 打包 → 重启」完整流程：

bash执行流程
cd /www/chengdu_app/chengdu-backend
./publish.sh

执行解释步骤：
1. 备份旧 jar：cp ruoyi-admin.jar ruoyi-admin.jar.bak
2. 打包：调用 ./package.sh（含 git pull + mvn package）
3. 重启：./ry.sh stop && ./ry.sh start

ry.sh 会自动检测 CPU 核数选择 JVM 规格（16c32g: 10g堆 / 32c64g: 22g堆），使用 G1GC 并开启 GC 日志。可通过 JVM_PROFILE 环境变量覆盖规格，SPRING_PROFILE 覆盖 Spring Profile（默认 pro）。


## 7. 前端工程部署

### 7.1 ruoyi-ui（Vue2 经典管理端）

bash
cd ruoyi-ui
npm install                    
npm run build:prod             # 将dist目录下文件打包
# 将 dist压缩包 上传到/www/wwwroot/静态目录


### 7.2 promo-ui2（Vue3 推广后台）

bash
cd promo-ui2
pnpm install
pnpm build:pro                 # 将dist目录下文件打包
# 将 dist压缩包 上传到/www/wwwroot/静态目录


## 8. 宝塔端口放行

| 端口            | 用途 
| 80 / 443       | Nginx 
| 28081          | 后端 Spring Boot 
| 23306          | MySQL 
| 26379          | Redis 
| 25672 / 35672  | RabbitMQ AMQP 

执行流程
宝塔 → 安全 → 放行 80/443/26379/23306/28081 等等所需要的端口号，其余端口可在宝塔安全设置添加和修改。

## 9. 日志与监控

### 9.1 日志文件

| 路径                         |            内容 |
| nohup.out                   |  启动 + 控制台日志（由 ry.sh 输出） |
| /www/ruoyi/logs/sys-info.log |  系统日志（logback，按天滚动，保留60天） |
| /www/ruoyi/logs/sys-error.log |  错误日志（logback，按天滚动，保留60天） |
| /www/ruoyi/logs/gc.log      |  GC 日志（滚动 10 个文件，每个 50M） |

实时跟踪：
bash脚本
tail -f nohup.out