Co faktycznie ląduje w buckecie
Amazon S3 to obiektowa pamięć masowa AWS: pliki leżą w bucketach przypisanych do regionu, a dostęp odbywa się przez API. W Endora Commerce S3 jest jednym z trzech magazynów biblioteki zasobów, obok Google Cloud Storage i dysku lokalnego. Aktywny jest zawsze jeden, a domyślnie platforma startuje na dysku lokalnym.
Do biblioteki trafiają obrazy, wideo, pliki PDF i inne dokumenty, które potem są używane w kilku miejscach:
- galerie zdjęć produktów i główne obrazy kategorii,
- załączniki produktów, np. karty techniczne czy deklaracje,
- pliki produktów wirtualnych do pobrania,
- grafiki i dokumenty osadzone na stronach CMS.
Z tego samego magazynu korzystają też inne moduły. Pliki feedów produktowych, np. dla Google Merchant Center, są zapisywane w buckecie jako prywatne, pod własnym prefiksem i poza biblioteką zasobów, a na zewnątrz wydaje je sama platforma, nie adres S3.
Publiczne i prywatne: jak to wygląda w S3
Widoczność ustawia się osobno dla każdego zasobu, nie raz dla całego bucketu.
- Zasób publiczny ma stały adres. Domyślnie jest to adres bucketu w regionie, a po podaniu własnej domeny lub adresu CDN linki są budowane na niej.
- Zasób prywatny nie ma stałego adresu. Przy każdym odczycie panel lub sklep dostaje nowy, podpisany adres (presigned URL, podpis V4 z SDK AWS), ważny domyślnie 300 sekund. Czas ważności jest ustawieniem.
Dla kupującego B2B oznacza to, że link do dokumentu skopiowany z przeglądarki i wysłany dalej po kilku minutach przestaje działać. Warto pamiętać o dwóch rzeczach wynikających z działania samego S3: podpisany adres działa dla każdego, kto go ma, do chwili wygaśnięcia, a przy stałych kluczach użytkownika IAM jego ważność nie może przekroczyć 7 dni.
Co przygotować po stronie AWS
- Bucket w wybranym regionie. Dla firm z Polski i UE zwykle będzie to region europejski.
- Użytkownik IAM z kluczem dostępowym, ograniczony do tego jednego bucketu. Platforma wgrywa, odczytuje i usuwa obiekty, zmienia ich ACL oraz sprawdza dostępność bucketu, więc polityka powinna obejmować
s3:PutObject,s3:GetObject,s3:DeleteObject,s3:PutObjectAclis3:ListBucket. - Decyzja w sprawie ACL. Widoczność zasobu jest przekładana na ACL obiektu (
public-readalboprivate), tymczasem nowe buckety mają ACL domyślnie wyłączone (ustawienie „Bucket owner enforced”) i włączoną blokadę dostępu publicznego. W takiej konfiguracji S3 odrzuca zapis obiektu z ACL innym niż pełna kontrola właściciela. Jeśli pliki publiczne mają być serwowane prosto z bucketu, trzeba świadomie włączyć ACL i dopuścić publiczne ACL. Szczegóły opisuje dokumentacja AWS: Object Ownership.
Ustawienia w panelu
Konfiguracja znajduje się w Ustawieniach, w grupie Storage.
| Ustawienie | Do czego służy |
|---|---|
assets.s3.bucket, assets.s3.region | Nazwa bucketu i region, oba wymagane |
assets.s3.access_key_id, assets.s3.secret_access_key | Klucz użytkownika IAM |
assets.s3.prefix | Opcjonalny prefiks kluczy, przydatny przy buckecie dzielonym z innym systemem |
assets.s3.public_base_url | Opcjonalny adres CDN lub własnej domeny dla plików publicznych |
assets.s3.endpoint | Opcjonalny endpoint usługi zgodnej z S3, np. MinIO |
Po zapisaniu można wywołać test połączenia (POST /api/v1/admin/assets/storage/self-check), który sprawdza, czy bucket jest osiągalny przy podanych danych.
Dwie rzeczy, o których warto wiedzieć przed startem:
- Dostęp do Ustawień powinny mieć tylko zaufane osoby, a klucz IAM nie powinien mieć uprawnień poza tym bucketem.
- Przełączenie magazynu nie przenosi plików. Każdy zasób pamięta, gdzie został zapisany, i jest stamtąd odczytywany, więc po przejściu z dysku lokalnego na S3 stare pliki zostają na dysku, a nowe trafiają do bucketu. Oba magazyny muszą pozostać dostępne.
Usuwanie plików
Usunięty zasób znika z list, ale przez domyślnie 30 dni można go przywrócić. Dopiero potem proces w tle kasuje obiekt z bucketu, a jeśli S3 odmówi, np. po odwołaniu klucza, ponawia próbę. Pliku używanego przez produkt, kategorię lub stronę CMS nie da się usunąć, dopóki nie zostanie odpięty.
Kiedy S3, a kiedy coś innego
- S3: gdy infrastruktura już działa w AWS, aplikacja ma więcej niż jedną instancję albo pliki mają mieć kopie i wersjonowanie niezależne od serwera aplikacji.
- Google Cloud Storage: gdy reszta środowiska jest w Google Cloud. Model widoczności i ustawień jest taki sam.
- Dysk lokalny: przy developmencie i prostych wdrożeniach na jednym serwerze, pod warunkiem że wolumen z plikami jest objęty kopią zapasową razem z bazą.
Pozostałe integracje infrastrukturalne i biznesowe są zebrane na stronie integracji.