apollo icon indicating copy to clipboard operation
apollo copied to clipboard

2.4.0 Server Smooth Upgrade Consultation

Open guozongkang opened this issue 2 weeks ago • 2 comments

我们希望从低版本的服务升级到2.4.0最新版本,admin portal config三个服务是单独部署的。 可以不停机升级么? 1.9.0的admin portal config不动。 第一步先升级1.9.0的DB到2.4.0. 第二步是升级1.9.0的config到2.4.0,第三步是升级1.9.0的admin到2.4.0, 那么升级期间有个中间态,及1.9.0的portal使用2.4.0的admin,会有问题么?

guozongkang avatar Dec 05 '25 10:12 guozongkang

Hi @guozongkang! I'm Dosu and I’m helping the apollo team.

可以不停机升级到 2.4.0,推荐的顺序是:先升级数据库(按顺序执行所有中间版本的 SQL 脚本,不能跳过),然后依次升级 config、admin、portal 服务。升级过程中,服务可以逐个重启,不需要整体停机,升级数据库时系统也可以正常运行,配置也可以修改 [1] [2]

关于你关心的中间态(1.9.0 portal 对接 2.4.0 admin):

  • Apollo 的 portal 和 admin service 之间通过 REST API 通信,代码中没有强制的版本校验或兼容性检查,理论上可以短时间混用 [3]
  • 但兼容性依赖于 REST API 和 DTO 没有发生破坏性变更。如果 admin service 的接口或数据结构有变化,老版本 portal 可能会遇到问题。实际升级窗口建议尽量缩短,避免长时间混用不同版本,升级顺序建议严格按照“数据库 → config → admin → portal”执行,升级期间及时观察 portal 日志和功能是否正常 [1]

升级前请务必备份数据库。升级后建议重启 config service,避免缓存不一致 [1]

总结:可以不停机升级,升级顺序没问题,混用期间理论可行但有 API 兼容性风险,建议尽快完成所有服务的升级。

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

Chat with Dosu Open in Cursor Join Discord Share on X

dosubot[bot] avatar Dec 05 '25 10:12 dosubot[bot]

好的

guozongkang avatar Dec 05 '25 10:12 guozongkang