init
This commit is contained in:
jiangdong
276
docs/DEPLOYMENT.md
Normal file
276
docs/DEPLOYMENT.md
Normal file
@@ -0,0 +1,276 @@
|
||||
# 部署脚本示例
|
||||
|
||||
## Linux服务器部署步骤
|
||||
|
||||
### 1. 安装必要软件
|
||||
```bash
|
||||
# 更新系统
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# 安装Nginx
|
||||
sudo apt install nginx -y
|
||||
|
||||
# 安装.NET 8 Runtime
|
||||
wget https://dot.net/v1/dotnet-install.sh
|
||||
chmod +x dotnet-install.sh
|
||||
./dotnet-install.sh --channel 8.0 --runtime aspnetcore
|
||||
|
||||
# 安装Node.js
|
||||
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
|
||||
sudo apt install nodejs -y
|
||||
|
||||
# 安装MySQL
|
||||
sudo apt install mysql-server -y
|
||||
```
|
||||
|
||||
### 2. 创建数据库
|
||||
```bash
|
||||
sudo mysql -u root -p
|
||||
|
||||
CREATE DATABASE fatemaster CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
CREATE USER 'fatemaster'@'localhost' IDENTIFIED BY 'your_password';
|
||||
GRANT ALL PRIVILEGES ON fatemaster.* TO 'fatemaster'@'localhost';
|
||||
FLUSH PRIVILEGES;
|
||||
EXIT;
|
||||
```
|
||||
|
||||
### 3. 部署后端
|
||||
```bash
|
||||
# 构建项目
|
||||
cd backend/FateMaster.API
|
||||
dotnet publish -c Release -o /var/www/fatemaster-api
|
||||
|
||||
# 创建systemd服务
|
||||
sudo nano /etc/systemd/system/fatemaster-api.service
|
||||
```
|
||||
|
||||
服务配置内容：
|
||||
```ini
|
||||
[Unit]
|
||||
Description=FateMaster API
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
WorkingDirectory=/var/www/fatemaster-api
|
||||
ExecStart=/root/.dotnet/dotnet /var/www/fatemaster-api/FateMaster.API.dll
|
||||
Restart=always
|
||||
RestartSec=10
|
||||
KillSignal=SIGINT
|
||||
SyslogIdentifier=fatemaster-api
|
||||
User=www-data
|
||||
Environment=ASPNETCORE_ENVIRONMENT=Production
|
||||
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
启动服务：
|
||||
```bash
|
||||
sudo systemctl enable fatemaster-api
|
||||
sudo systemctl start fatemaster-api
|
||||
sudo systemctl status fatemaster-api
|
||||
```
|
||||
|
||||
### 4. 部署前端
|
||||
```bash
|
||||
# 构建用户端
|
||||
cd frontend/fatemaster-web
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# 部署到Nginx
|
||||
sudo cp -r dist/* /var/www/fatemaster-web/
|
||||
|
||||
# 构建管理后台
|
||||
cd ../fatemaster-admin
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# 部署到Nginx
|
||||
sudo cp -r dist/* /var/www/fatemaster-admin/
|
||||
```
|
||||
|
||||
### 5. 配置Nginx
|
||||
```bash
|
||||
sudo nano /etc/nginx/sites-available/fatemaster
|
||||
```
|
||||
|
||||
配置内容：
|
||||
```nginx
|
||||
# 用户端
|
||||
server {
|
||||
listen 80;
|
||||
server_name yourdomain.com;
|
||||
|
||||
root /var/www/fatemaster-web;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /api {
|
||||
proxy_pass http://localhost:5000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
}
|
||||
}
|
||||
|
||||
# 管理后台
|
||||
server {
|
||||
listen 80;
|
||||
server_name admin.yourdomain.com;
|
||||
|
||||
root /var/www/fatemaster-admin;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /api {
|
||||
proxy_pass http://localhost:5000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
启用配置：
|
||||
```bash
|
||||
sudo ln -s /etc/nginx/sites-available/fatemaster /etc/nginx/sites-enabled/
|
||||
sudo nginx -t
|
||||
sudo systemctl restart nginx
|
||||
```
|
||||
|
||||
### 6. 配置SSL证书（使用Let's Encrypt）
|
||||
```bash
|
||||
sudo apt install certbot python3-certbot-nginx -y
|
||||
sudo certbot --nginx -d yourdomain.com -d admin.yourdomain.com
|
||||
```
|
||||
|
||||
### 7. 配置防火墙
|
||||
```bash
|
||||
sudo ufw allow 80/tcp
|
||||
sudo ufw allow 443/tcp
|
||||
sudo ufw allow 22/tcp
|
||||
sudo ufw enable
|
||||
```
|
||||
|
||||
### 8. 设置定时备份
|
||||
```bash
|
||||
sudo nano /usr/local/bin/backup-fatemaster.sh
|
||||
```
|
||||
|
||||
备份脚本：
|
||||
```bash
|
||||
#!/bin/bash
|
||||
BACKUP_DIR="/backups/fatemaster"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
# 创建备份目录
|
||||
mkdir -p $BACKUP_DIR
|
||||
|
||||
# 备份数据库
|
||||
mysqldump -u fatemaster -p'your_password' fatemaster > $BACKUP_DIR/db_$DATE.sql
|
||||
|
||||
# 备份上传的文件（如果有）
|
||||
# tar -czf $BACKUP_DIR/files_$DATE.tar.gz /var/www/uploads
|
||||
|
||||
# 删除7天前的备份
|
||||
find $BACKUP_DIR -name "*.sql" -mtime +7 -delete
|
||||
|
||||
echo "Backup completed: $DATE"
|
||||
```
|
||||
|
||||
设置定时任务：
|
||||
```bash
|
||||
sudo chmod +x /usr/local/bin/backup-fatemaster.sh
|
||||
sudo crontab -e
|
||||
|
||||
# 添加每天凌晨2点执行备份
|
||||
0 2 * * * /usr/local/bin/backup-fatemaster.sh >> /var/log/fatemaster-backup.log 2>&1
|
||||
```
|
||||
|
||||
## 更新部署
|
||||
|
||||
### 更新后端
|
||||
```bash
|
||||
cd /path/to/source/backend/FateMaster.API
|
||||
git pull
|
||||
dotnet publish -c Release -o /var/www/fatemaster-api
|
||||
sudo systemctl restart fatemaster-api
|
||||
```
|
||||
|
||||
### 更新前端
|
||||
```bash
|
||||
# 用户端
|
||||
cd /path/to/source/frontend/fatemaster-web
|
||||
git pull
|
||||
npm install
|
||||
npm run build
|
||||
sudo cp -r dist/* /var/www/fatemaster-web/
|
||||
|
||||
# 管理后台
|
||||
cd ../fatemaster-admin
|
||||
git pull
|
||||
npm install
|
||||
npm run build
|
||||
sudo cp -r dist/* /var/www/fatemaster-admin/
|
||||
```
|
||||
|
||||
## 监控和维护
|
||||
|
||||
### 查看服务日志
|
||||
```bash
|
||||
# 查看API日志
|
||||
sudo journalctl -u fatemaster-api -f
|
||||
|
||||
# 查看Nginx日志
|
||||
sudo tail -f /var/log/nginx/access.log
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
```
|
||||
|
||||
### 性能监控
|
||||
```bash
|
||||
# 查看系统资源
|
||||
htop
|
||||
|
||||
# 查看数据库性能
|
||||
sudo mysqladmin -u root -p processlist
|
||||
sudo mysqladmin -u root -p status
|
||||
```
|
||||
|
||||
## 故障排查
|
||||
|
||||
### API无法启动
|
||||
```bash
|
||||
# 检查服务状态
|
||||
sudo systemctl status fatemaster-api
|
||||
|
||||
# 检查端口占用
|
||||
sudo netstat -tlnp | grep 5000
|
||||
|
||||
# 检查数据库连接
|
||||
mysql -u fatemaster -p -h localhost fatemaster
|
||||
```
|
||||
|
||||
### 前端访问404
|
||||
```bash
|
||||
# 检查Nginx配置
|
||||
sudo nginx -t
|
||||
|
||||
# 检查文件权限
|
||||
ls -la /var/www/fatemaster-web/
|
||||
```
|
||||
Reference in New Issue
Block a user