ストレージエンジン：S3 (Pro)

はじめに

ファイル管理プラグインを基盤として、S3プロトコル互換のファイルストレージタイプが新たに追加されました。Amazon S3、Aliyun OSS、Tencent COS、MinIO、Cloudflare R2など、S3プロトコルをサポートするあらゆるオブジェクトストレージサービスを簡単に連携でき、ストレージサービスの互換性と柔軟性がさらに向上します。

機能

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

ユースケース

ファイルコレクション管理：アップロードされたすべてのファイルを一元的に管理・保存し、多様なファイルタイプと保存方法をサポートすることで、ファイルの分類と検索を容易にします。
添付ファイルフィールドストレージ：フォームやレコードにアップロードされる添付ファイルのデータストレージとして利用され、特定のデータレコードとの関連付けをサポートします。

プラグイン設定

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

ポップアップが表示されたら、多くの入力項目があるフォームが表示されます。対応するファイルサービスに関するパラメータ情報は、後続のドキュメントを参照し、フォームに正しく入力してください。

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

Amazon S3

バケットの作成

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

バケット名を入力します。その他のフィールドはデフォルト設定のままで構いません。ページ下部までスクロールし、「Create」ボタンをクリックして作成を完了します。

CORS設定

バケットリストに移動し、先ほど作成したバケットを見つけてクリックし、詳細ページに進みます。

「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は、前の手順で取得した値です。正確に入力してください。
バケット詳細ページの「Properties」パネルに移動すると、バケット名とリージョン（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 にチェックを入れる必要があります（設定時にバケット名が入力済みのため、アクセス時に再度指定する必要はありません）。

設定例