私有部署终端升级说明:版本升级思路以及注意事项

私有部署 私有部署版本升级数据变更  收藏
2 / 1005

为了减少私有部署用户自行升级所遇到问题(升级后版本号不显示、漏了数据变更、升级漏拉镜像等)的情况,这里给出版本升级的步骤以及需要注意的点

首先针对曾经遇到的问题给个统一回复:

  1. 跨版本升级无需逐个版本进行镜像下载和升级一遍
  2. 在所跨越的版本中相对于当前运行环境没有额外新增镜像的情况下,只需要下载最终目的版本镜像即可

关于第 2 点做个解释:

这里以 4.8.0 升级到 5.2.3 举例,由于跨越了以下几个版本变更,但是 5.1.0 的版本变更相比于当前 4.8.0 版本镜像做了拆分,相比于 4.8.0 版本新增了两个镜像 command、sc,所以需要提前拉取镜像。具体参考版本变更
涉及的数据变更
5.0.0

5.0.2

5.1.0
由于 5.1.0 版本镜像有新增,所以这里突出展示下 5.1.0 的镜像拉取操作
image.png

5.2.0

升级思路、步骤

这里同样以 4.8.0 升级到 5.2.3 举例

  1. 查看版本变更说明:确认从 4.8.0-->5.2.3 之间是否需要下载新的服务镜像、是否涉及配置文件(会直接影响微服务启动,所以需要提前修改好)的变更等
  2. 进行目的镜像的拉取:这里由于 5.1.0 版本中有新增镜像(command、sc),所以需要在正常下载新版本镜像 community 的同时,额外下载 command 和 sc 镜像
  3. 修改配置文件:修改配置文件版本号为对应目的镜像版本号,修改额外的配置文件变更(比如 5.1.0 中镜像新增导致的配置文件内容新增)
  4. 重启微服务
  5. 操作数据变更:根据跨越版本,按照从低到高的顺序进行数据变更操作,比如 5.0.0-->5.0.2-->5.1.0-->5.2.0;由于这些步骤中,镜像拉取以及配置文件变更操作已经在 2、3 中操作过,所以可以忽略此类操作。

这篇会根据实际遇到的问题以及得到的反馈进行文档更新