1. 概述编辑
1.1 版本
运维平台版本 | 功能变更 |
---|---|
V1.5.5 | - |
1.2 应用场景
为满足客户的新需求以及完善之前版本某些功能的不足之处,FineReport/FineBI在不断地更新迭代。
小明部署好容器化FR/BI工程后,需要定期对工程进行更新升级,但是他发现传统的升级方式存在着一些问题。
1)FineReport内网/FineBI的小版本升级需要手动更换JAR包,操作门槛高。
2)由于部分版本的兼容问题,用户需要升级指定版本而非最新版本,只能手动更换JAR包,操作门槛高。
3)FineReport外网升级,需要手动重启工程/集群所有节点,操作麻烦。
4)升级失败后工程无法自动回退,存在风险。
1.3 功能简介
FineOps运维平台提供面向组件的「更新」功能。
1)支持升级最新/指定版本。
2)通过推送镜像方式,支持内网安全更新。
3)任何更新失败均可自动回退。
本文面向:
1)支持外网联通的运维平台,需要将项目组件升级到指定版本时的解决方案。
2)仅内网使用的运维平台,需要将项目组件升级到指定/最新版本时的解决方案。
注:外网升级最新版本,请参考:外网升级最新版本项目
2. 使用前提编辑
2.1 容器化部署
「更新」作为「组件管理」的一个子功能,仅面向容器化部署的项目,
非容器化部署工程不支持本文相关操作。
2.2 接入项目
如需使用运维平台对项目组件进行更新,首先需要完成两者的对接工作。
详情请参见:接入已有容器化项目
2.3 检查工程版本
请先检查当前工程版本。
管理员登录FR/BI工程,点击「管理系统>注册管理>版本信息」,查看当前版本号。
检查 FineReport更新日志、FineBI更新日志 即可查看官方发布的最新版本号。
1)仅支持升级到更高版本,不支持向老版本升级。
2)请确认是否存在更高版本,若已经是最新版本,无需升级。
3. 推送镜像编辑
3.1 保存原yaml文件
从原容器化部署工具finekey/conf目录下获取finekey.yaml文件,下文需要用到。
3.2 获取指定版本FineKey
付费用户联系技术支持,索要指定版本的镜像文件。请提供所需的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
解压后的文件如下表所示:
文件夹/文件 | 文件说明 | |
---|---|---|
finekey/bin | 运行finekey的可执行文件 | |
finekey/conf | finekey.yaml | 新部署运维平台配置文件 |
finekey.push.yaml | 拉取镜像配置文件 | |
finekey/resources | 资源文件,镜像包放在其中images文件夹中 |
3.5 配置yaml文件
3.5.1 替换finekey.yaml文件
取出从原finekey部署工具finekey/conf目录下获取finekey.yaml文件,将文件中的配置值,一项一项的复制替换到新FineKey部署工具finekey/conf目录下的finekey.yaml文件。
注:请勿直接替换yaml文件,或一键复制粘贴文件内容,因为新旧版本中,yaml文件设置可能存在微小差异,建议逐项拷贝配置值即可。
3.5.2 修改finekey.push.yaml文件
根据finekey.yaml中的信息,修改新finekey部署工具finekey/conf目录下的finekey.push.yaml文件。
node:
ip: localhost #机器ip
port: 22 #机器ssh端口
user: #节点ssh用户
password: #节点ssh密码
repo:
url: #已有repo的url
username: #已有repo的用户名
password: #已有repo的密码
ssl: true #已有repo是否安全仓库
3.6 执行推送
1)先使用 cd 命令进入工具包bin目录。
2)使用语句启动升级,此时便会自动向仓库中推送镜像。
./finekey push --config ../conf/finekey.push.yaml
4. 检查镜像仓库编辑
如需使用运维平台更新项目组件,需要有新版本的组件镜像包用于替换安装。
因此需要先为运维平台配置一个镜像仓库,用于推送/存放镜像包。
1)使用自带镜像仓库:在部署运维平台时,会默认安装一个仓库组件registry。镜像仓库地址为运维平台IP:5000,无需填写用户名、密码、SSL,点击「保存」即可。
2)使用用户自有仓库:用户需要自行提供仓库地址、用户名、密码、SSL,点击「保存」即可。
该镜像仓库是在上节finekey.yaml文件中配置了的,请再在运维平台中确认下已连接。
当仓库配置完成后,会自动显示推送到仓库的新镜像。记下需要更新到的版本号,下文需要用到。
5. 备份工程编辑
建议在更新组件前,对项目进行整体备份,防止更新过程出现不可控意外。
管理员登录运维平台,点击「运维管理>备份管理」,选择目标项目,建议勾选「备份jar包」,点击「开始备份」,运维平台即会对该项目进行整体备份。
6. 更新版本编辑
管理员登录运维平台,点击「运维管理>项目管理」,点击目标项目对应的「组件管理」。
找到FR/BI组件,点击「更新」,输入仓库中的版本号,点击「开始更新」,即可进行工程更新。