Commencer

Stockage objet pour les fichiers et les envois.

Un stockage compatible S3 pour un projet : comment ajouter un bucket, les variables S3_* que reçoit votre application et le prix du stockage et des opérations.

3 MIN DE LECTURE

Le stockage objet conserve des fichiers en dehors de votre application : fichiers envoyés par les utilisateurs, rapports générés, médias, vos propres sauvegardes. Il fonctionne avec toute bibliothèque ou tout outil qui parle le protocole S3 — les SDK AWS, le disque s3 de Laravel, django-storages, boto3, rclone et bien d'autres.

Ajouter un stockage

Vue d'ensemble de l'application → Services → Stockage objet → Ajouter un stockage. Donnez un nom au bucket — lettres latines minuscules, chiffres et tirets, en commençant par une lettre — puis confirmez. Le bucket est prêt en quelques instants.

Un projet peut avoir jusqu'à 3 buckets.

Les variables que reçoit votre application

Les informations d'accès sont ajoutées d'elles-mêmes aux variables du projet ; l'application les prend en compte à son prochain déploiement :

VariableCe que c'est
S3_ENDPOINTl'adresse du stockage
S3_REGIONla région à indiquer dans votre client S3
S3_BUCKETle nom du bucket
S3_KEYla clé d'accès
S3_SECRETla clé secrète

La clé fonctionne pour ce bucket uniquement. Un deuxième bucket du projet reçoit ses variables précédées de son nom : <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET, etc.

Une variable que vous avez définie vous-même avec le même nom reste en place — pratique si une partie de votre application doit continuer à utiliser un stockage ailleurs. Voir Variables d'environnement.

Exemple : Laravel

Dans config/filesystems.php, faites pointer le disque s3 vers les variables :

'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,
],

Définissez ensuite FILESYSTEM_DISK=s3 dans l'onglet Variables.

Exemple : 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 },
})

Prix

Prix
Stockage0,025 $US par Go et par mois
Traficgratuit — les téléchargements depuis le stockage ne coûtent rien
Écritures6 $US par million d'opérations
Lectures0,50 $US par million d'opérations

Le volume stocké est mesuré chaque jour et moyenné sur le mois : un fichier conservé la moitié du mois coûte donc moitié prix. La consommation d'un mois civil est ajoutée au prochain paiement du projet sur une seule ligne ; il n'y a pas d'abonnement séparé.

Importer des fichiers

Les fichiers qui se trouvent déjà sur Amazon S3, Google Cloud Storage, un autre stockage compatible S3 ou dans un dossier de votre serveur peuvent être transférés dans un bucket — en une seule fois, ou progressivement sans interruption de service. Voir Transférer des fichiers vers le stockage objet.

Supprimer un bucket

La suppression du bucket efface tous les fichiers qu'il contient ; ils ne peuvent pas être restaurés, et ses variables disparaissent du projet. La suppression d'un bucket est réservée au propriétaire du compte et aux Administrateurs de l'application.

Toujours bloqué ?

Écrivez-nous dans le chat — l'AI répond immédiatement et un ingénieur intervient si besoin, à toute heure.

Contacter l'assistance