1.1 版本说明

1.2 应用场景

如需使用运维平台，目前仅支持通过容器化部署方式获取。

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

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

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

本文介绍：使用 FineKey 工具部署运维平台的方案。

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

2.1 FineKey运行环境要求

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

2.2 组件运行环境要求

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

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

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

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

• 如需使用链路追踪功能，运维平台服务器配置要求至少4C16G。

• 如不使用链路追踪功能，即部署但不运行elasticSearch、skywalking_ui、skywalking_oap容器，运维平台服务器配置要求最低4C8G。

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 获取工具

「运维平台」目前仍处于内测阶段。

如需试用运维平台，请填写表单申请：运维平台申请表

或微信扫描下方二维码，进入运维平台产品试用报名入口。

3.2 上传工具

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

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

3.3 解压工具

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

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

3.4 文件说明

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

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

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

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

4.1 文件内容说明

4.2 文件示例

基础配置：

cluster: false      #是否集群
deploymentType: 0   # 0:常规部署 1:只部署应用 2:只部署运维平台
nodes:
  - ip: localhost            #机器ip，本地则直接localhost
    port: 22                 #机器ssh端口，localhost可不写
    user:                    #节点ssh用户，localhost可不写
    password:                #节点ssh密码，非root是必填，除非普通用户但sudo里配置了nopass，其他情况比如设置了免密登录，也得填密码
    keyPath:                 #节点ssh密钥文件，root用户可以使用，普通用户但是sudo里配置了nopass也可以使用
  - ip: 192.168.101.145
    port: 22
    user:     xxx
    password: xxx

全新安装组件：

dataRootPath: ~/data       #各个组件默认创建的挂载路径

repo:
  port: 5000

components: #需要安装的组件
  fr:
    config: { xmx: 5120 }   #环境变量

  #  redis:
  #    password: redis

  mysql:
    password: mysql

  rocketmq_namesrv:
    portMapping: {9876: 9876}

  rocketmq_broker:
    portMapping: {10911: 10911}
    password: rocketmq

  rocketmq_exporter:
    portMapping: {5557: 5557}

  ops_agent:
    portMapping: {9070: 9070}

  elasticsearch:
    portMapping: {9200: 9200}
    password: elasticadmin

  minio:
    portMapping: {9000: 9000, 9001: 9001}
    password: minioadmin   #用户默认为minioadmin，密码长度不小于8位

配置已有组件：

existingComponents:  #如果已有组件，请配置下方，无现有组件，下方空置即可
  finedb:
    databaseType: oracle
    database: fr
    schema: xxx
    ip: 192.168.5.47
    port: 1521
    user: system
    password: xxx
  redis:
    password: 123456
    nodes:
      - ip: 192.168.101.201
        port: 7379
  ftp:
    ip: 192.168.101.201
    port: 21
    user: adrian
    password: 1
    path: /elijah
    charset: UTF-8

  minio:   #同时存在minio、sftp和ftp时，优先使用ftp，其次sftp，最后minio
    ip: 192.168.5.47
    port: 9000
    user: adrian
    password: minioadmin
    path: /test
    ssl: false   #不支持本地生成的ssl证书
    bucket: test
  sftp:   #同时存在minio、sftp和ftp时，优先使用ftp，其次sftp，最后minio
    -ip: 192.168.5.47 #sftp的地址信息默认使用nodes的第一个
     port: 1521
    user: system
    password: qwe123
    path: ~/data/sftp #默认使用dataRootPath/fanruan_xxxxx/sftp

5.1 启动部署

1）使用 cd 命令进入工具解压目录下 bin 文件夹

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

./finekey

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

5.2 完成部署

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

5.3 访问工程

部署完成后，服务会自动启动，此时可以直接访问「决策平台」和「运维平台」：

访问运维平台，在浏览器地址栏输入：http://{ip}/ops/decision（请把{ip}换成自己的主机IP）

例如本文示例，浏览器地址栏键入：http://192.168.110.254/ops/decision，即可访问运维平台，如下图所示：

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

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

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

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

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