1. 概述
1.1 版本
| 项目版本 | S3资源仓库版本 | 功能变更 |
|---|---|---|
| FineBI6.0/FineReport11.0 | V1.0 | - |
| FineBI6.0.8/FineReport11.0.13 | V1.3.6 | 新增配置项：PathStyleAccess、signerOverride |
1.2 应用场景
手动搭建本地 HDFS 文件系统，对于用户的运维能力要求过高，但用户又希望使用高可用的文件服务器。
通过安装「S3 资源仓库」插件，帆软集群可对接支持 S3 协议的云存储文件系统作为文件服务器。
支持的云存储文件系统包括：阿里云OSS、华为云OBS 、亚马逊云S3。其他自行搭建的 S3 平台不确保支持。
1.3 功能简介
本文主要讲解帆软集群与华为云对象存储OBS的对接：
用户需要自行购买并准备华为云对象存储OBS
在项目部署好后，可将集群项目与该云存储系统对接
2. 帆软应用安装插件
3. 准备华为云OBS
用户需要自行购买并准备华为云对象存储OBS。
帆软不提供相关资料和指导，仅对必要内容进行指明，请查阅华为云官网获取其他帮助。请参见：华为云对象存储OBS
如运维能力不足，推荐使用运维平台部署新项目时，在「文件服务」中勾选「部署MinIO」即可，无需手动部署和调优。
| 1 | 创建华为云超管 | 如已有华为云企业超管账号，可忽略本步骤 1）注册华为账号 请参考华为云文档完成：注册华为账号并开通华为云 2）实名认证 请参考华为云文档完成：个人账号如何完成实名认证 或 企业账号如何完成实名认证 3）为华为账号充值 请确保你的华为账号有足够的余额，才能正常使用OBS等相关资源 请参考华为云文档完成：账户充值 |
| 2 | 创建华为云IAM用户和访问密钥 | 华为云企业超管账号下，一般有企业内的多种资源 超管可以创建一个IAM用户，用于分配对应OBS权限，和帆软集群对接 1）创建IAM用户 管理员登录IAM控制台，选择「用户>创建用户」，设置IAM用户名 请务必勾选「访问密钥」凭证，以生成AccessKeyId和AccessKeySecret 请参考华为云文档完成：创建IAM用户
2）保存访问密钥文件 创建成功后，请务必妥善保管生成的访问密钥文件credentials.csv，其中包含该IAM用户的Access Key Id和Secret Access Key，下文需要用到 请参考华为云文档完成：管理IAM用户访问密钥
3）分配权限 请为该用户或用户所在的用户组，分配OBS Administrator权限：对象存储服务管理员权限 请参考华为云文档完成：创建用户组并授权
|
| 3 | 创建桶和文件目录 | 1）创建桶 登录华为云OBS控制台，创建桶 请参考华为云文档完成：创建桶 示例桶名称：fanruan-obs-test
2）新建文件夹 点击进入创建好的桶，在「对象」中新建文件夹，用于存储工程文件和工程备份文件 请参考华为云文档完成：新建文件夹 示例文件夹：fanruan
3）点击进入上一节创建的目录，新建两个子目录 子目录1：推荐命名为WEB-INF，用于存储工程文件 子目录2：必须命名为backup，用于存储工程备份文件
|
4. 上传文件到华为云OBS
对于已部署好的工程，如需接入/替换集群文件服务，需要先将工程文件上传到华为云OBS存储目录中。
如当前工程已配置文件服务，请将原文件服务器工程存储目录下的所有文件，拷贝到华为云OBS准备的工程存储目录。请注意原文件服务器类型是否支持后端拷贝等传输细节（例如minio等S3类型，必须前端下载文件再上传）
如当前工程未配置文件服务，首次接入文件服务，请将工程某个节点下的以下文件夹拷贝到华为云OBS存储目录中
| 华为云文件夹 | 工程文件 | 文件夹内容说明 |
|---|---|---|
工程存储目录（一般为WEB-INF） | /webroot/WEB-INF/assets | 存放着以下内容： 工程Excel原始文件信息 FineReport模板备份文件 驱动管理上传的驱动 通用的共享持久化目录 |
| /webroot/WEB-INF/dpworks | FineDataLink任务相关的配置文件 如不存在该文件夹，说明工程没有使用FDL相关功能，可忽略 | |
| /webroot/WEB-INF/reportlets | FineReport模板存放目录 | |
| /webroot/WEB-INF/resources | 存放工程相关的资源配置文件 | |
| /webroot/WEB-INF/schedule | 定时调度生成的文件 | |
| /webroot/WEB-INF/treasures | 云端运维生成的数据包 | |
| backup | /webroot/backup | 工程历史备份文件 |
5. 准备华为云OBS信息
| 配置项 | 说明 |
|---|---|
| 协议 | S3 |
Bucket Endpoint Region | 配置项说明： Bucket：桶，用于存储对象的容器 Endpoint：OBS对外服务的访问域名 Region：OBS的数据中心所在物理位置 获取方式： 1）登录华为云对象存储OBS管理控制台 2）点击桶列表，桶名称即为Bucket 3）点击桶，进入「概览」界面，在域名信息中，可以看到Endpoint和Region
|
AccessKeyId AccessKeySecret | 配置项说明： AccessKey是华为云提供给用户的永久访问凭据
获取方式： 推荐新建IAM用户并创建访问密钥，即上文创建IAM用户时生成的访问密钥文件credentials.csv 其中包含该IAM用户的Access Key Id（即帆软所需的AccessKeyId）和Secret Access Key（帆软所需的AccessKeySecret） 如果遗失这个 AccessKey，请参考华为云文档重新创建：管理IAM用户访问密钥 |
| 路径 | 文件服务的根目录名称，即存储工程文件的目录完整地址 本示例为fanruan/WEB-INF/ 注1：「路径」必须以「/」结尾，开头不能加「/」。 注2：「路径」不能是相对路径。 |
PathStyleAccess | 访问OBS存储桶时，URL的路径结构，一般情况下无需配置
|
| signerOverride | 允许用户指定请求签名的算法或版本，一般情况下无需配置 如集群对接OBS时，出现证书或unknownhost相关报错，可调整为S3SignerType |
6. 集群接入文件服务
支持在以下情况下接入华为云对象存储 OBS 作为集群文件服务，请根据情况自行选择，任选其一即可。
6.1 运维平台集群管理接入
项目部署成功后，在运维平台的「集群管理」中，可为项目接入华为云对象存储 OBS 作为文件服务。
1）管理员登录运维平台，选中指定项目。
2）点击「维护>集群管理」，对「文件服务器」进行配置。
3）输入第五章准备的相关信息
4）点击「保存」，提示「连接成功」，即代表可正常对接。
6.2 管理系统集群管理接入
在帆软应用的「管理系统>集群管理」中，可为项目接入华为云对象存储 OBS 作为文件服务。
1）管理员登录帆软应用，点击「管理系统>智能运维>集群配置」。
2）在开启了状态服务器的前提下，在文件一致设置中选择「文件服务器共享」。
3）点击「编辑」填写第五章准备的相关信息。
4）点击「测试连接并保存」，提示「测试连接成功」，即代表可正常对接。
