Magazyn obiektów na pliki i uploady.
Magazyn zgodny z S3 dla projektu: jak dodać bucket, jakie zmienne S3_* dostaje aplikacja i ile kosztują przechowywanie i operacje.
Magazyn obiektów przechowuje pliki poza aplikacją: pliki wgrywane przez użytkowników, generowane raporty, media, twoje własne kopie zapasowe. Działa z każdą biblioteką i każdym narzędziem, które obsługuje protokół S3 — z AWS SDK, dyskiem s3 w Laravelu, django-storages, boto3, rclone i wieloma innymi.
Dodawanie magazynu
Przegląd aplikacji → Usługi → Magazyn obiektów → Dodaj magazyn. Nadaj bucketowi nazwę — małe litery łacińskie, cyfry i myślniki, na początku litera — i potwierdź. Bucket jest gotowy po chwili.
Projekt może mieć do 3 bucketów.
Zmienne, które dostaje aplikacja
Dane dostępu same trafiają do zmiennych projektu; aplikacja odczyta je przy następnym wdrożeniu:
| Zmienna | Co to jest |
|---|---|
S3_ENDPOINT | adres magazynu |
S3_REGION | region do ustawienia w kliencie S3 |
S3_BUCKET | nazwa bucketu |
S3_KEY | klucz dostępu |
S3_SECRET | klucz tajny |
Klucz działa tylko dla tego bucketu. Drugi bucket projektu dostaje zmienne z jego nazwą na początku: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET i tak dalej.
Twoja własna zmienna o tej samej nazwie zostaje na miejscu — przydaje się, gdy część aplikacji ma dalej korzystać z magazynu gdzie indziej. Zobacz Zmienne środowiskowe.
Przykład: Laravel
W config/filesystems.php skieruj dysk s3 na te zmienne:
's3' => [
'driver' => 's3',
'key' => env('S3_KEY'),
'secret' => env('S3_SECRET'),
'region' => env('S3_REGION'),
'bucket' => env('S3_BUCKET'),
'endpoint' => env('S3_ENDPOINT'),
'use_path_style_endpoint' => true,
],Następnie ustaw FILESYSTEM_DISK=s3 na karcie Zmienne.
Przykład: Node.js
import { S3Client } from '@aws-sdk/client-s3'
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})Cena
| Cena | |
|---|---|
| Przechowywanie | 0,025 USD za GB miesięcznie |
| Transfer | bezpłatny — pobieranie z magazynu nic nie kosztuje |
| Zapisy | 6 USD za milion operacji |
| Odczyty | 0,50 USD za milion operacji |
Zajęte miejsce mierzymy codziennie i uśredniamy w skali miesiąca, więc plik trzymany przez pół miesiąca kosztuje połowę. Zużycie z miesiąca kalendarzowego doliczamy do następnej płatności projektu jako jedną pozycję; nie ma osobnej subskrypcji.
Przenoszenie plików
Pliki, które już są w Amazon S3, Google Cloud Storage, innym magazynie zgodnym z S3 albo w folderze na twoim serwerze, można przenieść do bucketu — od razu w całości albo stopniowo, bez przestoju. Zobacz Przenoszenie plików do magazynu obiektów.
Usuwanie bucketu
Usunięcie bucketu kasuje wszystkie znajdujące się w nim pliki; nie da się ich przywrócić, a jego zmienne znikają z projektu. Bucket może usunąć właściciel konta i Administratorzy aplikacji.