容器化指令升级工程

1.1 版本

1.2 应用场景

容器化部署工具 FineKey 内置了最新版本的 docker 容器，包含 FR/BI 业务工程的镜像、各类组件镜像、Tomcat 镜像的镜像仓库。

但随着时间推移，为满足客户需求，产品会不断进行版本迭代，容器化部署的应用和组件也需要进行迭代。

本文将简单介绍 FineKey 如何升级容器化部署的应用和组件。

2.1 确认节点联通

确认待升级节点与FineKey所在节点是否可以联通，若目标节点与FineKey不连通，则无法使用本文升级方法。

2.2 确认剩余磁盘空间

确认待升级节点剩余磁盘空间是否大于200GB，如不足200GB，则无法使用本文升级方法。

2.3 确认待升级节点是否容器化部署

确认待升级节点是否是由FineKey部署的工程，非FineKey部署的工程无法使用本文升级方法。

2.4 确认是否需要升级

确认待升级节点是否存在需要升级的容器，如不存在需要升级的容器，则无法使用本文升级方法。

2.5 确认用户权限

运行finekey工具的用户，必须要有root用户组权限。

2.6 注意事项

本文升级方法，单次只支持升级一套环境。

例如用户有五个工程，其中四个工程为FineKey部署的一套集群，另一个工程为FineKey部署的单节点工程。

那么需要升级两次，一次升级四个工程的集群，一次升级单节点工程。

3.1 获取最新工具

访问 FineBI产品下载页面，选择「其他下载>服务器部署版」，点击下载「Finekey容器化版」安装包，如下图所示：

注：容器化部署工具 FineKey 中的 FineReport 工程镜像，均为帆软发布的最新版本。

3.2 上传最新工具

获得工具包后，需要将它上传到 Linux，上传文件的方法请自行查阅相关资料。

本文示例是将工具包上传到了 CentOS 7.6.1810 的 /home/test 路径下，如下图所示：

3.3 解压工具

先使用 cd 命令进入工具包所在文件夹下，再键入如下命令进行解压：

tar zxvf finekey-bi-publish6.0.tar.gz

3.4 文件说明

解压后的文件如下表所示：

yaml 文件指的是工具解压目录下 conf 文件夹里的 finekey.yaml，该文件是控制后面整个升级流程的。

1）替换yaml文件

从原finekey部署工具finekey/conf目录下获取finekey.yaml文件，替换到新finekey部署工具finekey/conf目录下。

2）修改yaml文件

yaml文件中需要新增以下待升级节点的ip、用户名、密码，其他均由finekey自动识别。

update：
nodes:
  - ip: localhost            #机器ip
    port: 22                 #机器ssh端口
    user:                    #节点ssh用户
    password:                #节点ssh密码
#  - ip: 192.168.101.145
#    port: 22
#    user:     xxx
#    password: xxx

使用 cd 命令进入工具包finekey/bin目录下，使用语句启动升级。

一般默认使用./finekey update语句执行升级，静候升级成功自动重启即可。

5.1 更多升级语句

5.2 升级流程