QAUP_Management/deploy/docs/DEPLOYMENT-CHECKLIST.md

QAUP Docker 部署检查清单

部署前检查

✅ 环境准备

• 确认操作系统版本 (Ubuntu 18.04+ 推荐)
• 安装 Docker (20.10+)
• 安装 Docker Compose (1.29+)
• 确认用户在 docker 组中
• 确认网络连接正常

✅ 文件准备

• 项目文件完整下载/解压
• 进入 deploy 目录 (cd QAUP-Management/deploy)
• 运行路径验证 (./test-paths.sh)
• 所有脚本具有执行权限

✅ 数据准备

• 查看数据文件状态 (./docker/postgres/db-manager.sh prepare-status)
• 选择数据准备方式：
  • 全新部署：./docker/postgres/db-manager.sh prepare-default
  • 现有系统迁移：./docker/postgres/db-manager.sh prepare-export
  • 自定义组合：./docker/postgres/db-manager.sh prepare-custom
• 验证数据文件已准备完成

✅ 配置检查

• 复制 .env.template 为 .env
• 修改数据库密码 (POSTGRES_PASSWORD, APP_DB_PASSWORD)
• 设置 Redis 密码 (REDIS_PASSWORD)
• 配置服务器域名 (SERVER_NAME)
• 调整 JVM 参数 (根据服务器配置)

部署过程检查

✅ 系统验证

• 运行环境验证 (./docker/validate-environment.sh)
• 检查端口占用情况
• 确认磁盘空间充足 (至少 20GB)
• 确认内存充足 (至少 4GB)

✅ 部署执行

• 运行完整部署 (./deploy.sh install)
• 等待所有服务启动完成
• 检查容器状态 (docker ps)
• 验证服务健康检查

✅ 功能验证

• 访问前端页面 (http://localhost)
• 测试 API 接口 (http://localhost/prod-api)
• 检查健康检查端点 (http://localhost/health)
• 验证数据库连接
• 测试文件上传功能

部署后检查

✅ 监控配置

• 查看系统监控 (./docker/monitor.sh watch)
• 检查日志输出 (./deploy.sh logs)
• 验证告警配置
• 测试备份功能

✅ 安全检查

• 修改默认密码
• 检查防火墙配置
• 验证网络隔离
• 确认敏感信息保护

✅ 性能优化

• 监控资源使用情况
• 调整 JVM 参数
• 优化数据库配置
• 配置日志轮转

常用命令参考

# 系统状态
./docker/ops-manager.sh overview

# 查看日志
./deploy.sh logs [服务名]

# 重启服务
./deploy.sh restart

# 备份数据
./docker/backup-restore.sh backup

# 系统监控
./docker/monitor.sh watch

# 性能分析
./docker/ops-manager.sh performance

故障排除

如果遇到问题，请按以下顺序检查：

1. 路径配置: 运行 ./test-paths.sh 验证
2. 环境验证: 运行 ./docker/validate-environment.sh
3. 容器状态: 运行 docker ps -a 查看容器状态
4. 日志分析: 运行 ./deploy.sh logs 查看详细日志
5. 资源检查: 运行 ./docker/monitor.sh health 检查资源

更多故障排除信息请参考 docs/故障排除.md。

联系支持

如果遇到无法解决的问题，请提供以下信息：

• 操作系统版本
• Docker 版本信息
• 错误日志内容
• 系统资源状态
• 部署步骤记录