Files
happy-life-star/SERVER_DEPLOYMENT_CHECKLIST.md
T

176 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 服务器部署检查清单
## 📋 部署前检查
### 🖥️ 服务器要求
- [ ] **操作系统**: Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+)
- [ ] **CPU**: 2核心以上
- [ ] **内存**: 4GB以上(推荐8GB
- [ ] **磁盘**: 20GB以上可用空间
- [ ] **网络**: 稳定的互联网连接
### 🔧 软件环境
- [ ] **Docker**: 20.10+ 已安装
- [ ] **Docker Compose**: 1.29+ 已安装
- [ ] **Git**: 已安装(可选)
- [ ] **Curl/Wget**: 已安装
### 🌐 网络配置
- [ ] **端口开放**: 80, 443 已开放
- [ ] **防火墙**: 已配置允许HTTP/HTTPS流量
- [ ] **域名解析**: 域名已正确解析到服务器IP(如有)
- [ ] **SSL证书**: 已准备好SSL证书文件(生产环境)
## 📦 部署包准备
### 📁 文件检查
- [ ] **部署包**: `emotion-museum-1.0.0-20250713_111829.tar.gz` 已下载
- [ ] **校验和**: SHA256校验通过
- [ ] **解压**: 部署包已成功解压
- [ ] **权限**: 脚本文件已设置执行权限
### ⚙️ 配置文件
- [ ] **环境变量**: `.env` 文件已配置
- [ ] **Coze API**: API Token 已设置
- [ ] **数据库密码**: 已修改默认密码
- [ ] **域名配置**: Nginx配置中的域名已更新(生产环境)
## 🚀 部署执行
### 🔄 部署步骤
- [ ] **1. 环境检查**: `./quick-deploy.sh` 环境检查通过
- [ ] **2. Docker安装**: Docker和Docker Compose安装成功
- [ ] **3. 配置生成**: 配置文件生成成功
- [ ] **4. 镜像构建**: Docker镜像构建成功
- [ ] **5. 服务启动**: 所有容器启动成功
### 📊 服务状态
- [ ] **MySQL**: 容器运行正常,数据库连接成功
- [ ] **Redis**: 容器运行正常,缓存服务可用
- [ ] **Nacos**: 容器运行正常,注册中心可访问
- [ ] **Gateway**: 容器运行正常,网关服务可用
- [ ] **AI Service**: 容器运行正常,AI服务可用
- [ ] **User Service**: 容器运行正常,用户服务可用
- [ ] **Frontend**: 容器运行正常,前端应用可访问
- [ ] **Nginx**: 容器运行正常,反向代理工作正常
## ✅ 部署验证
### 🌐 访问测试
- [ ] **前端首页**: http://your-domain.com 可正常访问
- [ ] **API网关**: http://your-domain.com:9000/actuator/health 返回正常
- [ ] **Nacos控制台**: http://your-domain.com:8848/nacos 可正常登录
- [ ] **API文档**: http://your-domain.com:9000/doc.html 可正常访问
### 🔍 功能测试
- [ ] **用户注册**: 新用户注册功能正常
- [ ] **用户登录**: 用户登录功能正常
- [ ] **AI对话**: AI聊天功能正常
- [ ] **数据存储**: 对话记录正常保存
- [ ] **情绪分析**: 情绪分析功能正常
### 📈 性能测试
- [ ] **响应时间**: 页面加载时间 < 3秒
- [ ] **API响应**: API接口响应时间 < 1秒
- [ ] **并发测试**: 支持预期的并发用户数
- [ ] **资源使用**: CPU和内存使用率在合理范围
## 🔒 安全配置
### 🛡️ 基础安全
- [ ] **默认密码**: 所有默认密码已修改
- [ ] **防火墙**: 只开放必要端口
- [ ] **用户权限**: 使用非root用户运行服务
- [ ] **文件权限**: 敏感文件权限设置正确
### 🔐 HTTPS配置(生产环境)
- [ ] **SSL证书**: 证书文件已正确放置
- [ ] **Nginx配置**: HTTPS配置已启用
- [ ] **HTTP重定向**: HTTP自动重定向到HTTPS
- [ ] **证书验证**: SSL证书验证通过
### 🔑 API安全
- [ ] **JWT配置**: JWT密钥已设置
- [ ] **CORS配置**: 跨域配置正确
- [ ] **限流配置**: API限流规则已启用
- [ ] **访问日志**: 访问日志记录正常
## 📊 监控配置
### 📈 服务监控
- [ ] **健康检查**: `./manage.sh health` 所有服务健康
- [ ] **日志收集**: 日志文件正常生成
- [ ] **资源监控**: `./manage.sh monitor` 监控面板正常
- [ ] **告警配置**: 异常告警机制已配置(可选)
### 💾 数据备份
- [ ] **备份脚本**: `./manage.sh backup` 备份功能正常
- [ ] **备份策略**: 定期备份计划已制定
- [ ] **恢复测试**: 数据恢复功能已测试
- [ ] **备份存储**: 备份文件存储位置已确定
## 📝 文档记录
### 📋 部署记录
- [ ] **部署时间**: 记录部署完成时间
- [ ] **版本信息**: 记录部署的版本号
- [ ] **配置信息**: 记录重要配置参数
- [ ] **访问信息**: 记录访问地址和账号
### 📖 运维文档
- [ ] **管理命令**: 熟悉 `./manage.sh` 各项命令
- [ ] **故障排除**: 了解常见问题解决方案
- [ ] **更新流程**: 了解服务更新流程
- [ ] **联系方式**: 记录技术支持联系方式
## 🎯 部署后任务
### 🔧 优化配置
- [ ] **性能调优**: 根据实际负载调整配置
- [ ] **缓存策略**: 优化Redis缓存配置
- [ ] **数据库优化**: 调整MySQL配置参数
- [ ] **网络优化**: 优化Nginx配置
### 📊 监控设置
- [ ] **日志轮转**: 配置日志文件轮转
- [ ] **磁盘清理**: 设置定期清理任务
- [ ] **性能监控**: 配置性能监控工具
- [ ] **告警通知**: 设置异常告警通知
### 🔄 维护计划
- [ ] **更新计划**: 制定定期更新计划
- [ ] **备份计划**: 制定数据备份计划
- [ ] **安全审计**: 制定安全审计计划
- [ ] **容量规划**: 制定容量扩展计划
## ⚠️ 注意事项
### 🚨 重要提醒
1. **Coze API Token**: 必须配置正确的API Token,否则AI功能无法使用
2. **数据库密码**: 生产环境必须修改默认密码
3. **防火墙配置**: 确保只开放必要的端口
4. **SSL证书**: 生产环境强烈建议使用HTTPS
5. **定期备份**: 重要数据必须定期备份
### 📞 紧急联系
- **技术支持**: support@emotion-museum.com
- **紧急热线**: 400-xxx-xxxx
- **在线文档**: https://docs.emotion-museum.com
---
## ✅ 部署完成确认
**部署工程师**: ________________
**部署时间**: ________________
**版本号**: emotion-museum-1.0.0-20250713_111829
**服务器IP**: ________________
**域名**: ________________
**签名确认**: ________________
**日期**: ________________
---
**🎉 恭喜完成部署!请妥善保存此检查清单作为部署记录。**