Aan de slag

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.

2 MIN LEESTIJD

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:

VariabeleWat het is
S3_ENDPOINThet adres van de opslag
S3_REGIONde regio die je in je S3-client gebruikt
S3_BUCKETde naam van de bucket
S3_KEYde toegangssleutel
S3_SECRETde 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
OpslagUS$ 0,025 per GB per maand
Verkeergratis — downloads uit de opslag kosten niets
SchrijfbewerkingenUS$ 6 per miljoen bewerkingen
LeesbewerkingenUS$ 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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support