1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V2.12.0 | 降低运维项目升级前备份要求，存在24小时内备份即可升级 |
| V2.15.0 | 支持「批量更新」组件功能 |
1.2 应用场景
为满足客户的新需求以及完善之前版本某些功能的不足之处，帆软产品（FineReport/FineBI/FineDataLink）在不断地更新迭代。
管理员使用运维平台部署好项目后，需要定期对工程进行更新升级，但是他发现传统的升级方式存在着一些问题。
1）FineReport内网/FineBI的小版本升级需要手动更换JAR包，操作门槛高。
2）由于部分版本的兼容问题，用户需要升级指定版本而非最新版本，只能手动更换JAR包，操作门槛高。
3）FineReport外网升级，需要手动重启工程/集群所有节点，操作麻烦。
4）升级失败后工程无法自动回退，存在风险。
1.3 功能简介
FineOps运维平台提供面向帆软产品（FineReport/FineBI/FineDataLink）的「更新」功能。
1）支持升级最新/指定版本。
2）通过推送镜像方式，支持内网安全更新。
3）任何更新失败均可自动回退。
1.4 适用范围
外网定义：运维平台的镜像仓库，能连接外网，即可进行外网升级运维项目
升级最新版本：运维平台自动获取最新版本镜像号，通过在线获取最新镜像，即可升级指定组件。
升级指定版本：通过联系技术支持获取指定版本镜像号，在线获取指定版本镜像，即可升级指定组件。
注：内网升级项目，请参考 内网升级项目 。
2. 外网升级最新版本项目
2.1 使用前提
2.1.1 运维平台部署
使用运维平台更新帆软项目，仅面向运维平台部署的项目，非运维平台部署工程不支持本文相关操作。
2.1.2 确认镜像仓库支持连接帆软云端仓库
如需使用运维平台在线更新项目组件，需要有新版本的组件镜像包用于替换安装。
因此要支持镜像仓库从云端拉取镜像，镜像仓库所在服务器，必须确保连接外网的帆软云端仓库。
详情请参见：确认镜像仓库支持连接帆软云端仓库
2.1.3 检查工程版本
管理员登录运维平台，选择运维项目。点击「维护>组件管理」。找到待更新组件，检查是否存在可更新版本。
若显示「当前已为最新版本」，则说明暂无更高版本发布，无需执行更新操作。
2.1.4 注意事项
1）更新运维项目组件，支持对组件批量更新，支持对单个组件更新，但不支持对单个组件下的部分容器进行更新
此设定是为了确保同一组件下容器版本的一致性
帆软建议，在升级时将项目下的所有组件都更新到最新版本，以便提升项目安全性。
2）部分组件版本之间存在主从依赖关系（例如升级bi-web组件，会触发bi-engine-worker组件的更新）
如组件间版本存在主从依赖关系，从属组件的更新按钮灰化，仅可对主组件进行更新。
更新组件时，如有关联更新组件，会提示「触发更新后，xxx组件会同时停机更新至对应版本」
2.2 备份工程
在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。
更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」
管理员登录运维平台，选择运维项目。点击「维护>备份管理」。
建议勾选「备份镜像」，点击「开始备份」，运维平台即会对该项目进行整体备份。
2.3 更新版本
对于项目中的各个组件支持批量更新或对指定组件进行更新。
帆软建议在升级时，将项目下的所有组件都更新到最新版本，以便提升项目安全性。
2.3.1 对单个组件进行更新
1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」。
2）找到待更新组件，点击「更新」。
注：如组件间版本存在主从依赖关系，从属组件的更新按钮灰化，仅可对主组件进行更新。
更新时会提示「触发更新后，xxx组件会同时停机更新至对应版本」
3）升级最新版本，无需输入更新版本号，直接点击「开始更新>确定」，即可进行组件更新。
更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。
如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
4）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」
2.3.2 对项目组件批量更新
1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」，点击「批量更新」。
2）升级最新版本，无需输入更新版本号，直接点击「开始更新>确定」，即可进行项目更新。
触发更新后，组件会同时停机更新到最新版本，可能影响项目正常运行，请勿在使用期间操作。
如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
3. 外网升级指定版本
本方案仅支持升级，不支持通过本方案回退指定版本。
3.1 获取镜像版本号
付费用户请联系帆软技术支持，告知所需产品和小版本号，或大概的JAR包日期。
技术支持会告知您具体的镜像版本号。
技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
3.2 使用前提
3.2.1 运维平台部署
使用运维平台更新帆软项目，仅面向运维平台部署的项目，非运维平台部署工程不支持本文相关操作。
3.2.2 配置镜像仓库
如需使用运维平台更新项目组件，需要有新版本的组件镜像包用于替换安装。因此要支持从云端拉取镜像。
详情请参见：确认镜像仓库支持连接帆软云端仓库
3.2.3 注意事项
1）更新运维项目组件，支持对组件批量更新，支持对单个组件更新，但不支持对单个组件下的部分容器进行更新
此设定是为了确保同一组件下容器版本的一致性
帆软建议，在升级时将项目下的所有组件都更新到最新版本，以便提升项目安全性。
2）部分组件版本之间存在主从依赖关系（例如升级bi-web组件，会触发bi-engine-worker组件的更新）
如组件间版本存在主从依赖关系，从属组件的更新按钮灰化，仅可对主组件进行更新。
更新组件时，如有关联更新组件，会提示「触发更新后，xxx组件会同时停机更新至对应版本」
3.3 备份工程
在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。
更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」
管理员登录运维平台，选择运维项目。点击「维护>备份管理」。
建议勾选「备份镜像」，点击「开始备份」，运维平台即会对该项目进行整体备份。
3.4 更新版本
1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」。
2）找到待更新组件，点击「更新」。
注：如组件间版本存在主从依赖关系，从属组件的更新按钮灰化，仅可对主组件进行更新。
更新时会提示「触发更新后，xxx组件会同时停机更新至对应版本」
3）在「更新版本」处手动输入3.1节获取的镜像版本号，点击「开始更新>确定」，即可进行工程更新。
更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。
如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
4）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」
