DSH 引擎容器化:从进程迁出到跨版本升级的适配
把引擎从后端容器迁成独立服务,再扛住 0.1 → 0.2 的三处破坏性变更。
摘要
把 DSH 引擎从后端容器迁出为独立容器,并跟着官方版本滚动升级。核心成本不在「迁出去」,而在每次升级前对破坏性变更做预检与 bridge 适配,以及容器内无 docker socket 时升级只能靠宿主执行。
关键指标
部署方法
引擎迁出为独立 compose 服务(dsh-engine),bridge 负责协议适配。升级前先做破坏性预检(session.log 保留、seq getter、createUserMessage 等),升级后跑契约冒烟与回归。容器内无 docker socket,实际升级由宿主 runner 执行。
正文
背景
引擎原本塞在后端容器里,和业务代码耦合,升级要跟着整个后端一起动。把它迁成独立容器后,版本可以单独滚动,但每次升级都面临上游的破坏性变更。
方案
迁出为独立 compose 服务,bridge 专门做协议翻译。升级前先对照 changelog 做预检,列出受影响接口;升级后用契约冒烟 + 回归兜底。
踩坑
坑一:三处破坏性适配。 0.1 升到 0.1.7 有三次接口断裂:会话事件从 session.events 改成 session.log;流式 delta 直接消失,bridge 得在每条消息前合成等价 delta;工具回传只带 callId,bridge 要维护 callId 到 name 的映射。这些不预检,升级完就是满屏报错。
坑二:web 强制 bootstrap token。 0.1.7 起 web 强制鉴权且没有关闭开关,得把 token 落盘再经 nginx 兑换成 cookie,否则 web 工作台直接进不去。
坑三:容器内 IPv6 DNS 把构建卡到超时。 升级时 npm install 每连接挂到超时,根因是容器 DNS 有 AAAA、Node22 默认先试 IPv6,而 docker bridge 没有 IPv6。修法是显式指定 DNS 结果顺序优先 IPv4。
结论
引擎容器化的收益是「版本可独立滚动」,但代价是「每次升级都是一次适配工程」。真正省事的不是把引擎迁出来,而是把升级做成可预检、可回滚的流程。
数据来源
2 条局限性与适用边界
引擎版本仍是 rc,破坏性变更需每次人工预检,bridge 长期充当兼容层是隐性负债。容器内无 docker socket 导致升级只能宿主执行,无法在平台内闭环。本实录只覆盖单一引擎实例,未验证多实例滚动。