fix deployment and frontend build regressions

This commit is contained in:
2026-05-21 15:30:24 +08:00
parent 31f1b510c3
commit b430fb9301
6 changed files with 276 additions and 99 deletions

View File

@@ -1,8 +1,7 @@
# LLM Intelligence Hub - 运维手册
> 版本: v1.0
> 日期: 2026-05-10
> 适用版本: Phase 1
> 版本: v1.1
> 日期: 2026-05-21
---
@@ -10,7 +9,7 @@
### 启动全部服务
```bash
docker-compose up -d
docker-compose up -d --build
```
### 停止服务
@@ -28,6 +27,12 @@ docker-compose logs -f db
## 日常巡检
### 应用健康
```bash
curl http://localhost:8080/health
curl http://localhost:8080/api/v1/models
```
### 数据库健康
```bash
psql "$DATABASE_URL" -c "SELECT COUNT(*) FROM models WHERE deleted_at IS NULL"
@@ -61,13 +66,19 @@ df -h /tmp
### 日报未生成
1. 检查 cron: `crontab -l | grep llm-intelligence`
2. 手动行: `bash scripts/run_daily.sh`
3. 检查降级报告: `ls reports/daily/*.md | tail -1`
2. 手动行: `bash scripts/run_daily.sh`
3. 检查最近日报: `ls reports/daily/*.md | tail -1`
### 前端无法访问
1. 检查 Nginx: `docker-compose ps nginx`
2. 检查 dist: `ls frontend/dist/`
3. 检查端口: `netstat -tlnp | grep 80`
1. 检查应用容器: `docker-compose ps app`
2. 检查首页响应: `curl -I http://localhost:8080/`
3. 检查 API 响应: `curl http://localhost:8080/api/v1/models`
4. 查看应用日志: `docker-compose logs -f app`
### 静态资源 404
1. 重新构建镜像: `docker-compose up -d --build`
2. 本地校验前端构建: `cd frontend && npm run build`
3. 确认容器内含有前端产物: `docker-compose exec app ls /app/frontend/dist`
---
@@ -83,7 +94,7 @@ bash scripts/backup.sh
gunzip < backup_file.sql.gz | psql "$DATABASE_URL"
```
### 定时备份 (cron)
### 定时备份
```bash
0 2 * * * cd /path/to/llm-intelligence && bash scripts/backup.sh >> /tmp/backup.log 2>&1
```
@@ -94,24 +105,14 @@ gunzip < backup_file.sql.gz | psql "$DATABASE_URL"
| 指标 | 告警阈值 | 检查命令 |
|------|----------|----------|
| 模型数 | < 300 | `SELECT COUNT(*) FROM models` |
| 采集成功率 | < 95% | `SELECT success_rate FROM collector_stats` |
| 模型数 | `< 300` | `SELECT COUNT(*) FROM models` |
| 采集成功率 | `< 95%` | `SELECT success_rate FROM collector_stats` |
| 数据库连接 | 失败 | `pg_isready` |
| 磁盘空间 | > 80% | `df -h` |
---
## 扩容指南
### 垂直扩容
增加 PostgreSQL 内存和 CPU。
### 水平扩容
使用读写分离或分片Phase 2+)。
| 磁盘空间 | `> 80%` | `df -h` |
---
## 联系信息
- 维护者:
- 项目路径: /home/long/project/llm-intelligence
- 维护者:
- 项目路径: `D:\project\llm-intelligence`