Objectopslag voor bestanden en uploads.
S3-compatibele opslag voor een project: zo voeg je een bucket toe, deze S3_*-variabelen krijgt je applicatie, en zo worden opslag en bewerkingen geprijsd.
Objectopslag bewaart bestanden buiten je applicatie: uploads van gebruikers, gegenereerde rapporten, media, je eigen back-ups. Het werkt met elke library of tool die het S3-protocol spreekt — de AWS SDK's, de s3-disk van Laravel, django-storages, boto3, rclone en nog veel meer.
Opslag toevoegen
Overzicht van de applicatie → Diensten → Objectopslag → Opslag toevoegen. Geef de bucket een naam — kleine Latijnse letters, cijfers en streepjes, beginnend met een letter — en bevestig. De bucket is binnen een paar tellen klaar.
Een project kan maximaal 3 buckets hebben.
De variabelen die je applicatie krijgt
De toegangsgegevens worden automatisch aan de variabelen van het project toegevoegd; de applicatie pakt ze op bij de volgende deploy:
| Variabele | Wat het is |
|---|---|
S3_ENDPOINT | het adres van de opslag |
S3_REGION | de regio die je in je S3-client gebruikt |
S3_BUCKET | de naam van de bucket |
S3_KEY | de toegangssleutel |
S3_SECRET | de geheime sleutel |
De sleutel werkt alleen voor deze bucket. Een tweede bucket van het project krijgt variabelen met de naam ervoor: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET enzovoort.
Een eigen variabele met dezelfde naam blijft gewoon staan — handig als een deel van je applicatie opslag elders moet blijven gebruiken. Zie Omgevingsvariabelen.
Voorbeeld: Laravel
Laat in config/filesystems.php de s3-disk naar de variabelen verwijzen:
'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,
],Zet daarna FILESYSTEM_DISK=s3 op het tabblad Variabelen.
Voorbeeld: 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 },
})Prijs
| Prijs | |
|---|---|
| Opslag | US$ 0,025 per GB per maand |
| Verkeer | gratis — downloads uit de opslag kosten niets |
| Schrijfbewerkingen | US$ 6 per miljoen bewerkingen |
| Leesbewerkingen | US$ 0,50 per miljoen bewerkingen |
De opslag wordt elke dag gemeten en over de maand gemiddeld, dus een bestand dat je een halve maand bewaart, kost de helft. Het verbruik van een kalendermaand komt als één regel bij de volgende betaling van het project; er is geen apart abonnement.
Bestanden verhuizen
Bestanden die al in Amazon S3, Google Cloud Storage, een andere S3-compatibele opslag of een map op je server staan, kun je naar een bucket verhuizen — in één keer, of geleidelijk zonder downtime. Zie Bestanden naar objectopslag verhuizen.
Een bucket verwijderen
Bucket verwijderen wist alle bestanden erin; die zijn niet terug te halen, en de variabelen van de bucket verdwijnen uit het project. Een bucket verwijderen kunnen de accounteigenaar en de Beheerders van de applicatie.