部署运维平台

1.1 版本说明

1.2 应用场景

运维平台是帆软软件推出的，为企业提供帆软应用稳定运行和全方位运维管理的解决方案。

运维平台可以帮助用户解决，管理帆软应用（FineReport、FineBI、FineDataLink）的过程中，遇到的一些痛点和挑战，详情请参见：运维平台简介

如需标准部署帆软项目（FineBI、FineReport、FineDataLink），必须基于运维平台进行。

1.3 功能简介

本文介绍，如何部署运维平台。

本文主要提供给服务器资源较为紧张的客户，如能提供全新服务器用于部署，可参考：快速入门

请按照以下文档，依次检查所准备的服务器是否满足部署运维平台的需求。

3.1 获取finekey安装包

点击可跳转至下载页下载安装包：运维平台安装包下载

有三种类型的安装包，用户可根据服务器环境和自身诉求自行选择：

注：如希望使用在线版安装包，且只开放指定外网网址，请确保镜像仓库所在服务器支持访问以下外网地址：

（运维平台自带的镜像仓库与运维平台在同一服务器下）

3.2 上传finekey安装包

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

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

3.3 解压finekey安装包

1）先使用 cd 命令进入工具包所在文件夹下。

2）根据下载的安装包类型，键入命令进行解压：

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

3.4 配置finekey.yaml文件

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

• 如完全采用默认部署配置（包括安装目录、组件端口，仓库配置等），用户可不对yaml文件做任何配置，可以直接在当前宿主机本地部署。

• 如需更改运维平台相关配置、组件占用端口等，可以打开yaml文件自行配置，yaml文件的配置需要在启动FineKey之前完成。

1）文件内容说明

2）文件示例

node:
  ip: localhost            #节点ip|Node IP
  port: 22                 #节点ssh端口|Node SSH port
  user:                    #节点ssh用户|Node SSH username
  password:                #节点ssh密码|Node SSH password
dataRootPath: ~/data
repo:
  port: 5000    #待安装的registry仓库端口|Registry Port
  #指定已有repo|Specifies an existing container registry
  url:          #已有repo的url|Registry URL
  username:     #已有repo的用户名|Registry username
  password:     #已有repo的密码|Registry password
  ssl: true     #是否有ssl设置|Repository with SSL set or not

online: false   #在线安装|Online installation
language: CN    #语言设置 CN/TW/EN/RU_sv|Language Setting CN/TW/EN/RU_sv/KR/JA
#bip: 10.16.0.1/16    #docker默认容器网段
#fip: 10.17.0.1/16    #运维组件容器内网段 
#组件端口配置|Component port configuration
#components:
#  nginx:
#    portMapping: {80: 8080}
#
#  ops_agent:
#    portMapping: {9071: 9070}
#
#  skywalking_oap:
#    portMapping: {11800: 11800, 12800: 12800}
#
#  elasticsearch:
#    portMapping: {9200: 9200}
#    password: elasticadmin

4.1 启动部署

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

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

注1：请严格按照文档所述命令执行，不要自行变更为sudo ./finekey之类的命令。否则可能导致部署失败。

3）整个部署过程需要花费一段时间，请耐心等待。

注1：开始部署前，会自动对finekey.yaml文件内容进行校验，如果存在必填项未设置、校验值错误、非预设组件等，会直接报错提示并终止部署。

注2：如果部署过程中出现报错，请参考 容器化部署常见问题 ，查看有无对应的解决方案。

        请注意~/data目录不代表/data目录，而是对应用户主目录下的/data目录。例如使用root用户部署，则~/data代表的目录为/root/data

注3：如果部署过程中，检测到挂载目录磁盘可用空间不足100G，会提示「The current path capacity check failed, Please re-enter the path」

        用户无需退出部署环节，手动修改yaml文件。可直接输入满足条件的目录，继续部署。

4.2 完成部署

当出现 deployment success！bye~ 提示时，表示已经成功部署。

在该行提示中，会展示运维平台的工程地址，可复制，用于下一步访问。如下图所示：

注1：地址中的IP，是服务器内网IP。如需使用外网访问，请自行调整为外网IP。

注2：地址中的端口，是部署时设置的Nginx组件占用的端口。

• 若为root用户部署，默认端口为80，运维平台访问地址中可以省略端口，直接用IP访问，访问地址为http://ip/ops/decision

• 若为非root用户部署，默认端口为8090，访问地址为http://ip:8090/ops/decision

• 若finekey.yaml文件中，手动修改了nginx端口，访问地址为http://ip:nginx端口/ops/decision

4.3 访问工程

部署完成后，服务会自动启动，此时可以在浏览器地址栏输入上一步获取的工程地址，访问运维平台。

1）选择浏览器

请使用以下版本的浏览器访问运维平台，否则可能导致界面展示异常。

如使用不符合版本要求的浏览器进行访问，部分界面会出现弹窗提醒「检测到当前浏览器版本过低，可能导致部分组件显示异常，建议升级浏览器版本」。

2）访问工程

在浏览器地址栏输入上一节获取的工程地址，访问FineOps运维平台。

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

当你完成本文「部署运维平台」操作后，推荐进行下一步操作：