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.
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 :
| Variable | Ce que c'est |
|---|---|
S3_ENDPOINT | l'adresse du stockage |
S3_REGION | la région à indiquer dans votre client S3 |
S3_BUCKET | le nom du bucket |
S3_KEY | la clé d'accès |
S3_SECRET | la 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 | |
|---|---|
| Stockage | 0,025 $US par Go et par mois |
| Trafic | gratuit — les téléchargements depuis le stockage ne coûtent rien |
| Écritures | 6 $US par million d'opérations |
| Lectures | 0,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.