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資料夾copy到檔案伺服器中，copy後 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資料庫， 沒有路徑的概念，對父目錄改動會遞迴所有子目錄和子檔案，所以在備份還原等涉及資料夾頻繁變動的功能效能很差。
