115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# 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 版本信息
|
|
- 错误日志内容
|
|
- 系统资源状态
|
|
- 部署步骤记录 |