添加 IntelliJ IDEA 项目配置文件
This commit is contained in:
ylweng
518
docs/部署和运维文档.md
Normal file
518
docs/部署和运维文档.md
Normal file
@@ -0,0 +1,518 @@
|
||||
# 部署和运维文档
|
||||
|
||||
## 🏗️ 部署架构
|
||||
|
||||
### 生产环境架构
|
||||
```
|
||||
┌─────────────┐
|
||||
│ 用户访问 │
|
||||
└─────────────┘
|
||||
│
|
||||
┌─────────────┐
|
||||
│ CDN/负载均衡 │
|
||||
└─────────────┘
|
||||
│
|
||||
┌──────────────┼──────────────┐
|
||||
│ │ │
|
||||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||||
│ 官网服务 │ │ 管理后台 │ │ 小程序 │
|
||||
│ (Nginx) │ │ (Nginx) │ │ (CDN) │
|
||||
└─────────────┘ └─────────────┘ └─────────────┘
|
||||
│
|
||||
┌─────────────┐
|
||||
│ API网关 │
|
||||
│ (Nginx) │
|
||||
└─────────────┘
|
||||
│
|
||||
┌──────────────┼──────────────┐
|
||||
│ │ │
|
||||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||||
│ 后端服务1 │ │ 后端服务2 │ │ 后端服务N │
|
||||
│ (PM2) │ │ (PM2) │ │ (PM2) │
|
||||
└─────────────┘ └─────────────┘ └─────────────┘
|
||||
│
|
||||
┌──────────────┼──────────────┐
|
||||
│ │ │
|
||||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||||
│ MySQL │ │ Redis │ │ 文件存储 │
|
||||
│ (主从复制) │ │ (集群) │ │ (MinIO) │
|
||||
└─────────────┘ └─────────────┘ └─────────────┘
|
||||
```
|
||||
|
||||
## 🚀 部署流程
|
||||
|
||||
### 1. 服务器准备
|
||||
|
||||
#### 基础环境
|
||||
```bash
|
||||
# 更新系统
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# 安装基础软件
|
||||
sudo apt install -y nginx nodejs npm mysql-server redis-server git
|
||||
|
||||
# 安装Node.js 18
|
||||
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
|
||||
sudo apt-get install -y nodejs
|
||||
|
||||
# 安装PM2
|
||||
sudo npm install -g pm2
|
||||
```
|
||||
|
||||
#### 目录结构
|
||||
```bash
|
||||
# 创建项目目录
|
||||
sudo mkdir -p /var/www/niumall
|
||||
sudo mkdir -p /var/www/niumall/website
|
||||
sudo mkdir -p /var/www/niumall/admin
|
||||
sudo mkdir -p /var/www/niumall/backend
|
||||
sudo mkdir -p /var/www/niumall/logs
|
||||
sudo mkdir -p /var/www/niumall/uploads
|
||||
|
||||
# 设置权限
|
||||
sudo chown -R www-data:www-data /var/www/niumall
|
||||
sudo chmod -R 755 /var/www/niumall
|
||||
```
|
||||
|
||||
### 2. 数据库部署
|
||||
|
||||
#### MySQL配置
|
||||
```bash
|
||||
# 安全配置
|
||||
sudo mysql_secure_installation
|
||||
|
||||
# 创建数据库和用户
|
||||
mysql -u root -p
|
||||
```
|
||||
|
||||
```sql
|
||||
-- 创建数据库
|
||||
CREATE DATABASE jiebandata CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
|
||||
-- 创建用户
|
||||
CREATE USER 'niumall'@'localhost' IDENTIFIED BY 'your_secure_password';
|
||||
GRANT ALL PRIVILEGES ON jiebandata.* TO 'niumall'@'localhost';
|
||||
FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
#### Redis配置
|
||||
```bash
|
||||
# 编辑Redis配置
|
||||
sudo vim /etc/redis/redis.conf
|
||||
|
||||
# 关键配置项
|
||||
bind 127.0.0.1
|
||||
port 6379
|
||||
requirepass your_redis_password
|
||||
maxmemory 2gb
|
||||
maxmemory-policy allkeys-lru
|
||||
|
||||
# 重启Redis
|
||||
sudo systemctl restart redis-server
|
||||
sudo systemctl enable redis-server
|
||||
```
|
||||
|
||||
### 3. 后端服务部署
|
||||
|
||||
#### 代码部署
|
||||
```bash
|
||||
# 克隆代码
|
||||
cd /var/www/niumall
|
||||
sudo git clone <repository-url> .
|
||||
|
||||
# 安装后端依赖
|
||||
cd backend
|
||||
sudo npm install --production
|
||||
|
||||
# 复制环境配置
|
||||
sudo cp .env.example .env.production
|
||||
sudo vim .env.production
|
||||
```
|
||||
|
||||
#### 环境配置
|
||||
```bash
|
||||
# .env.production
|
||||
NODE_ENV=production
|
||||
PORT=3001
|
||||
DB_HOST=localhost
|
||||
DB_PORT=3306
|
||||
DB_NAME=jiebandata
|
||||
DB_USER=niumall
|
||||
DB_PASSWORD=your_secure_password
|
||||
REDIS_HOST=localhost
|
||||
REDIS_PORT=6379
|
||||
REDIS_PASSWORD=your_redis_password
|
||||
JWT_SECRET=your_jwt_secret_key
|
||||
```
|
||||
|
||||
#### PM2配置
|
||||
```javascript
|
||||
// ecosystem.config.js
|
||||
module.exports = {
|
||||
apps: [{
|
||||
name: 'niumall-backend',
|
||||
script: 'src/app.js',
|
||||
cwd: '/var/www/niumall/backend',
|
||||
instances: 'max',
|
||||
exec_mode: 'cluster',
|
||||
env: {
|
||||
NODE_ENV: 'production',
|
||||
PORT: 3001
|
||||
},
|
||||
error_file: '/var/www/niumall/logs/backend-error.log',
|
||||
out_file: '/var/www/niumall/logs/backend-out.log',
|
||||
log_file: '/var/www/niumall/logs/backend.log',
|
||||
time: true
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
#### 启动后端服务
|
||||
```bash
|
||||
# 数据库迁移
|
||||
cd /var/www/niumall/backend
|
||||
sudo npm run db:migrate
|
||||
sudo npm run db:seed
|
||||
|
||||
# 启动服务
|
||||
sudo pm2 start ecosystem.config.js
|
||||
sudo pm2 save
|
||||
sudo pm2 startup
|
||||
```
|
||||
|
||||
### 4. 前端部署
|
||||
|
||||
#### 管理后台构建
|
||||
```bash
|
||||
cd /var/www/niumall/admin-system
|
||||
sudo npm install
|
||||
sudo npm run build:prod
|
||||
|
||||
# 复制构建文件
|
||||
sudo cp -r dist/* /var/www/niumall/admin/
|
||||
```
|
||||
|
||||
#### 官网部署
|
||||
```bash
|
||||
# 直接复制静态文件
|
||||
sudo cp -r website/* /var/www/niumall/website/
|
||||
```
|
||||
|
||||
### 5. Nginx配置
|
||||
|
||||
#### 主配置文件
|
||||
```nginx
|
||||
# /etc/nginx/sites-available/niumall
|
||||
server {
|
||||
listen 80;
|
||||
server_name niumall.com www.niumall.com;
|
||||
return 301 https://$server_name$request_uri;
|
||||
}
|
||||
|
||||
server {
|
||||
listen 443 ssl http2;
|
||||
server_name niumall.com www.niumall.com;
|
||||
|
||||
ssl_certificate /path/to/ssl/certificate.crt;
|
||||
ssl_certificate_key /path/to/ssl/private.key;
|
||||
|
||||
# 官网
|
||||
location / {
|
||||
root /var/www/niumall/website;
|
||||
index index.html;
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# 管理后台
|
||||
location /admin {
|
||||
alias /var/www/niumall/admin;
|
||||
index index.html;
|
||||
try_files $uri $uri/ /admin/index.html;
|
||||
}
|
||||
|
||||
# API接口
|
||||
location /api {
|
||||
proxy_pass http://127.0.0.1:3001;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
# 文件上传
|
||||
location /uploads {
|
||||
alias /var/www/niumall/uploads;
|
||||
expires 1M;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 启用配置
|
||||
```bash
|
||||
# 创建软链接
|
||||
sudo ln -s /etc/nginx/sites-available/niumall /etc/nginx/sites-enabled/
|
||||
|
||||
# 测试配置
|
||||
sudo nginx -t
|
||||
|
||||
# 重启Nginx
|
||||
sudo systemctl restart nginx
|
||||
sudo systemctl enable nginx
|
||||
```
|
||||
|
||||
## 🔧 运维管理
|
||||
|
||||
### 1. 监控配置
|
||||
|
||||
#### 系统监控
|
||||
```bash
|
||||
# 安装监控工具
|
||||
sudo npm install -g pm2-logrotate
|
||||
sudo pm2 install pm2-server-monit
|
||||
|
||||
# 配置日志轮转
|
||||
sudo pm2 set pm2-logrotate:max_size 10M
|
||||
sudo pm2 set pm2-logrotate:retain 30
|
||||
```
|
||||
|
||||
#### 健康检查脚本
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# health-check.sh
|
||||
|
||||
# 检查后端服务
|
||||
if curl -f http://localhost:3001/api/health > /dev/null 2>&1; then
|
||||
echo "✓ Backend service is healthy"
|
||||
else
|
||||
echo "✗ Backend service is down"
|
||||
# 重启服务
|
||||
pm2 restart niumall-backend
|
||||
fi
|
||||
|
||||
# 检查数据库
|
||||
if mysqladmin ping -h localhost -u niumall -p'password' --silent; then
|
||||
echo "✓ MySQL is healthy"
|
||||
else
|
||||
echo "✗ MySQL is down"
|
||||
fi
|
||||
|
||||
# 检查Redis
|
||||
if redis-cli ping > /dev/null 2>&1; then
|
||||
echo "✓ Redis is healthy"
|
||||
else
|
||||
echo "✗ Redis is down"
|
||||
fi
|
||||
```
|
||||
|
||||
### 2. 备份策略
|
||||
|
||||
#### 数据库备份
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# backup.sh
|
||||
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
BACKUP_DIR="/var/backups/niumall"
|
||||
|
||||
# 创建备份目录
|
||||
mkdir -p $BACKUP_DIR
|
||||
|
||||
# MySQL备份
|
||||
mysqldump -u niumall -p'password' jiebandata > $BACKUP_DIR/mysql_$DATE.sql
|
||||
|
||||
# 压缩备份
|
||||
gzip $BACKUP_DIR/mysql_$DATE.sql
|
||||
|
||||
# 文件备份
|
||||
tar -czf $BACKUP_DIR/uploads_$DATE.tar.gz /var/www/niumall/uploads
|
||||
|
||||
# 清理老备份（保留30天）
|
||||
find $BACKUP_DIR -name "*.gz" -mtime +30 -delete
|
||||
|
||||
echo "Backup completed: $DATE"
|
||||
```
|
||||
|
||||
#### 定时任务
|
||||
```bash
|
||||
# 编辑crontab
|
||||
sudo crontab -e
|
||||
|
||||
# 添加任务
|
||||
# 每日凌晨2点备份
|
||||
0 2 * * * /path/to/backup.sh
|
||||
|
||||
# 每小时健康检查
|
||||
0 * * * * /path/to/health-check.sh
|
||||
|
||||
# 每日凌晨重启PM2（可选）
|
||||
0 3 * * 0 pm2 restart all
|
||||
```
|
||||
|
||||
### 3. 日志管理
|
||||
|
||||
#### 日志配置
|
||||
```bash
|
||||
# 创建日志目录
|
||||
sudo mkdir -p /var/log/niumall
|
||||
|
||||
# 配置logrotate
|
||||
sudo vim /etc/logrotate.d/niumall
|
||||
```
|
||||
|
||||
```
|
||||
/var/log/niumall/*.log {
|
||||
daily
|
||||
missingok
|
||||
rotate 30
|
||||
compress
|
||||
delaycompress
|
||||
notifempty
|
||||
create 644 www-data www-data
|
||||
}
|
||||
```
|
||||
|
||||
#### 日志查看命令
|
||||
```bash
|
||||
# 查看后端日志
|
||||
sudo pm2 logs niumall-backend
|
||||
|
||||
# 查看Nginx日志
|
||||
sudo tail -f /var/log/nginx/access.log
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
|
||||
# 查看系统日志
|
||||
sudo journalctl -u nginx
|
||||
sudo journalctl -u mysql
|
||||
```
|
||||
|
||||
### 4. 性能优化
|
||||
|
||||
#### 数据库优化
|
||||
```sql
|
||||
-- 查看慢查询
|
||||
SHOW VARIABLES LIKE 'slow_query_log';
|
||||
SET GLOBAL slow_query_log = 'ON';
|
||||
SET GLOBAL long_query_time = 1;
|
||||
|
||||
-- 分析查询性能
|
||||
EXPLAIN SELECT * FROM orders WHERE status = 'pending';
|
||||
|
||||
-- 添加索引
|
||||
CREATE INDEX idx_orders_status ON orders(status);
|
||||
CREATE INDEX idx_orders_created_at ON orders(created_at);
|
||||
```
|
||||
|
||||
#### Redis优化
|
||||
```bash
|
||||
# 监控Redis性能
|
||||
redis-cli --latency-history -i 1
|
||||
|
||||
# 查看内存使用
|
||||
redis-cli info memory
|
||||
|
||||
# 清理过期key
|
||||
redis-cli --scan --pattern "expired:*" | xargs redis-cli del
|
||||
```
|
||||
|
||||
## 🚨 故障处理
|
||||
|
||||
### 常见问题排查
|
||||
|
||||
#### 服务无法启动
|
||||
```bash
|
||||
# 检查端口占用
|
||||
sudo netstat -tlnp | grep :3001
|
||||
|
||||
# 检查进程状态
|
||||
sudo pm2 status
|
||||
|
||||
# 查看错误日志
|
||||
sudo pm2 logs niumall-backend --err
|
||||
|
||||
# 重启服务
|
||||
sudo pm2 restart niumall-backend
|
||||
```
|
||||
|
||||
#### 数据库连接失败
|
||||
```bash
|
||||
# 检查MySQL状态
|
||||
sudo systemctl status mysql
|
||||
|
||||
# 检查连接数
|
||||
mysql -u root -p -e "SHOW PROCESSLIST;"
|
||||
|
||||
# 重启MySQL
|
||||
sudo systemctl restart mysql
|
||||
```
|
||||
|
||||
#### 内存不足
|
||||
```bash
|
||||
# 查看内存使用
|
||||
free -h
|
||||
sudo ps aux --sort=-%mem | head
|
||||
|
||||
# 清理缓存
|
||||
sudo sync && echo 3 | sudo tee /proc/sys/vm/drop_caches
|
||||
|
||||
# 重启占用内存大的进程
|
||||
sudo pm2 restart all
|
||||
```
|
||||
|
||||
### 紧急恢复流程
|
||||
|
||||
#### 数据库恢复
|
||||
```bash
|
||||
# 停止应用
|
||||
sudo pm2 stop all
|
||||
|
||||
# 恢复数据库
|
||||
mysql -u root -p jiebandata < /var/backups/niumall/mysql_20240120.sql
|
||||
|
||||
# 重启应用
|
||||
sudo pm2 start all
|
||||
```
|
||||
|
||||
#### 代码回滚
|
||||
```bash
|
||||
# 查看提交历史
|
||||
cd /var/www/niumall
|
||||
sudo git log --oneline -10
|
||||
|
||||
# 回滚到指定版本
|
||||
sudo git reset --hard <commit-hash>
|
||||
|
||||
# 重新部署
|
||||
cd backend && sudo npm run build
|
||||
sudo pm2 restart all
|
||||
```
|
||||
|
||||
## 📊 监控指标
|
||||
|
||||
### 关键指标
|
||||
- **服务可用性**: > 99.9%
|
||||
- **响应时间**: < 200ms (API), < 3s (页面)
|
||||
- **错误率**: < 0.1%
|
||||
- **CPU使用率**: < 70%
|
||||
- **内存使用率**: < 80%
|
||||
- **磁盘使用率**: < 85%
|
||||
|
||||
### 告警配置
|
||||
```bash
|
||||
# CPU使用率告警
|
||||
if [ $(top -bn1 | grep "Cpu(s)" | awk '{print $2}' | cut -d'%' -f1) > 70 ]; then
|
||||
echo "High CPU usage detected" | mail -s "Server Alert" admin@niumall.com
|
||||
fi
|
||||
|
||||
# 磁盘空间告警
|
||||
if [ $(df / | tail -1 | awk '{print $5}' | cut -d'%' -f1) > 85 ]; then
|
||||
echo "Low disk space" | mail -s "Storage Alert" admin@niumall.com
|
||||
fi
|
||||
```
|
||||
|
||||
## 📞 运维联系方式
|
||||
|
||||
- **运维负责人**: ops@niumall.com
|
||||
- **紧急联系**: +86 138-xxxx-xxxx
|
||||
- **技术支持**: tech@niumall.com
|
||||
- **监控告警**: alert@niumall.com
|
||||
Reference in New Issue
Block a user