1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V2.12.0 | 降低运维项目升级前备份要求，存在24小时内备份即可升级 |
| V2.15.0 | 支持「批量更新」组件功能 |
| V2.41.0 | 新增「7.0升级7.5」前置检查 |
1.2 应用场景
为满足客户的新需求以及完善之前版本某些功能的不足之处，FineReport/FineBI在不断地更新迭代。
小明部署好容器化FR/BI工程后，需要定期对工程进行更新升级，但是他发现传统的升级方式存在着一些问题。
1）FineReport内网/FineBI的小版本升级需要手动更换JAR包，操作门槛高。
2）由于部分版本的兼容问题，用户需要升级指定版本而非最新版本，只能手动更换JAR包，操作门槛高。
3）FineReport外网升级，需要手动重启工程/集群所有节点，操作麻烦。
4）升级失败后工程无法自动回退，存在风险。
1.3 功能简介
运维平台提供面向项目的「更新」功能。
对于内网项目：通过全量finekey部署包升级运维平台，推送最新版项目组件镜像到本地镜像仓库，然后通过运维平台升级项目到最新版本
1）支持升级最新/指定版本。
2）通过推送镜像方式，支持内网安全更新。
3）任何更新失败均可自动回退。
1.4 注意事项
1）本文方案面向内网部署的帆软项目。外网升级最新版本，请参考：外网升级最新版本项目
2）尽管运维平台支持推送单个镜像到本地镜像仓库，但仍然推荐用户通过finekey推送全部组件镜像入库。
此种升级方案可以确保项目下的所有组件都能获取到最新镜像版本。管理员可以把他们都更新到最新版本，来提升项目安全性。
3）最新版finekey默认不携带FineBI6.X相关镜像，无法通过本文方案完成FineBI6.X小版本升级。
内网如需升级6.X小版本，请通过服务平台联系帆软技术支持，获取镜像包。技术支持联系方式：「服务>在线支持」
2. 检查升级前提
2.1 确认升级条件
| 检查项目 | 说明 |
|---|---|
| 项目部署方式 | 必须是运维平台部署的项目，非运维平台部署工程不支持本文相关操作
|
| 当前版本与目标版本 | 若项目组件当前已为最新版本，无需更新 本文方案不支持通过输入较低镜像版本号回退到旧版本 |
| 集群连接 | 多应用集群中，各工程节点与文件服务器、状态服务器、数据存储组件及外接配置库的连接必须正常；FineBI 6.1 及以上版本，即使只有 1 个应用节点，也按集群检查 集群组件连接异常或断开时执行升级，可能导致工程文件永久丢失，模板和数据无法找回。请先修复连接，再执行备份和升级
|
| 项目备份 | V2.12.0 及之后版本执行更新时必须检测到 24 小时内的备份；否则系统阻止更新。 备份动作见下文 |
| 维护时间 | 更新会重启组件；存在关联组件时会同时停机更新。 请先确认允许业务中断，再执行更新 |
2.2 确认组件更新范围
组件是项目中的应用、网关、存储等功能单元；一个组件可包含多个容器。
| 限制 | 说明 |
|---|---|
| 更新粒度 | 支持更新单个组件下的所有容器，不支持只更新同一组件下的部分容器，避免容器版本不一致 |
| 组件依赖 | 主组件升级可能触发从属组件升级，例如 bi-web 触发 bi-engine-worker 更新 存在主从依赖时，从属组件的「更新」按钮置灰，应从主组件发起更新 |
| 停机范围 | 根据更新提示核对会同时更新的关联组件；批量更新会使相关组件同时停机 |
2.3 FineBI7.0升级7.5准备
FineBI7.0升级到7.5版本，也可通过本文方案实现，但需要额外注意以下三点。
| 注意事项 | 处理要求 |
|---|---|
| 更换工程授权 | 升级后须更换 FineBI 工程授权，建议升级前联系销售，提前沟通授权更换事宜 |
| 提交未发布的改动 | 运维平台会在升级项目前自动检测尚未发布的改动内容，并在存在改动时提供「未发布的改动内容详情.xlsx」。建议下载清单，联系相关人员逐项确认并提交改动后再升级。 警告：未提交改动就继续升级，可能导致尚未发布的改动内容丢失。 |
| 安排升级时间 | FineBI 7.0 升级至 7.5 时，会升级模型指标和仪表板，因此升级耗时比其他小版本升级更长，请在维护时间中预留升级时间，并耐心等待完成。 |
3. 升级运维平台（必做！！！）
通过全量版离线安装包升级运维平台，获取项目升级的所有镜像。
1）请先完成运维平台及运维组件升级。详情请参见：内网升级运维平台。
注：请务必在下载 FineKey 时，选择全量版离线安装包，否则无法获取项目升级所需的相关镜像。
2）升级完成后，管理员登录运维平台，进入「维护中心>镜像管理」。
3）确认本次项目升级所需的组件镜像及关联组件镜像已入库，记录目标镜像版本号。
运维平台升级完成、目标镜像齐备后，再备份并升级项目。
注：最新版 FineKey 默认不携带 FineBI 6.X 相关镜像。如需升级 FineBI 6.X 小版本，请额外联系技术支持获取对应镜像包，并参考文档推送入库：推送单个组件镜像入库
4. 备份项目
在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。请在运维平台升级完成后、项目更新前执行整体备份，避免准备环境期间使备份过期。
更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」
1）管理员选择项目，进入「维护>备份管理」。
2）建议勾选「备份镜像」，将当前项目组件的镜像一并备份。
3）单击「开始备份」，按页面提示完成备份。
4）检查备份结果，并确认执行组件更新时备份仍在 24 小时有效范围内；若镜像准备或等待维护时间使备份过期，先重新备份。
注意：整体备份并不覆盖项目所有文件和自备组件的数据，例如assets/temp_attach中的部分文件不在备份范围内，升级前请根据项目实际部署方式另行备份未覆盖的内容。备份内容请参见：备份内容
5. 更新项目组件
镜像准备完毕后，用户即可对组件进行更新。
5.1 更新单个组件
1）管理员选择项目，进入「维护>组件管理」。
2）找到待升级组件，单击「更新」。
3）核对目标版本及关联更新组件，单击「开始更新」。
4）按页面提示完成更新确认。FineBI 7.0 升级至 7.5 时，如提示存在尚未发布的改动，请先参照清单处理发布，再继续升级。
5）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」
5.2 批量更新组件
V2.15.0 及之后版本支持批量更新。
1）管理员选择项目，进入「维护>组件管理」。
2）单击「批量更新」。
3）升级最新版本时，无需输入更新版本号，单击「开始更新」。
4）核对停机范围，按页面提示完成更新确认。批量更新包含 FineBI Web 组件且从 7.0 升级至 7.5 时，请先参照清单处理发布，再继续升级。
上一篇：外网升级运维项目
