forked from niuniu/llm-intelligence
fix deployment and frontend build regressions
This commit is contained in:
51
RUNBOOK.md
51
RUNBOOK.md
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user