ストレージ
S3 ストレージ上のプロジェクトごとの REST API (SeaweedFS S3)、派生キャッシュを使用したオンザフライ画像変換、HMAC 署名付き URL、パブリックまたはプライベート バケット、ゴミ箱と復元。
1 つのバケット、1 つのオリジン、1 つの CDN#
aura-storage サービスは、バイナリ ファイル (アップロード、ダウンロード、画像変換、署名付き URL、ゴミ箱) を管理します。これは、独自の REST API を /v1/storage/{project_id} の下で公開し、内部的に S3 ストレージ (SeaweedFS S3) に依存します。S3 ツール (rclone、boto3) は直接接続しません。
オブジェクトはバケットに編成されます。各バケットには、ポリシー (パブリックまたはプライベート)、サイズ制限、オプションの TTL、および各パスを読み取り/書き込みできるユーザーを制御する一連の RLS ポリシーがあります。
メタデータはプロジェクト スキーマ内に存在します: storage_buckets、 storage_objects、 storage_derivatives、 storage_project_settings、 storage_audit_log。バイトは S3 ストレージにあります。
パス → RLS → CDN → 原点#
読み取り中に、サービスは要求されたパスへのアクセスをチェックし、ストレージからバイトを提供します。クエリに変換パラメータが指定されている場合、対応する導関数が既に存在する場合は再利用され、存在しない場合は計算されてキャッシュされます。アップロードでは、制御とバケット制限を書き込んだ後、フローが逆になります。クライアント→サービス→ストレージです。
┌──── derivative cache ────┐
GET /v1/storage/{pid}/… ─▶ │ derivative cached? │
│ no ⇢ origin │
└──────────┬───────────────┘
│
┌──────────▼───────────────┐
│ aura-storage │
│ ─ access control │
│ ─ transforms │
│ ─ derivative cache │
└──────────┬───────────────┘
│
S3 storage (SeaweedFS S3)
6つのネイティブアビリティ#
- プロジェクトごとの REST API。 S3 ストレージ (SeaweedFS S3) 上で /v1/storage/{project_id}/… をルーティングします。これは S3 API ではありません。S3 SDK はプラグインされません。
- その場で変換します。 幅、高さ、フィット、形式 (jpeg/png/webp/gif)、品質、回転、反転。各組み合わせは派生物としてキャッシュされます。
- 署名付き URL。 HMAC メソッド + バケット + キー + 有効期限の署名。デフォルトでは TTL 3600、プロジェクトごとにシークレットローテーション。
- マルチパートアップロード。 multipart/form-data での単純なアップロード、または大きなファイルの場合は init/part/complete。
- ゴミ箱と復元。 論理的な削除: /trash は削除されたオブジェクトをリストし、/restore/{key} はそれらを復元します。
- パブリックまたはプライベート バケット。 バケットには、アクセス ポリシー、サイズ制限、および承認された MIME タイプのリストが含まれます。
4つの基本操作#
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
contentType: file.type,
upsert: true,
})
// UPSERT を行わないと、すでに占有されているパスは 409 (CONFLICT コード) で失敗します。
変換 URL はパラメータによって不変です。 ?width=240&format=png と ?width=240&format=webp は 2 つの異なる URL、つまり 2 つの異なる派生です。各組み合わせは 1 回だけ計算され、その後派生キャッシュから再読み取りされます。
オブジェクト パス上の RLS#
オブジェクトのメタデータは、 RLS が有効な状態で、プロジェクト スキーマの storage_objects テーブル (列 bucket_name、 key、 owner_id、 metadata、 deleted_at) に存在します。 storage スキーマも storage.foldername() 関数もありません。ポリシーは列に書き込まれます。
-- 読み取り: 独自のオブジェクト、またはパブリック バケットの任意のオブジェクト
create policy storage_objects_select on storage_objects for select
using (
owner_id = auth.uid()
or exists (select 1 from storage_buckets b
where b.name = storage_objects.bucket_name and b.public)
);
-- 書き込み: 自分のオブジェクトのみ
create policy storage_objects_insert on storage_objects for insert
with check (owner_id = auth.uid());