Object storage per file e upload.
Storage compatibile S3 per un progetto: come aggiungere un bucket, le variabili S3_* che riceve la tua applicazione e come si pagano spazio e operazioni.
L'object storage conserva i file fuori dalla tua applicazione: upload degli utenti, report generati, file multimediali, i tuoi backup. Funziona con qualsiasi libreria o strumento che parla il protocollo S3: gli SDK di AWS, il disco s3 di Laravel, django-storages, boto3, rclone e molti altri.
Aggiungere lo storage
Nella Panoramica dell'applicazione → Servizi → Object storage → Aggiungi storage. Dai un nome al bucket (lettere latine minuscole, cifre e trattini, iniziando con una lettera) e conferma. Il bucket è pronto in un attimo.
Un progetto può avere fino a 3 bucket.
Le variabili che riceve la tua applicazione
I dati di accesso vengono aggiunti da soli alle variabili del progetto; l'applicazione li riceve con il deploy successivo:
| Variabile | Che cos'è |
|---|---|
S3_ENDPOINT | l'indirizzo dello storage |
S3_REGION | la regione da usare nel tuo client S3 |
S3_BUCKET | il nome del bucket |
S3_KEY | la chiave di accesso |
S3_SECRET | la chiave segreta |
La chiave funziona solo per questo bucket. Un secondo bucket del progetto riceve le sue variabili con il proprio nome davanti: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET e così via.
Una tua variabile con lo stesso nome resta com'è: utile se una parte dell'applicazione deve continuare a usare uno storage altrove. Vedi Variabili d'ambiente.
Esempio: Laravel
In config/filesystems.php collega il disco s3 alle variabili:
'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,
],Poi imposta FILESYSTEM_DISK=s3 nella scheda Variabili.
Esempio: 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 },
})Prezzo
| Prezzo | |
|---|---|
| Spazio | 0,025 USD per GB al mese |
| Traffico | gratuito: i download dallo storage non costano nulla |
| Scritture | 6 USD per milione di operazioni |
| Letture | 0,50 USD per milione di operazioni |
Lo spazio viene misurato ogni giorno e calcolato come media del mese, quindi un file conservato per mezzo mese costa la metà. I consumi di un mese solare vengono aggiunti al pagamento successivo del progetto come un'unica voce; non c'è un abbonamento separato.
Spostare i file
I file che hai già su Amazon S3, Google Cloud Storage, un altro storage compatibile S3 o in una cartella del tuo server possono essere spostati in un bucket, tutti in una volta oppure gradualmente senza interruzioni. Vedi Spostare i file nell'object storage.
Eliminare un bucket
L'eliminazione del bucket cancella tutti i file al suo interno: non si possono ripristinare e le sue variabili vengono tolte dal progetto. Possono eliminare un bucket il proprietario dell'account e gli Amministratori dell'applicazione.