Stocare de obiecte pentru fișiere și încărcări.
Stocare compatibilă S3 pentru un proiect: cum adaugi un bucket, ce variabile S3_* primește aplicația ta și cum se taxează spațiul și operațiunile.
Stocarea de obiecte păstrează fișierele în afara aplicației: fișiere încărcate de utilizatori, rapoarte generate, media, propriile tale backupuri. Funcționează cu orice bibliotecă sau instrument care știe protocolul S3 — SDK-urile AWS, discul s3 din Laravel, django-storages, boto3, rclone și multe altele.
Adăugarea stocării
În aplicație: Prezentare generală → Servicii → Stocare de obiecte → Adaugă stocare. Dă un nume bucketului — litere latine mici, cifre și cratime, începând cu o literă — și confirmă. Bucketul e gata într-o clipă.
Un proiect poate avea cel mult 3 bucketuri.
Variabilele pe care le primește aplicația
Datele de acces se adaugă singure în variabilele proiectului; aplicația le preia la următoarea publicare:
| Variabilă | Ce este |
|---|---|
S3_ENDPOINT | adresa stocării |
S3_REGION | regiunea de folosit în clientul S3 |
S3_BUCKET | numele bucketului |
S3_KEY | cheia de acces |
S3_SECRET | cheia secretă |
Cheia funcționează doar pentru acest bucket. Al doilea bucket al proiectului își primește variabilele cu numele lui în față: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET și așa mai departe.
O variabilă proprie cu același nume rămâne neschimbată — util dacă o parte din aplicație trebuie să folosească în continuare o stocare din altă parte. Vezi Variabile de mediu.
Exemplu: Laravel
În config/filesystems.php, îndreaptă discul s3 spre variabile:
'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,
],Apoi setează FILESYSTEM_DISK=s3 în fila Variabile.
Exemplu: 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 },
})Preț
| Preț | |
|---|---|
| Spațiu de stocare | 0,025 USD pe GB pe lună |
| Trafic | gratuit — descărcările din stocare nu costă nimic |
| Scrieri | 6 USD pe milion de operațiuni |
| Citiri | 0,50 USD pe milion de operațiuni |
Spațiul ocupat se măsoară zilnic și se face media pe lună, așa că un fișier păstrat jumătate de lună costă jumătate. Consumul dintr-o lună calendaristică se adaugă la următoarea plată a proiectului, pe un singur rând; nu există un abonament separat.
Mutarea fișierelor
Fișierele aflate deja în Amazon S3, Google Cloud Storage, altă stocare compatibilă S3 sau într-un folder de pe serverul tău pot fi mutate într-un bucket — toate odată sau treptat, fără întreruperi. Vezi Mută fișierele în stocarea de obiecte.
Ștergerea unui bucket
Ștergerea bucketului elimină toate fișierele din el; nu pot fi restaurate, iar variabilele lui dispar din proiect. Ștergerea unui bucket este disponibilă proprietarului contului și Administratorilor aplicației.