【已评审】北向升级接口新增参数校验版本是否一致

[linyao]

背景

大包升级时HPM中包含多个固件，部分固件与设备实际运行版本一致无需升级，只在固件版本不一致才进行升级

关联ISSUE

暂无

整体方案

当前升级流程中不判断固件版本，不管是否与当前版本一致，都会强制升级
因此需要通过升级接口参数配置此次升级在版本一致场景是否进行升级。

• UIRest升级接口新增校验版本是否一致参数
• WEBUI升级接口新增校验版本是否一致选项

评审点

评审点一：升级UIRest接口新增入参表示升级策略：

URI：/UI/Rest/BMCSettings/UpdateService/FirmwareUpdate
新增入参 ForceUpdate表示升级策略
URI：/UI/Rest/BMCSettings/UpdateService/ParallelUpdate
新增入参 ForceUpdate表示单个package的升级策略

URI: /UI/Rest/BMCSettings/UpdateService/FirmwareUpdate

• 操作类型：POST
• 变更点：新增入参ForceUpdate表示升级策略
• 请求说明

"ReqBody": {
                        "Type": "object",
                        "Required": true,
                        "Properties": {
                            "FilePath": {
                                "Required": true,
                                "Type": "string"
                            },
                            "ForceUpdate": {
                                "Type": "boolean",
                            },
                        }
                    },

参数	参数说明	取值	可选/必选	备注
ForceUpdate	升级策略	true – 版本号一致仍然覆盖升级 false – 版本一致场景不升级	可选	不选时默认强制升级

URI: /UI/Rest/BMCSettings/UpdateService/ParallelUpdate

• 操作类型：POST
• 变更点：新增入参ForceUpdate表示单个package的升级策略
• 请求说明

"ReqBody": {
                        "Type": "object",
                        "Required": true,
                        "Properties": {
                            "FilePath": {
                                "Required": true,
                                "Type": "string"
                            },
                            "ForceUpdate": {
                                "Type": "boolean"
",
                            },
                        }
                    },

参数	参数说明	取值	可选/必选	备注
ForceUpdate	升级策略	true – 版本号一致仍然覆盖升级 false – 版本一致场景不升级	可选	不选时默认强制升级

评审点二 WebUI：web界面新增选项：升级策略

详细描述

新增选项：升级策略
升级策略：直接升级、不同版本升级

评审结论

通过，具体结论如下：

1. 同意 WEBUI 固件升级-固件更新界面新增 是否强制升级选项 选项，选项为开关模式，默认为开
2. 同意 UIRest 接口 /UI/Rest/BMCSettings/UpdateService/FirmwareUpdate 请求增加属性ForceUpdate，表示是否强制升级；属性类型为 boolean
3. 同意 UIRest 接口 /UI/Rest/BMCSettings/UpdateService/ParallelUpdate 请求增加属性ForceUpdate，表示是否强制升级；属性类型为 boolean

遗留问题

无