Almacenamiento de objetos para archivos y subidas.
Almacenamiento compatible con S3 para un proyecto: cómo añadir un bucket, las variables S3_* que recibe tu aplicación y cómo se cobran el almacenamiento y las operaciones.
El almacenamiento de objetos guarda archivos fuera de tu aplicación: subidas de los usuarios, informes generados, archivos multimedia, tus propias copias de seguridad. Funciona con cualquier biblioteca o herramienta que hable el protocolo S3: los SDK de AWS, el disco s3 de Laravel, django-storages, boto3, rclone y muchas más.
Añadir almacenamiento
En la aplicación, Resumen → Servicios → Almacenamiento de objetos → Añadir almacenamiento. Ponle un nombre al bucket —letras latinas minúsculas, números y guiones, empezando por una letra— y confirma. El bucket estará listo en un momento.
Un proyecto puede tener hasta 3 buckets.
Las variables que recibe tu aplicación
Los datos de acceso se añaden solos a las variables del proyecto; la aplicación los toma con su próximo despliegue:
| Variable | Qué es |
|---|---|
S3_ENDPOINT | la dirección del almacenamiento |
S3_REGION | la región que debes usar en tu cliente S3 |
S3_BUCKET | el nombre del bucket |
S3_KEY | la clave de acceso |
S3_SECRET | la clave secreta |
La clave funciona solo con este bucket. Un segundo bucket del proyecto recibe sus variables con su nombre delante: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET, etc.
Si tienes una variable propia con el mismo nombre, se mantiene; es útil si parte de tu aplicación debe seguir usando un almacenamiento en otro sitio. Consulta Variables de entorno.
Ejemplo: Laravel
En config/filesystems.php, apunta el disco s3 a las 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,
],Después, define FILESYSTEM_DISK=s3 en la pestaña Variables.
Ejemplo: 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 },
})Precio
| Precio | |
|---|---|
| Almacenamiento | 0,025 US$ por GB al mes |
| Tráfico | gratis: las descargas desde el almacenamiento no cuestan nada |
| Escrituras | 6 US$ por millón de operaciones |
| Lecturas | 0,50 US$ por millón de operaciones |
El almacenamiento se mide cada día y se promedia a lo largo del mes, así que un archivo guardado durante medio mes cuesta la mitad. El uso de cada mes natural se suma al próximo pago del proyecto como una sola línea; no hay una suscripción aparte.
Traer tus archivos
Los archivos que ya tienes en Amazon S3, Google Cloud Storage, otro almacenamiento compatible con S3 o una carpeta de tu servidor se pueden pasar a un bucket, todos de una vez o poco a poco sin cortes de servicio. Consulta Mover archivos al almacenamiento de objetos.
Eliminar un bucket
Eliminar el bucket borra todos los archivos que contiene; no se pueden recuperar y sus variables desaparecen del proyecto. Eliminar un bucket está disponible para el propietario de la cuenta y los Administradores de la aplicación.