feat: 换到 Gin 主流栈并补齐运维能力
HTTP 用 Gin,配置用 Viper,日志用 zap,数据用 sqlx;保留原有接口与会商行为。 顺带补上就绪探活、请求号、滚动日志、systemd 与 Dockerfile。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
0c45b86d67
commit
bd427b57a1
26 files changed
+1213
-302
No files matched your search
+46
@@ -0,0 +1,46 @@
|
||||
# eightbf-analysis-go 运维要点
|
||||
|
||||
对齐 [服务端开发设计要求.md](./服务端开发设计要求.md) §9–§11。
|
||||
|
||||
## 健康检查
|
||||
|
||||
| 路径 | 含义 |
|
||||
|------|------|
|
||||
| `GET /api/v1/analysis/health` | 存活:进程在听即可 |
|
||||
| `GET /api/v1/analysis/ready` | 就绪:至少 MySQL `Ping` 成功,否则 **503** |
|
||||
|
||||
Nginx / 编排探活建议:liveness → health;readiness → ready。
|
||||
|
||||
## 日志
|
||||
|
||||
| 变量 | 说明 |
|
||||
|------|------|
|
||||
| `LOG_LEVEL` | debug / info / warn / error,默认 info |
|
||||
| `LOG_FILE` | 非空则 **stdout + 滚动文件**(zap + lumberjack,控制台键值格式) |
|
||||
| `LOG_MAX_MB` | 单文件上限 MB,默认 100 |
|
||||
| `LOG_MAX_AGE_DAYS` | 保留天数,默认 14 |
|
||||
| `LOG_MAX_BACKUPS` | 备份份数,默认 14 |
|
||||
|
||||
业务键:`jobId=` `requestId=` `accountId=` `reqId=` `status=` `phase=` `model=`。
|
||||
不写 token / 密码 / 完整 dialogues。
|
||||
|
||||
采集:systemd journal 或扫 `LOG_FILE` 目录 → Filebeat/Vector → Loki/ELK。
|
||||
|
||||
## 配置校验
|
||||
|
||||
- 启动时 `Validate()`:非法 mode/端口、空 DSN 直接退出。
|
||||
- `EBA_STRICT_CONFIG=true`:live 仍用联调默认 DeerFlow 密码则 **拒绝启动**。
|
||||
- 非 strict 仅 WARN。
|
||||
|
||||
## 优雅停机
|
||||
|
||||
捕获 SIGINT/SIGTERM → `http.Server.Shutdown`(最长 15s)。
|
||||
进行中的 LiveRunner 可能仍在跑当前席;取消靠库内 `cancel_flag`。
|
||||
|
||||
## systemd
|
||||
|
||||
见 `deploy/eightbf-analysis-go.service`,环境文件建议 `/etc/eightbf-analysis-go.env`(勿提交 Git)。
|
||||
|
||||
## 单活约束
|
||||
|
||||
与 Java 实例、或第二份 Go 进程 **不要** 同时抢同一 MySQL 的 `queued`(尚无领取互斥)。
|
||||
Reference in new issue
Block a user