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 功能简介
本文以阿里云对象存储OSS为例，讲解帆软集群与阿里云对象存储OSS的对接：
用户需要自行购买并准备阿里云对象存储OSS。
在项目部署好后，可将集群项目与该云存储系统对接
2. 帆软应用安装插件编辑
3. 准备阿里云OSS编辑
用户需要自行购买并准备阿里云对象存储OSS。
帆软不提供相关资料和指导，仅对必要内容进行指明，请查阅阿里云官网获取其他帮助。请参见：阿里云对象存储OSS
如运维能力不足，推荐使用运维平台部署新项目时，在「文件服务」中勾选「部署MinIO」即可，无需手动部署和调优。
| 1 | 购买 | 自行购买阿里云对象存储OSS |
| 2 | 创建RAM用户和AccessKey | 1）登录阿里云RAM 访问控制 2）创建RAM用户 点击「身份管理>用户」，点击「创建用户」 务必勾选「OpenAPI 调用访问」，以生成AccessKeyId和AccessKeySecret
3）复制AccessKey信息 创建成功后，请务必记录下AccessKeyId和AccessKeySecret，下文需要用到 后续无法再次查询到对应Secret，只能重新新建
4）分配权限 勾选该用户，点击「添加权限」 为用户分配AliyunOSSFullAccess：管理对象存储服务（OSS）权限
|
| 3 | 创建存储空间和文件目录 | 1）登录阿里云对象存储OSS控制台 2）创建Bucket（存储空间）
3）点击进入Bucket，在「文件管理>文件列表」中新建目录 用于存储工程文件和工程备份文件 示例目录：fanruan
4）点击进入上一节创建的目录，新建两个子目录 子目录1：推荐命名为WEB-INF，用于存储工程文件 子目录2：必须命名为backup，用于存储工程备份文件
|
4. 上传文件到阿里云OSS编辑
对于已部署好的工程，如需接入/替换集群文件服务，需要先将工程文件上传到阿里云OSS存储目录中。
如当前工程已配置文件服务，请将原文件服务器工程存储目录下的所有文件，拷贝到阿里云OSS准备的工程存储目录。请注意原文件服务器类型是否支持后端拷贝等传输细节（例如minio等S3类型，必须前端下载文件再上传）
如当前工程未配置文件服务，首次接入文件服务，请将工程某个节点下的以下文件夹拷贝到阿里云OSS存储目录中
| 阿里云文件夹 | 工程文件 | 文件夹内容说明 |
|---|---|---|
工程存储目录（一般为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. 准备阿里云OSS信息编辑
| 配置项 | 说明 |
|---|---|
| 协议 | S3 |
Bucket Endpoint Region | 配置项说明： Bucket：存储空间，用于存储对象的容器 Endpoint：OSS对外服务的访问域名 Region：OSS的数据中心所在物理位置 获取方式： 1）登录阿里云对象存储OSS控制台 2）点击「Bucket列表」，点击工程文件所在Bucket 3）点击「概览」，即可查看到相关信息
|
AccessKeyId AccessKeySecret | 配置项说明： AccessKey是阿里云提供给用户的永久访问凭据
获取方式： 推荐新建RAM用户并配置AccessKey（上文创建RAM用户时已记录相关信息） 如果遗失这个 AccessKey，只能创建新的来替代，如何创建：创建AccessKey |
| 路径 | 文件服务的根目录名称，即存储工程文件的目录完整地址 本示例为fanruan/WEB-INF/ 注1：「路径」必须以「/」结尾，开头不能加「/」。 注2：「路径」不能是相对路径。 |
PathStyleAccess | 访问OSS存储桶时，URL的路径结构，一般情况下无需配置
|
| signerOverride | 允许用户指定请求签名的算法或版本，一般情况下无需配置 如集群对接OSS时，出现证书或unknownhost相关报错，可调整为S3SignerType |
6. 集群接入文件服务编辑
支持在以下情况下接入阿里云对象存储 OSS 作为集群文件服务，请根据情况自行选择，任选其一即可。
6.1 运维平台集群管理接入
项目部署成功后，在运维平台的「集群管理」中，可为项目接入阿里云对象存储 OSS 作为文件服务。
1）管理员登录运维平台，选中指定项目。
2）点击「维护>集群管理」，对「文件服务器」进行配置。
3）输入第五章准备的相关信息
4）点击「保存」，提示「连接成功」，即代表可正常对接。
6.2 管理系统集群管理接入
在帆软应用的「管理系统>集群管理」中，可为项目接入阿里云对象存储 OSS 作为文件服务。
1）管理员登录帆软应用，点击「管理系统>智能运维>集群配置」。
2）在开启了状态服务器的前提下，在文件一致设置中选择「文件服务器共享」。
3）点击「编辑」填写第五章准备的相关信息。
4）点击「测试连接并保存」，提示「测试连接成功」，即代表可正常对接。
