内网升级运维项目

1.1 版本

1.2 应用场景

为满足客户的新需求以及完善之前版本某些功能的不足之处，FineReport/FineBI在不断地更新迭代。

小明部署好容器化FR/BI工程后，需要定期对工程进行更新升级，但是他发现传统的升级方式存在着一些问题。

1）FineReport内网/FineBI的小版本升级需要手动更换JAR包，操作门槛高。

2）由于部分版本的兼容问题，用户需要升级指定版本而非最新版本，只能手动更换JAR包，操作门槛高。

3）FineReport外网升级，需要手动重启工程/集群所有节点，操作麻烦。

4）升级失败后工程无法自动回退，存在风险。

1.3 功能简介

FineOps运维平台提供面向组件的「更新」功能。

1）支持升级最新/指定版本。

2）通过推送镜像方式，支持内网安全更新。

3）任何更新失败均可自动回退。

1.4 适用范围

内网升级版本：仅内网使用的运维平台，通过finekey推送镜像，将项目组件升级到指定/最新版本时的解决方案。

注1：外网升级最新版本，请参考：外网升级最新版本项目

注2：最新版finekey默认不携带FineBI6.0相关镜像，无法通过本文方案完成FineBI6.0.x小版本升级。

         内网如需升级6.0.x小版本，请通过服务平台联系帆软技术支持，获取镜像包。技术支持联系方式：「服务>在线支持」

2.1 容器化部署

使用运维平台更新帆软项目，仅面向容器化部署的项目，非容器化部署工程不支持本文相关操作。

2.2 检查工程版本

请先检查当前工程版本。

管理员登录FR/BI工程，点击「管理系统>注册管理>版本信息」，查看当前版本号。

检查 FineReport更新日志、FineBI更新日志 即可查看官方发布的最新版本号，确认自己需要升级到的版本。

2.3 备份工程

建议在更新组件前，对项目进行整体备份，防止更新过程出现不可控意外。

管理员登录运维平台，选择指定项目，点击「维护>备份管理」。

建议勾选「备份镜像」，点击「开始备份」，运维平台即会对该项目进行整体备份。

3.1 保存原yaml文件

从原容器化部署工具finekey/conf目录下获取finekey.yaml文件，下文需要用到。

3.2 获取指定版本FineKey

1）最新版本

点击可跳转至下载页下载安装包：FineOps运维平台下载

请下载全量版离线安装包。

2）指定版本

付费用户联系技术支持，索要指定版本的镜像文件。请提供所需的FineReport/FineBI小版本号。

技术支持联系方式：在线支持：前往「服务」，选择「在线支持」；电话：400-811-8890。

技术支持会提供该版本对应的FineKey容器化部署工具，工具中有相关镜像包。

3.3 上传FineKey安装包

获得工具包后，需要将它上传到 Linux，上传文件的方法请自行查阅相关资料。

本文示例是将工具包上传到了 CentOS 7.6.1810 的 /home 路径下，如下图所示：

3.4 解压FineKey安装包

1）先使用 cd 命令进入工具包所在文件夹下。

2）键入如下命令进行解压：

tar zxvf finekey-operation.tar.gz

解压后的文件如下表所示：

3.5 配置yaml文件

yaml 文件指的是工具解压目录下 conf 文件夹里的 finekey.yaml，该文件是控制后面整个升级流程的。

替换finekey.yaml文件

取出3.1节从原finekey部署工具finekey/conf目录下获取finekey.yaml文件，将文件中的配置值，一项一项的复制替换到新fineKey部署工具finekey/conf目录下的finekey.yaml文件。

注：请勿直接替换yaml文件，或一键复制粘贴文件内容，因为新旧版本中，yaml文件设置可能存在微小差异，建议逐项拷贝配置值即可。

3.6 执行推送

1）先使用 cd 命令进入工具包所在文件夹的bin目录下。

2）使用语句启动升级：./finekey update

注：请严格按照文档所述命令执行，不要自行变更为sudo ./finekey  update之类的命令。否则可能导致部署失败。

3.7 检查仓库内镜像

推送成功后，管理员登录运维平台，点击「维护中心>镜像管理」，查看推送到仓库的新镜像。

记下需要更新到的版本号，下文需要用到。

镜像准备完毕后，用户即可对组件进行更新。

4.1 注意事项

1）运维项目组件，不支持一键全部更新，仅支持对同一个组件下的所有容器进行更新。

• 此设定主要是为了满足用户对项目的稳定性要求。

• 但帆软仍然建议在升级时，将项目下的所有组件都更新到最新版本，以便提升项目安全性。

2）部分组件之间存在关联关系（例如升级bi-web组件，会触发bi-engine-worker组件的更新）

• 如有关联更新组件，会出现提示「触发更新后，xxx组件会同时停机更新至对应版本」

4.2 操作步骤

1）管理员登录运维平台，选择指定项目，点击「维护>组件管理」。

2）找到待更新组件，点击「更新」，输入仓库中的版本号，点击「开始更新」

• 如存在24小时内的备份，则无需再次备份，直接更新。

• 如不存在24小时内的备份，且运维平台磁盘空间充足，则先进行备份，再进行更新。

• 如不存在24小时内的备份，且运维平台磁盘空间不足，则更新终止，请对磁盘进行清理/扩容后再进行更新。

3）点击「开始更新」后，提示「更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。是否确认更新」

点击「确定」后，开始更新组件，如下图所示：

4）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」