Armazenamento de objetos para ficheiros 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 são cobrados o armazenamento e as operações.
O armazenamento de objetos guarda ficheiros fora da sua aplicação: uploads dos utilizadores, relatórios gerados, multimédia, as suas próprias cópias de segurança. Funciona com qualquer biblioteca ou ferramenta que fale o protocolo S3 — os SDK da AWS, o disco s3 do Laravel, django-storages, boto3, rclone e muitas outras.
Adicionar armazenamento
Na aplicação, Visão geral → Serviços → Armazenamento de objetos → Adicionar armazenamento. Dê um nome ao bucket — letras latinas minúsculas, algarismos e hífenes, a começar por uma letra — e confirme. O bucket fica pronto num instante.
Um projeto pode ter até 3 buckets.
As variáveis que a sua aplicação recebe
Os dados de acesso são acrescentados automaticamente às variáveis do projeto; a aplicação passa a usá-los na publicação seguinte:
| Variável | O que é |
|---|---|
S3_ENDPOINT | o endereço do armazenamento |
S3_REGION | a região a 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 apenas para este bucket. Um segundo bucket do projeto recebe variáveis com o nome dele à frente: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET e assim por diante.
Uma variável sua com o mesmo nome mantém-se — útil se parte da aplicação tiver de continuar a usar armazenamento noutro sítio. Consulte 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 no separador 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 | 0,025 US$ por GB por mês |
| Tráfego | gratuito — as transferências a partir do armazenamento não custam nada |
| Escritas | 6 US$ por milhão de operações |
| Leituras | 0,50 US$ por milhão de operações |
O armazenamento é medido todos os dias e calculado em média ao longo do mês, por isso um ficheiro guardado durante meio mês custa metade. A utilização de cada mês civil é somada ao próximo pagamento do projeto numa única linha; não há uma subscrição separada.
Trazer ficheiros
Os ficheiros que já estão no Amazon S3, no Google Cloud Storage, noutro armazenamento compatível com S3 ou numa pasta do seu servidor podem ser movidos para um bucket — de uma só vez ou aos poucos, sem interrupções. Consulte Mover ficheiros para o armazenamento de objetos.
Eliminar um bucket
Eliminar o bucket apaga todos os ficheiros que contém; não podem ser restaurados, e as respetivas variáveis saem do projeto. A eliminação de um bucket está disponível para o titular da conta e para os Administradores da aplicação.