Armazenamento de objetos para arquivos e uploads.
Armazenamento compatível com S3 para um projeto: como adicionar um bucket, as variáveis S3_* que a sua aplicação recebe e como o armazenamento e as operações são cobrados.
O armazenamento de objetos guarda arquivos fora da sua aplicação: uploads de usuários, relatórios gerados, mídia, seus próprios backups. Ele funciona com qualquer biblioteca ou ferramenta que fale o protocolo S3 — os SDKs da AWS, o disco s3 do Laravel, django-storages, boto3, rclone e muitas outras.
Como adicionar armazenamento
Na aplicação, Visão geral → Serviços → Armazenamento de objetos → Adicionar armazenamento. Dê um nome ao bucket — letras latinas minúsculas, números e hifens, começando por uma letra — e confirme. O bucket fica pronto em instantes.
Um projeto pode ter até 3 buckets.
As variáveis que a sua aplicação recebe
Os dados de acesso são adicionados sozinhos às variáveis do projeto; a aplicação passa a usá-los no próximo deploy:
| Variável | O que é |
|---|---|
S3_ENDPOINT | o endereço do armazenamento |
S3_REGION | a região para usar no seu cliente S3 |
S3_BUCKET | o nome do bucket |
S3_KEY | a chave de acesso |
S3_SECRET | a chave secreta |
A chave funciona só para este bucket. Um segundo bucket do projeto recebe variáveis com o nome dele na frente: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET e assim por diante.
Uma variável sua com o mesmo nome continua valendo — útil se parte da aplicação deve continuar usando um armazenamento em outro lugar. Veja Variáveis de ambiente.
Exemplo: Laravel
Em config/filesystems.php, aponte o disco s3 para as variáveis:
'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,
],Depois defina FILESYSTEM_DISK=s3 na aba Variáveis.
Exemplo: 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 },
})Preço
| Preço | |
|---|---|
| Armazenamento | US$ 0,025 por GB por mês |
| Tráfego | grátis — downloads do armazenamento não custam nada |
| Gravações | US$ 6 por milhão de operações |
| Leituras | US$ 0,50 por milhão de operações |
O armazenamento é medido todos os dias e cobrado pela média do mês, então um arquivo guardado por meio mês custa metade. O uso de um mês do calendário entra no próximo pagamento do projeto como uma única linha; não existe assinatura separada.
Como trazer seus arquivos
Arquivos que já estão no Amazon S3, no Google Cloud Storage, em outro armazenamento compatível com S3 ou numa pasta do seu servidor podem ser movidos para um bucket — tudo de uma vez ou aos poucos, sem tirar nada do ar. Veja Mover arquivos para o armazenamento de objetos.
Como excluir um bucket
Excluir o bucket remove todos os arquivos dele; eles não podem ser recuperados, e as variáveis do bucket saem do projeto. Excluir um bucket está disponível para o titular da conta e para os Administradores da aplicação.