# 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 参数
- [ ] 优化数据库配置
- [ ] 配置日志轮转

## 常用命令参考

```bash
# 系统状态
./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 版本信息
- 错误日志内容
- 系统资源状态
- 部署步骤记录