1.1 版本说明

1.2 应用场景

服务器部署一直都是比较繁重的运维操作，为了降低部署带来的较高成本，官方上线了容器化部署工具 FineKey 。

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

使用该工具可以实现自动化部署，一条命令即可完成所有的部署工作，省心省力又高效。

本文介绍：使用 FineKey 工具部署单机 FineReport 工程的方案。

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

2.1 FineKey运行环境要求

容器化部署工具 FineKey 的运行，对服务器环境有一些要求，如下表所示：

2.2 组件运行环境要求

容器化部署工具 FineKey 会安装许多组件。单机情况下如下表所示：

1）请确认当前服务器是否符合组件的运行环境最低要求。

• 下表列出的为组件正常运行的最低配置要求。

• 建议配置一般为最低配置的两倍，可根据服务器实际情况自行调整。

2）请确认容器安装的默认配置是否可用。

• 请确认默认的映射端口端口是否已被使用，如已被使用，请安排好其他空闲端口。

• 请确认准备使用的端口是否开放了防火墙、安全组等，确保可连接。

注：端口portMapping为{映射端口:容器内端口} ，其中映射端口可改，容器内端口修改无效。

2.3 确认docker状态

请先确认服务器上是否已安装了docker，若已安装，请确保docker正在运行。

1）确认是否安装docker：

执行命令：docker version

若安装了docker，则会返回版本。

2）若安装了docker：

执行命令：systemctl status docker

确认docker是running状态

2.4 确认用户权限

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

3.1 下载工具

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

3.2 上传工具

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

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

3.3 解压工具

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

tar zxvf finekey-fr-publish11.0.tar.gz

3.4 文件说明

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

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

无任何自备组件的单机部署可不做任何配置，可以直接在当前宿主机本地部署，各个组件使用部署工具自带组件。

但是如果有个性化或特殊的部署需求，可以打开 yaml 文件自行配置，yaml 文件的配置需要在启动 FineKey 之前完成。

注：yaml文件很注重字符格式，该有空格的地方别误删。

4.1 文件内容说明

4.2 文件示例

cluster: false      #是否集群
deploymentType: 1  
nodes:
  - ip: localhost            #机器ip
    port: 22                 #机器ssh端口
    user:                    #节点ssh用户
    password:                #节点ssh密码
 
dataRootPath: ~/data
 
repo:
  port: 5000    #待安装的registry仓库端口
  #指定已有repo
  url:          #已有repo的url
  username:     #已有repo的用户名
  password:     #已有repo的密码
  ssl: true     #已有repo是否安全仓库
 
components: #需要安装的组件
# 这里跟随具体的应用做改变
  fr:
    config: { xmx: 5120 }   #环境变量
 
  mysql:
    password: mysql
 
#  ops_agent:
#    portMapping: {9070: 9070}
 
existingComponents:
#  finedb:
#    databaseType: oracle
#    database: fr
#    schema: xxx
#    ip: 192.168.5.47
#    port: 1521
#    user: system
#    password: xxx

5.1 启动部署

1）使用 cd 命令进入工具解压目录下 bin 文件夹，如下图所示：

2）键入如下命令执行自动化部署：

./finekey

3）整个部署过程需要花费一段时间，请耐心等待，如果部署过程中出现报错，请参考 容器化部署常见问题 ，查看有无对应的解决方案。

5.2 完成部署

当出现 deployment success！bye~ 提示时，表示已经成功部署，如下图所示：

5.3 访问工程

部署完成后，服务会自动启动。

在浏览器地址栏输入：http://{ip}/webroot/decision（请把{ip}换成自己的主机IP），即可访问 FineReport 系统，如下图所示：

此处列出一些常用的容器化运维指令：

• 重启容器指令：docker restart 容器名，例如：docker restart fanruan_fr

• 查看所有容器运行情况：docker ps -a

• 启动指定容器：docker start 容器名，例如：docker start fanruan_fr

• 停止指定容器：docker stop 容器名，例如：docker stop fanruan_fr