QAUP_Management/deploy/simple/BUILD-GUIDE.md

QAUP 构建打包指南

方案：macOS构建 + Ubuntu打包

开发环境操作（macOS）

1. 构建jar文件

# 在项目根目录
mvn clean package -DskipTests

2. 上传jar文件到打包服务器

# 方式一：使用scp
scp qaup-admin/target/qaup-admin.jar code@your-server:/home/code/apps/QAUP_Management/qaup-admin/target/

# 方式二：使用自动化脚本（需要先配置服务器信息）
./deploy/simple/build-and-upload.sh

打包服务器操作（Ubuntu）

1. 确认jar文件已上传

ls -la qaup-admin/target/qaup-admin.jar

2. 执行打包

./deploy/simple/package-server.sh

3. 下载部署包

# 生成的文件类似：qaup-deploy-20250105-143022.tar.gz
ls -la qaup-deploy-*.tar.gz

日常更新流程

程序更新（推荐）

# macOS开发环境
mvn clean package -DskipTests
scp qaup-admin/target/qaup-admin.jar production-server:/path/to/qaup-deploy/new-app.jar

# 生产服务器
cd qaup-deploy
./update.sh

完整重新部署

# macOS → 打包服务器 → 生产服务器
# 按照上述完整流程操作

服务器配置要求

打包服务器（Ubuntu）

• ✅ Docker已安装
• ✅ 网络连接正常（拉取镜像）
• ✅ 足够磁盘空间（约2GB）

生产服务器（Ubuntu）

• ✅ Docker已安装
• ✅ 解压工具（unzip）

故障排除

Q: Docker拉取镜像很慢

A: 使用国内镜像加速器，脚本已配置daocloud加速器

Q: jar文件上传失败

A: 检查网络连接和服务器路径是否正确

Q: 打包过程中断

A: 重新运行package-server.sh脚本，会自动清理并重新开始

脚本说明

开发环境脚本：

• build-and-upload.sh - 自动构建和上传（需配置服务器信息）
• 手动操作：mvn package + scp

打包服务器脚本：

• package-server.sh - 使用已有jar文件进行打包

生产服务器脚本：

• deploy.sh - 首次部署
• update.sh - 程序更新