AWS S3: guia para armazenar arquivos e imagens nos seus projetos

Faaala, dev! Tudo na paz?

O que é o Amazon S3 e por que ele vai impulsionar seus projetos?

Principais benefícios na prática

• Durabilidade e segurança: a AWS projeta o S3 para ter 99,999999999% de durabilidade. Na prática, isso significa que se você armazenar 10.000 arquivos, pode esperar perder um único arquivo a cada 10 milhões de anos. É mais fácil um meteoro atingir a Terra do que você perder um arquivo!

• Custo-benefício: armazenar dados no S3 é incrivelmente barato, custando centavos por gigabyte por mês. Isso o torna perfeito para seu projeto pessoal ou até para uma startup que está começando.

• Escalabilidade: seu projeto bombou e agora tem milhões de arquivos? Sem problemas! O S3 cresce com você, sem que você precise se preocupar em gerenciar servidores ou comprar mais espaço.

Seu primeiro bucket no S3 em 4 passos

Passo 1: acessando o console da AWS

Passo 2: criando seu primeiro bucket

1. Nome do bucket: precisa ser um nome único no mundo todo (pense nele como um domínio de site). Uma boa prática é usar o nome do seu projeto, como meu-app-rocketseat-uploads.

2. Região da AWS: escolha a região mais próxima dos seus usuários para diminuir a latência. Para o Brasil, sa-east-1 (São Paulo) é a melhor escolha.

Passo 3: configurando o acesso público com uma Bucket Policy

1. Dentro do seu bucket, vá para a aba "Permissões".

2. Role para baixo até "Política de bucket" e clique em "Editar".

3. Cole o JSON abaixo. Ele diz: "Permita que qualquer pessoa ("Principal": "*" ) execute a ação de ler objetos ("Action": "s3:GetObject") neste bucket específico".

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::SEU-BUCKET/*"
        }
    ]
}

Passo 4: fazendo seu primeiro upload manual

Bora codar! Exemplo de upload com Node.js

Configurando as credenciais de acesso (IAM)

1. No IAM, vá em "Políticas" e "Criar política".

2. Vá para a aba JSON e cole o seguinte código, substituindo SEU-BUCKET pelo nome do seu bucket:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::SEU-BUCKET/*"
    }
  ]
}

O snippet de código: subindo um arquivo na prática

npm install @aws-sdk/client-s3

// Importa o cliente S3 e o comando de upload
import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
import 'dotenv/config'; // Para carregar variáveis de ambiente

// Configura o cliente S3 com suas credenciais e região
const s3Client = new S3Client({
  region: process.env.AWS_REGION,
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
  },
});

async function uploadArquivo(fileContent, fileName) {
  const params = {
    Bucket: process.env.AWS_BUCKET_NAME, // O nome do seu bucket
    Key: fileName,                        // O nome do arquivo no S3
    Body: fileContent,                    // O conteúdo do arquivo
  };

  try {
    const command = new PutObjectCommand(params);
    const result = await s3Client.send(command);
    
    // Constrói a URL pública do arquivo (formato virtual-hosted-style)
    const url = `https://${params.Bucket}.s3.${process.env.AWS_REGION}.amazonaws.com/${params.Key}`;
    
    console.log(`Arquivo enviado com sucesso! Acessível em: ${url}`);
    
    // Exemplo de uso com um dev da Rocketseat
    const dev = {
        nome: "Laís",
        fotoUrl: url
    }

    return { dev, result };
  } catch (error) {
    console.error("Erro detalhado no upload:", error);
    throw error; // Repassa o erro para tratamento em um nível superior
  }
}

Como o S3 se conecta com o resto do universo AWS?

1. Sua API (o código) roda em um servidor virtual EC2.

2. Quando uma pessoa usuária faz o upload de uma foto, a API no EC2 não guarda a imagem no seu próprio disco. Em vez disso, ela executa um código como o que vimos acima e envia o arquivo diretamente para um bucket no S3.

3. O S3 retorna a URL pública da imagem.

4. Finalmente, sua API pega as informações do post (a legenda e a URL da imagem no S3) e salva tudo em um banco de dados gerenciado pelo RDS.

Seu próximo deploy está mais perto do que você imagina!