HTTP 用 Gin,配置用 Viper,日志用 zap,数据用 sqlx;保留原有接口与会商行为。 顺带补上就绪探活、请求号、滚动日志、systemd 与 Dockerfile。 Co-authored-by: Cursor <cursoragent@cursor.com>
1.6 KiB
1.6 KiB
eightbf-analysis-go 运维要点
对齐 服务端开发设计要求.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(尚无领取互斥)。