Składowanie
Interfejs API REST na projekt w pamięci S3 (SeaweedFS S3), transformacje obrazów w locie z pochodną pamięcią podręczną, podpisane adresy URL HMAC, zasobniki publiczne lub prywatne, kosz i przywracanie.
Jeden segment, jedno źródło, jeden CDN#
Usługa aura-storage zarządza Twoimi plikami binarnymi: wysyłaniem, pobieraniem, transformacjami obrazów, podpisanymi adresami URL, koszem. Udostępnia własne REST API pod /v1/storage/{project_id} i opiera się na pamięci masowej S3 (SeaweedFS S3) wewnętrznie — narzędzia S3 (rclone, boto3) nie łączą się z nim bezpośrednio.
Obiekty są zorganizowane w segmenty. Każdy segment ma politykę (publiczną lub prywatną), limity rozmiaru, opcjonalny czas TTL i zestaw zasad RLS kontrolujących, kto może czytać/zapisywać każdą ścieżkę.
Metadane znajdują się w schemacie projektu: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Bajty znajdują się w pamięci S3.
Ścieżka → RLS → CDN → początek#
Podczas odczytu usługa sprawdza dostęp do żądanej ścieżki, a następnie udostępnia bajty z pamięci. Jeśli zapytanie zawiera parametry transformacji, odpowiednia pochodna jest ponownie wykorzystywana, jeśli już istnieje, w przeciwnym razie jest obliczana, a następnie buforowana. Podczas przesyłania przepływ jest odwrotny: klient → usługa → pamięć masowa, po zapisaniu limitów kontroli i zasobnika.
┌──── derivative cache ────┐
GET /v1/storage/{pid}/… ─▶ │ derivative cached? │
│ no ⇢ origin │
└──────────┬───────────────┘
│
┌──────────▼───────────────┐
│ aura-storage │
│ ─ access control │
│ ─ transforms │
│ ─ derivative cache │
└──────────┬───────────────┘
│
S3 storage (SeaweedFS S3)
Sześć rodzimych umiejętności#
- API REST na projekt. Trasy /v1/storage/{project_id}/… w pamięci S3 (SeaweedFS S3) — to nie jest S3 API: S3 SDK nie są do niego podłączane.
- Przemienia się w locie. szerokość, wysokość, dopasowanie, format (jpeg/png/webp/gif), jakość, obrót, odwrócenie. Każda kombinacja jest buforowana jako pochodna.
- Podpisane adresy URL. HMAC podpis metody + segment + klucz + data ważności. Domyślnie TTL 3600 s, tajna rotacja na projekt.
- Przesyłanie wieloczęściowe. Proste przesyłanie w formacie multipart/form-data lub init/part/complete w przypadku dużych plików.
- Śmieci i renowacja. Miękkie usuwanie: /trash wyświetla listę usuniętych obiektów, /restore/{key} przywraca je.
- Zasobniki publiczne lub prywatne. Wiadro zawiera politykę dostępu, limity rozmiaru i listę autoryzowanych typów MIME.
Cztery podstawowe operacje#
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
contentType: file.type,
upsert: true,
})
// Bez upsert, ścieżka już zajęta kończy się niepowodzeniem w 409 (kod CONFLICT)
Adresy URL transformacji są niezmienne według parametrów. ?width=240&format=png i ?width=240&format=webp to dwa różne adresy URL, a zatem dwie różne pochodne: każda kombinacja jest obliczana tylko raz, a następnie ponownie odczytywana z pamięci podręcznej pochodnych.
RLS na ścieżkach obiektów#
Metadane obiektu znajdują się w tabeli storage_objects schematu projektu (kolumny bucket_name, key, owner_id, metadata, deleted_at), z włączoną opcją RLS. Nie ma schematu storage ani funkcji storage.foldername(): zasady są zapisane w kolumnach.
-- Przeczytaj: własny obiekt lub dowolny obiekt z publicznego zasobnika
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)
);
-- Pisanie: tylko własne obiekty
create policy storage_objects_insert on storage_objects for insert
with check (owner_id = auth.uid());