Skip to content

容器部署的版本升级

当 HENGSHI 版本升级后,请按照如下步骤在容器上进行升级操作。

  1. 获取并导入离线镜像。

    sh
    wget https://download.hengshi.com/releases/hengshi-sense-xxx.tar.gz
    docker load -i hengshi-sense-xxx.tar.gz
    
    # 如果容器运行时使用containerd 需要使用docker将格式转为tar再进行导入
    ctr -n k8s.io images import hengshi-sense-xxx.tar
  2. 容器环境中,升级过程中默认未进行数据备份操作,可根据需要自行进行数据备份操作容器环境备份与恢复

  3. 停止服务。

    shell
    # 进入当前部署目录停止服务
    # 例如部署在/data目录下,则完整路径通常为/data/docker-compose-x.x 
    # 请根据实际路径为准 不要直接复制粘贴运行。
    cd docker-compose-x.x
    docker-compose down
  4. 根据升级版本获取 docker-compose 部署文件,配置文件可参考 部署前准备工作

  5. 更新衡石镜像 tag。

    shell
    # 例如部署在/data目录下,则完整路径通常为/data/docker-compose-x.x 
    # 请根据实际路径为准 不要直接复制粘贴运行。
    cd docker-compose-x.x
    NEW_TAG=hengshi-sense-xxx #设置变量为新 tag
    sed -i -e "s/^HS_IMAGE_TAG=.*$/HS_IMAGE_TAG=${NEW_TAG}/" .env
  6. 启动服务,升级完成。

    shell
    # 例如部署在/data目录下,则完整路径通常为/data/docker-compose-x.x 
    # 请根据实际路径为准 不要直接复制粘贴运行。
    cd docker-compose-x.x
    docker-compose up -d
  7. 升级版本 >=4.0 注意事项

    1. 服务镜像 >= 4.0 版本开始,Metadb 默认版本为13.5,可根据需要判断是否进行升级操作
    2. 升级操作
    3. 维持现有版本
      1. 编辑 docker-compose.yaml 文件,将 metadb>image 配置下**${HS_IMAGE_TAG:-need_hs_image_version}**的参数修改为<4.0版本 镜像信息
  8. 注意事项:

    1. 5.1.x 版本 flink 已被移除,无需运行。升级后可考虑停止并清理 flink 的容器。

helm 部署的版本升级

升级过程与容器部署基本相同,同样需要注意Metadb 版本升级数据备份 >=4.0 默认版本为13.5,可根据需要判断是否进行升级操作.

非跨大版本升级, 通常都是做好数据备份,然后--version 指定版本号升级即可

example-config 配置参考

shell
helm upgrade -f example-config.yaml HENGSHI-SENSE hengshi-charts/hengshi-sense --version [chart_version] -n [namespace] #

衡石分析平台使用手册