ファイルストレージ：S3 (Pro)

概要

ファイル管理プラグインをベースに、S3 互換プロトコルに対応したファイルストレージタイプを追加します。Amazon S3、Alibaba Cloud OSS、Tencent Cloud COS、MinIO、Cloudflare R2 など、S3 プロトコルに対応するあらゆるオブジェクトストレージサービスを簡単に接続でき、ストレージサービスの互換性と柔軟性をさらに高めます。

主な機能

クライアントアップロード：ファイルのアップロード処理で NocoBase サーバーを経由せず、ファイルストレージサービスに直接接続することで、より効率的かつ高速なアップロードを実現します。
プライベートアクセス：ファイルにアクセスする際、すべての URL は署名付きの一時認証 URL となり、ファイルアクセスの安全性と有効性を確保します。

利用シーン

ファイルテーブル管理：アップロードされたすべてのファイルを一元管理・保存し、複数のファイル形式と保存方式に対応します。ファイルの分類や検索にも便利です。
添付ファイルフィールドの保存：フォームやレコードにアップロードされた添付ファイルのデータ保存に使用し、特定のデータレコードとの関連付けにも対応します。

プラグイン設定

plugin-file-storage-s3-pro プラグインを有効にします
「Setting-> FileManager」をクリックしてファイル管理設定を開きます
「Add new」ボタンをクリックし、「S3 Pro」を選択します

ポップアップが表示されると、入力が必要なフォーム項目が多いことがわかります。以降のドキュメントを参照して、対象のファイルサービスに対応するパラメータ情報を取得し、フォームに正しく入力してください。

サービスプロバイダーの設定

Amazon S3

Bucket の作成

https://ap-southeast-1.console.aws.amazon.com/s3/home を開き、S3 コンソールにアクセスします
右側の「Create bucket」ボタンをクリックします

Bucket Name（バケット名）を入力します。その他の項目はデフォルト設定のままにし、ページ下部までスクロールして「Create」ボタンをクリックし、作成を完了します。

CORS の設定

buckets の一覧に移動し、先ほど作成した Bucket を見つけてクリックし、詳細ページを開きます

「Permission」タブをクリックし、下にスクロールして CORS 設定セクションを見つけます

以下の設定を入力します（必要に応じて詳細な設定に変更できます）。その後、保存します

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

AccessKey、SecretAccessKey の取得

ページ右上の「Security credentials」ボタンをクリックします

下にスクロールして「Access Keys」セクションを見つけ、「Create Access Key」ボタンをクリックします。

同意をクリックします（ここではルートアカウントを使用して説明していますが、本番環境では IAM の使用を推奨します）。

ページに表示された Access key と Secret access key を保存します

パラメータの取得と設定

AccessKey ID と AccessKey Secret には、前の手順で取得した対応する値を正確に入力します
Bucket の詳細ページにある properties パネルを開くと、Bucket 名と Region（リージョン）情報を取得できます。

パブリックアクセス（オプション）

これは必須ではありません。アップロードしたファイルを完全に公開する必要がある場合に設定します。

Permissions パネルを開き、下にスクロールして Object Ownership を見つけます。「編集」をクリックし、ACLs を有効にします

Block public access までスクロールし、「編集」をクリックして ACLs による制御を許可する設定にします

NocoBase で Public access にチェックを入れます

サムネイル設定（オプション）

この設定はオプションで、画像プレビューのサイズや表示効果を最適化する場合に使用します。このデプロイ方法では追加料金が発生する場合があります。具体的な料金については AWS の関連規約を参照してください。

Dynamic Image Transformation for Amazon CloudFront にアクセスします。
ページ下部にある Launch in the AWS Console ボタンをクリックし、ソリューションのデプロイを開始します。
画面の指示に従って設定を完了します。以下の項目には特に注意してください：
1. スタックの作成時に、ソース画像を含む Amazon S3 バケット名を指定する必要があります。先ほど作成したバケット名を入力してください。
2. デモ UI のデプロイを選択した場合、デプロイ完了後にその画面から画像処理機能をテストできます。AWS CloudFormation コンソールで対象のスタックを選択し、「出力」タブに移動して、DemoUrl キーに対応する値を見つけ、そのリンクをクリックしてデモ画面を開きます。
3. このソリューションでは、画像を効率的に処理するために sharp Node.js ライブラリを使用しています。GitHub リポジトリからソースコードをダウンロードし、必要に応じてカスタマイズできます。
設定完了後、デプロイステータスが CREATE_COMPLETE になるまで待ちます。
NocoBase の設定では、以下の点に注意してください：
1. Thumbnail rule：画像処理に関するパラメータを入力します。例：?width=100。詳細は AWS ドキュメントを参照してください。
2. Access endpoint：デプロイ後の Outputs -> ApiEndpoint の値を入力します。
3. Full access URL style：Ignore にチェックを入れる必要があります（設定時にバケット名を入力済みのため、アクセス時には不要です）。

設定例