tian/QAUP_Management

Fork 0

Tian jianyong 3030eab81e 更新了一些部署配置

2025-10-16 12:28:55 +08:00

6.4 KiB

Raw Blame History

QAUP 极简离线部署方案

Spring Boot + Redis + PostgreSQL（一键部署、一键升级）

1. 设计原则

极简优先：最少的文件，最少的步骤
离线部署：预打包所有依赖，无需联网
一键操作：部署和升级都是一条命令
配置灵活：关键配置可外部修改

2. 打包准备（开发环境执行一次）

2.1 打包脚本（package.sh）

#!/bin/bash
echo "=== QAUP 打包脚本 ==="

# 1. 构建应用
mvn clean package -DskipTests

# 2. 拉取并导出镜像
docker pull openjdk:21-jre-alpine
docker pull redis:8-alpine  
docker pull postgres:17-3.5-alpine
docker save openjdk:21-jre-alpine redis:8-alpine postgres:17-3.5-alpine | gzip > images.tar.gz

# 3. 准备部署包
mkdir -p qaup-deploy
cp qaup-admin/target/qaup-admin.jar qaup-deploy/app.jar
cp deploy/simple/* qaup-deploy/
cp images.tar.gz qaup-deploy/

# 4. 打包
cd qaup-deploy && zip -r ../qaup-deploy-$(date +%Y%m%d).zip .
echo "打包完成: qaup-deploy-$(date +%Y%m%d).zip"

2.2 部署包结构（极简版）

qaup-deploy.zip
├── images.tar.gz           # Docker镜像包
├── docker-compose.yml      # 服务编排
├── app.jar                 # 应用程序
├── config.yml              # 外部配置（可修改）
├── init.sql                # 数据库初始化脚本
├── deploy.sh               # 一键部署
└── update.sh               # 一键升级

3. docker-compose.yml（极简版）

services:
  app:
    image: openjdk:21-jre-alpine
    container_name: qaup-app
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./app.jar:/app.jar
      - ./config.yml:/config.yml
    command: ["java", "-jar", "/app.jar", "--spring.config.location=/config.yml"]
    depends_on:
      - db
      - redis

  redis:
    image: redis:8-alpine
    container_name: qaup-redis
    restart: always
    command: ["redis-server", "--maxmemory", "256mb", "--maxmemory-policy", "allkeys-lru"]

  db:
    image: postgres:17-3.5-alpine
    container_name: qaup-db
    restart: always
    environment:
      POSTGRES_DB: qaup
      POSTGRES_USER: qaup
      POSTGRES_PASSWORD: qaup123
    volumes:
      - ./data:/var/lib/postgresql/data
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql

4. 外部配置文件（config.yml）

# 服务器配置
server:
  port: 8080

# 数据库配置  
spring:
  datasource:
    url: jdbc:postgresql://qaup-db:5432/qaup
    username: qaup
    password: qaup123
    driver-class-name: org.postgresql.Driver
  
  # Redis配置
  data:
    redis:
      host: qaup-redis
      port: 6379
      database: 0

# 应用配置
qaup:
  # 文件上传路径
  profile: /tmp/uploads
  # 外部接口配置（客户可修改）
  external:
    api-host: 192.168.1.100
    api-port: 8090
    
# 日志配置（简化）
logging:
  level:
    com.qaup: info
  pattern:
    console: "%d{HH:mm:ss} %-5level %logger{36} - %msg%n"

5. 数据库初始化（init.sql）

-- 创建基础表结构
CREATE TABLE IF NOT EXISTS sys_user (
    user_id SERIAL PRIMARY KEY,
    user_name VARCHAR(30) NOT NULL,
    nick_name VARCHAR(30) NOT NULL,
    password VARCHAR(100) DEFAULT '',
    status CHAR(1) DEFAULT '0',
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 插入默认管理员
INSERT INTO sys_user (user_name, nick_name, password) 
VALUES ('admin', '管理员', '$2a$10$7JB720yubVSOfvam/RtmyO4wV/hOoLsKpHpJI.VqSb/VXaVzqQqhu')
ON CONFLICT DO NOTHING;

-- 其他标准数据...

6. 一键部署（deploy.sh）

#!/bin/bash
echo "=== QAUP 一键部署 ==="

# 载入镜像
echo "载入Docker镜像..."
docker load -i images.tar.gz

# 创建数据目录
mkdir -p data

# 启动服务
echo "启动服务..."
docker compose up -d

# 等待启动
echo "等待服务启动（30秒）..."
sleep 30

echo "✅ 部署完成！访问: http://localhost:8080"
echo "默认账号: admin / admin123"

7. 客户部署（1条命令）

unzip qaup-deploy.zip && cd qaup-deploy && ./deploy.sh

8. 一键升级（update.sh）

#!/bin/bash
echo "=== QAUP 一键升级 ==="

# 检查新版本文件
if [ ! -f "new-app.jar" ]; then
    echo "❌ 请先将新版本文件重命名为 new-app.jar"
    exit 1
fi

# 验证Java版本兼容性（重要：确保jar与容器Java版本匹配）
echo "验证Java版本兼容性..."
if command -v java &> /dev/null; then
    LOCAL_JAVA_VERSION=$(java -version 2>&1 | head -1 | cut -d'"' -f2 | sed 's/[^0-9.]*\([0-9.]*\).*/\1/')
    echo "本地Java版本: $LOCAL_JAVA_VERSION"
fi

# 备份当前版本
cp app.jar app.jar.backup
echo "已备份当前版本"

# 停止应用
echo "停止应用服务..."
docker compose stop app

# 替换应用
cp new-app.jar app.jar
echo "已更新应用文件"

# 启动应用
echo "启动应用服务..."
docker compose start app

# 等待启动
echo "等待服务启动（30秒）..."
sleep 30

echo "✅ 升级完成！"
echo "如有问题，可执行回滚: cp app.jar.backup app.jar && docker compose restart app"

9. Java版本兼容性注意事项

9.1 编译与运行环境匹配

编译环境: 确保项目在Java 21环境下编译
运行环境: Docker镜像必须与编译版本匹配（openjdk:21-jre-alpine 或 eclipse-temurin:21-jre）

9.2 常见版本错误

如果遇到 UnsupportedClassVersionError，确认以下配置：

# docker-compose.yml 中必须使用Java 21镜像
services:
  app:
    # 错误示例（可能导致版本不匹配）
    # image: openjdk:17-jre-alpine
    
    # 正确示例
    image: openjdk:21-jre-alpine

9.3 版本验证命令

# 检查容器中Java版本
docker exec <container-name> java -version

# 检查jar文件编译版本
javap -cp <jar-file> -version <main-class>

9. 操作总结

开发环境（一次性）

./package.sh  # 打包部署文件

客户环境

# 首次部署
unzip qaup-deploy.zip && cd qaup-deploy && ./deploy.sh

# 日常升级  
./update.sh

# 查看状态
docker compose ps

# 查看日志
docker compose logs -f app

10. 优势总结

✅ 极简部署：解压 → 运行脚本，2步完成
✅ 极简升级：替换jar → 运行脚本，自动完成
✅ 离线友好：所有依赖预打包，无需联网
✅ 配置灵活：关键配置外部文件，可随时修改
✅ 自动初始化：数据库结构和标准数据自动创建
✅ 一键回滚：升级失败可快速回滚到上一版本

6.4 KiB Raw Blame History Unescape Escape