Files
eightbf-analysis-go/docs/运维.md
T
gozerosandCursor bd427b57a1 feat: 换到 Gin 主流栈并补齐运维能力
HTTP 用 Gin,配置用 Viper,日志用 zap,数据用 sqlx;保留原有接口与会商行为。
顺带补上就绪探活、请求号、滚动日志、systemd 与 Dockerfile。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-04 09:51:41 +08:00

1.6 KiB
Raw Blame History

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(尚无领取互斥)。