1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变更 |
|---|---|---|
| 11.0 | V1.0 | - |
| 11.0.13 | V1.3.6 | 新增配置项：PathStyleAccess、signerOverride |
1.2 应用场景
用户自己部署 HDFS 文件系统过于困难，希望使用高可用的文件服务器。
用户希望使用支持 S3 协议的云存储文件系统作为文件服务器，包括阿里云 OSS 、华为云 OBS 、亚马逊云 S3。
1.3 功能简介
用户可通过安装「S3 资源仓库」插件，使用支持 S3 协议的云存储文件系统作为文件服务器。
注：该插件只适配了阿里云 OSS 、华为云 OBS 、亚马逊云 S3，其他自己搭建的 S3 平台不一定支持。
2. 操作步骤
2.1 安装插件
点击下载插件：S3 资源仓库插件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 集群环境准备
在配置 S3 文件服务器之前请准备集群环境，具体可参见： 集群环境准备
2.3 配置文件服务器
注：需要将主节点工程的%FR_HOME%/webapps/webroot/WEB-INF文件夹拷贝到文件服务器中，拷贝后 WEB-INF 所在文件夹需要赋予权限，Linux 系统中为 777 权限。
1）以管理员身份进入数据决策系统，点击「管理系统>智能运维>集群配置」，点击「文件服务器共享」，协议选择「S3」，如下图所示：
2）根据实际情况进行配置，如下图所示：
| 配置项 | 说明 |
|---|---|
| 协议 | S3 |
| Endpoint | Endpoint配置 |
| Region | 服务器区域 |
| AccessKeyId | 密钥ID |
| AccessKeySecret | 密钥文本 |
| Bucket | Bucket名称 |
| 路径 | 文件服务器的根目录名称 注1：「路径」必须以「/」结尾，开头不能加「/」。 注2：「路径」不能为相对路径。 |
| PathStyleAccess | 路径样式访问 true：使用路径样式访问 false：默认选项，默认不使用 简介：Path Style Access是AWS S3存储桶的早期URL结构，它将桶名称放在URL的开头，而不是作为主机名（Host Name）的一部分。 |
| signerOverride | 签名覆盖 当你使用AWS SDK或CLI访问S3时，默认情况下会使用AWS签名版本4（AWS Signature Version 4）进行身份验证和授权。Signer Override允许你覆盖此默认设置，并使用其他签名版本进行身份验证和授权。 |
3）点击「测试连接并保存」，提示连接成功。如下图所示：
注：配置集群的后续步骤请参见：配置集群
3. 注意事项
插件禁用或卸载后：
若已配置 S3 服务器，将不影响正常使用。
重启工程，将自动切换到节点间同步。
文件服务器处显示异常。
注：因为S3本质是一个KEY-VALUE数据库， 没有路径的概念，对父目录改动会递归所有子目录和子文件，所以在备份还原等涉及文件夹频繁变动的功能性能很差。
