1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V1.5.6 | 运维平台升级成功后，自动进行运维组件升级操作 |
| V1.9.0 | 升级前自动检测docker引擎版本并提示升级，以防由于docker引擎版本过低导致功能不可用 |
| V1.11.0 | 新增新版本升级强提醒 |
| V2.0.0 | 交互优化，功能入口位置调整 |
| V2.20.0 | 外网环境支持自动升级运维平台 |
| V2.21.0 | 界面优化，各功能分行排列 |
1.2 功能简介
外网升级通过在线获取镜像，更新 FineOps 运维平台及其依赖的运维组件，适用于镜像仓库能够连接帆软云端仓库的环境。
镜像仓库无法访问帆软云端仓库时，详情请参见：内网升级运维平台。
本文不用于升级 FineReport、FineBI 等项目的应用版本。详情请参见：外网升级运维项目。
升级运维平台前，可查阅近期功能变更，详情请参见：运维平台更新日志
1.3 选择升级方式
| 对比项 | 手动升级 | 自动升级 |
|---|---|---|
| 适用场景 | 管理员希望立即执行升级 | 管理员希望在固定维护时间执行升级 |
| 触发方式 | 管理员单击「立即更新」 | 存在新版本时，按设置的更新时间触发 |
| 后续操作 | 更新完成后重启平台，再完成运维组件更新 | 自动更新后仍需关注重启与组件更新结果，不能只以定时任务触发作为完成依据 |
2. 检查升级前提
| 检查项目 | 说明 |
|---|---|
| 镜像仓库连通性 | 镜像仓库所在服务器需要能够从帆软云端仓库拉取镜像，不满足时不能使用本文在线升级方案。详情请参见：确认镜像仓库支持连接帆软云端仓库。 |
| 待升级版本 | 进入「运维平台管理>更新升级」检查是否有新版本；已是最新版本时无需升级 |
| Docker 引擎 | V1.9.0 起升级前自动检查 Docker 引擎版本。 若弹窗提醒「当前docker引擎版本过低，暂不支持在线升级至更高版本，请使用工具离线升级」，不要继续尝试在线升级，改用 FineKey 离线升级。详情请参见：内网升级运维平台。
|
| 维护时间 | 平台重启期间无法访问，重启后需要重新登录；应在允许平台访问中断的时间执行 |
| 并行任务 | 自动升级可能与备份、升级、部署、扩容或卸载项目冲突，设置更新时间时避开这些操作 |
3. 手动升级
3.1 查看新版本
1）管理员登录运维平台，进入「运维平台管理>更新升级」。
未开启自动更新且存在新版本时，也可在「发现新版本」弹窗中单击「查看更新」进入升级入口。
2）查看当前版本、新版本及更新日志。
| 页面提示 | 判断与处理 |
|---|---|
| 有新版本，查看更新 | 存在新版本，查看更新日志后决定是否升级 |
| 当前已是最新版本 | 无需升级 |
| 网络连接失败 | 无法使用在线升级；先按第 2 节检查仓库连通性，纯内网环境改用离线升级 |
3.2 更新并重启平台
警告：重启成功前无法访问运维平台。确认当前允许访问中断后，再执行重启。
1）进入新版本升级页面，单击「立即更新」。
「立即更新」置灰，页面提示「正在更新」。此阶段无进度条，可以关闭升级窗口，不影响后台更新。
2）等待页面提示「更新成功」，按钮变为「立即重启」。
3）单击「立即重启」；如选择稍后重启，需在允许中断的时间完成重启，再继续第 5 节。
4）平台恢复访问后重新登录，完成运维组件更新。
3.3 完成运维组件更新
运维平台版本更新并重启后，还需要完成该版本依赖的运维组件更新，整体升级才算完成。
1）管理员登录运维平台。
2）如出现「运维平台正在完成最后一步更新，更新结束后将自动刷新此页面，更新期间请勿关闭运维平台！」，等待自动更新结束，期间不要关闭运维平台。
3）如未出现自动更新提示，或提示「部分组件更新失败，请在「运维组件」中手动重新触发剩余组件更新」，单击「跳转运维组件」，或进入「运维平台管理>运维组件」。
4）单击「一键升级」，重新触发剩余组件更新。
3.4 确认升级成功
1）管理员登录运维平台。
2）单击「运维平台管理>更新升级」，查看版本，提示「当前已是最新版本」，即代表运维平台升级成功。
4. 自动升级
V2.20.0 及之后版本支持自动升级。
帆软建议开启自动更新，保证最新的运维逻辑能够快速应用在您的应用上。
4.1 设置更新时间
1）管理员进入「运维平台管理>更新升级」。
2）开启「自动更新」，将更新时间设置在允许平台访问中断、且无项目维护任务的时间。
3）单击「确定」。
| 设置项 | 说明 |
|---|---|
| 自动更新 | 默认开启 |
| 更新时间 | 默认每周六 01:00:00，支持调整 |
4.2 跟进自动更新结果
存在新版本时，平台在设定时间执行更新。
管理员登录时若看到「发现新版本」弹窗，也可通过「调整更新时间」触发即时更新。
4.3 完成运维组件更新
运维平台版本更新并重启后，还需要完成该版本依赖的运维组件更新，整体升级才算完成。
1）管理员登录运维平台。
2）如出现「运维平台正在完成最后一步更新，更新结束后将自动刷新此页面，更新期间请勿关闭运维平台！」，等待自动更新结束，期间不要关闭运维平台。
3）如未出现自动更新提示，或提示「部分组件更新失败，请在「运维组件」中手动重新触发剩余组件更新」，单击「跳转运维组件」，或进入「运维平台管理>运维组件」。
4）单击「一键升级」，重新触发剩余组件更新。
4.4 确认升级成功
1）管理员登录运维平台。
2）单击「运维平台管理>更新升级」，查看版本，提示「当前已是最新版本」，即代表运维平台升级成功。
5. 处理升级异常
无论是手动升级还是自动升级，如运维平台整体/部分组件升级失败，管理员登录运维平台时会弹窗提醒。如下图所示：
运维平台整体更新失败：更新失败，将在下个更新周期重新尝试，您也可以联系技术人员获取帮助
部分运维组件更新失败：部分组件更新失败，请在「运维组件」中手动重新触发剩余组件更新
点击「查看详情」，即可跳转至「运维平台管理>更新升级>查看更新记录」界面获取更新明细。
该更新记录表中记录了：更新前后版本、镜像下载用时、更新耗时、更新结果及失败原因
本文简单列出可能出现的几种更新失败原因及解决方案。
| 失败原因 | 原因分析及解决方案 |
|---|---|
| 自动更新与项目操作冲突 | 如果自动更新运维平台与项目操作（备份、升级、部署、扩容、卸载项目）同时进行，运维平台的自动更新会延迟重试。如果5次重试失败，本轮更新失败，将在下个更新周期重新尝试。 例如本周六自动更新时管理员正在进行项目扩容操作，自动更新5次重试失败后，将在下周六再次尝试自动更新 |
| 运维组件部分更新失败 | FineOps运维平台升级完成后，会自动获取该版本依赖的最新运维组件镜像。运维组件也全部成功更新完成后，才能算作运维平台整体升级成功。 如提示「部分组件更新失败，请在「运维组件」中手动重新触发剩余组件更新」。 请直接点击「跳转运维组件」，点击「一键升级」，手动触发其他组件升级即可。
|
上一篇：业务配置更改
