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

#はじめに

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

#機能

1. クライアントサイドアップロード：ファイルアップロードプロセスはNocoBaseサーバーを経由せず、ファイルストレージサービスに直接接続するため、より効率的で高速なアップロード体験を実現します。

2. プライベートアクセス：ファイルにアクセスする際、すべてのURLは署名付きの一時的な認証アドレスとなり、ファイルアクセスの安全性と有効性を確保します。

#ユースケース

1. ファイルコレクション管理：アップロードされたすべてのファイルを一元的に管理・保存し、多様なファイルタイプと保存方法をサポートすることで、ファイルの分類と検索を容易にします。

2. 添付ファイルフィールドストレージ：フォームやレコードにアップロードされる添付ファイルのデータストレージとして利用され、特定のデータレコードとの関連付けをサポートします。

#プラグイン設定

1. plugin-file-storage-s3-pro プラグインを有効にします。

2. 「Setting」->「FileManager」をクリックし、ファイル管理設定画面に進みます。

3. 「Add new」ボタンをクリックし、「S3 Pro」を選択します。

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

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

#Amazon S3

#バケットの作成

1. https://ap-southeast-1.console.aws.amazon.com/s3/home を開いてS3コンソールにアクセスします。

2. 右側の「Create bucket」ボタンをクリックします。

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

#CORS設定

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

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

3. 以下の設定を入力し（必要に応じて詳細な設定も可能です）、保存します。

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

#AccessKey、SecretAccessKey の取得

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

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

3. 同意をクリックします（これはルートアカウントでのデモンストレーションです。本番環境ではIAMを使用することをお勧めします）。

4. ページに表示されるAccess keyとSecret access keyを保存します。

#パラメータの取得と設定

1. AccessKey IDとAccessKey Secretは、前の手順で取得した値です。正確に入力してください。

2. バケット詳細ページの「Properties」パネルに移動すると、バケット名とリージョン（Region）情報を取得できます。

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

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

1. 「Permissions」パネルに移動し、「Object Ownership」までスクロールして「編集」をクリックし、ACLsを有効にします。

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

3. NocoBaseで「Public access」にチェックを入れます。

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

この設定はオプションであり、画像のプレビューサイズや効果を最適化する場合に利用します。このデプロイソリューションは追加費用が発生する可能性がありますのでご注意ください。具体的な費用については、AWSの関連規約をご参照ください。

1. Dynamic Image Transformation for Amazon CloudFront にアクセスします。

2. ページ下部の Launch in the AWS Console ボタンをクリックし、ソリューションのデプロイを開始します。

3. プロンプトに従って設定を完了します。以下のオプションには特に注意してください。

   1. スタックを作成する際、ソース画像を含むAmazon S3バケット名を指定する必要があります。以前に作成したバケット名を入力してください。
   2. デモUIのデプロイを選択した場合、デプロイ完了後にこのインターフェースを通じて画像処理機能をテストできます。AWS CloudFormationコンソールでスタックを選択し、「出力」タブに移動してDemoUrlキーに対応する値を見つけ、そのリンクをクリックしてデモインターフェースを開きます。
   3. このソリューションは、sharp Node.jsライブラリを使用して画像を効率的に処理します。GitHubリポジトリからソースコードをダウンロードし、必要に応じてカスタマイズできます。

   

4. 設定が完了したら、デプロイステータスが CREATE_COMPLETE になるまで待ちます。

5. NocoBaseの設定には、いくつかの注意点があります。

   1. Thumbnail rule：画像処理に関連するパラメータ（例： ?width=100）を入力します。詳細は AWSドキュメント をご参照ください。
   2. Access endpoint：デプロイ後のOutputs -> ApiEndpointの値を入力します。
   3. Full access URL style：Ignore にチェックを入れる必要があります（設定時にバケット名が入力済みのため、アクセス時に再度指定する必要はありません）。

   

#設定例

#Aliyun OSS

#バケットの作成

1. OSSコンソール https://oss.console.aliyun.com/overview を開きます。

2. 左側メニューの「Buckets」をクリックし、次に「Create Bucket」ボタンをクリックしてバケットの作成を開始します。

3. バケット関連情報を入力し、最後に「Create」ボタンをクリックします。

   1. バケット名はビジネス要件に合わせて自由に設定してください。

   2. リージョンは、ユーザーに最も近い地域を選択してください。

   3. その他の設定はデフォルトのままで構いませんが、必要に応じてご自身で設定することも可能です。

#CORS設定

1. 前の手順で作成したバケットの詳細ページに移動します。

2. 中央メニューの「Content Security」->「CORS」をクリックします。

3. 「Create Rule」ボタンをクリックし、関連する内容を入力して下にスクロールし、「OK」をクリックします。以下のスクリーンショットを参考にすることも、より詳細な設定を行うことも可能です。

#AccessKey、SecretAccessKey の取得

1. 右上のアバターの下にある「AccessKey」をクリックします。

2. ここではデモンストレーションの便宜上、メインアカウントを使用してAccessKeyを作成します。本番環境ではRAMを使用して作成することをお勧めします。詳細は https://www.alibabacloud.com/help/en/ram/user-guide/create-an-accesskey-pair をご参照ください。

3. 「Create AccessKey」ボタンをクリックします。

4. アカウント認証を行います。

5. ページに表示されるAccess keyとSecret access keyを保存します。

#パラメータの取得と設定

1. AccessKey IDとAccessKey Secretは、前の手順で取得した値です。

2. バケット詳細ページに移動し、バケット名を取得します。

3. 下にスクロールしてリージョンを取得します（末尾の「.aliyuncs.com」は不要です）。

4. エンドポイントアドレスを取得し、NocoBaseに入力する際は「https://」のプレフィックスを追加する必要があります。

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

この設定はオプションであり、画像のプレビューサイズや効果を最適化する必要がある場合にのみ使用します。

1. Thumbnail rule に関連するパラメータを入力します。具体的なパラメータ設定は、画像処理パラメータ をご参照ください。

2. Full upload URL style と Full access URL style は同じで構いません。

#設定例

#MinIO

#バケットの作成

1. 左側の「Buckets」メニューをクリック -> 「Create Bucket」をクリックし、作成ページに進みます。
2. バケット名を入力後、「保存」ボタンをクリックします。

#AccessKey、SecretAccessKey の取得

1. 「Access Keys」に移動 -> 「Create access key」ボタンをクリックし、作成ページに進みます。

2. 「保存」ボタンをクリックします。

1. ポップアップウィンドウに表示されるAccess KeyとSecret Keyを保存し、後続の設定で使用します。

#パラメータ設定

1. NocoBase -> 「File manager」ページに移動します。

2. 「Add new」ボタンをクリックし、「S3 Pro」を選択します。

3. フォームに記入します。

   • AccessKey ID と AccessKey Secret は、前の手順で保存したテキストです。
   • Region：プライベートデプロイされたMinIOにはRegionの概念がないため、「auto」に設定できます。
   • Endpoint：デプロイしたサービスドメイン名またはIPアドレスを入力します。
   • Full access URL style は「Path-Style」に設定する必要があります。

#設定例

#Tencent COS

上記ファイルサービスの設定を参考にしてください。ロジックは同様です。

#設定例

#Cloudflare R2

上記ファイルサービスの設定を参考にしてください。ロジックは同様です。

#設定例