Implantar um site estático
O armazenamento de objetos compatível com S3 também serve como hospedagem de sites estáticos. Você envia os arquivos gerados pelo build para um bucket, marca-os como de leitura pública, aponta seu domínio para a URL do bucket e tem um site estático servido por CDN por alguns centavos por mês.
Este guia leva você de um diretório dist/ já gerado (a saída de qualquer gerador de sites estáticos moderno — export do Next.js, Astro, Hugo, HTML puro) até um site no ar no seu domínio.
Pré-requisitos
- Uma conta na NimbusNexus com uma chave de API.
- Um site já gerado em um diretório local
dist/. - Um domínio que você controla (ou use um subdomínio emitido pela NimbusNexus para pular a etapa do domínio).
- O
awscliconfigurado para se comunicar com o armazenamento de objetos da NimbusNexus (ou qualquer cliente compatível com S3 —rclone,mc,s3cmd).
export NIMBUS_KEY="nn_live_xxxxxxxxxxxxxxxx"
export BUCKET="my-site"
export REGION="us-east-1"1 · Criar o bucket
curl -X POST https://api.nimbusnexus.net/v1/buckets \
-H "Authorization: Bearer $NIMBUS_KEY" \
-H "Content-Type: application/json" \
-d "{
\"name\": \"$BUCKET\",
\"region\": \"$REGION\",
\"storage_class\": \"standard\",
\"public_read\": true,
\"website\": {
\"enabled\": true,
\"index_document\": \"index.html\",
\"error_document\": \"404.html\"
}
}"O que cada opção faz:
public_read: true— qualquer pessoa na internet pode fazerGETem qualquer objeto do bucket. Obrigatório para hospedagem estática; o nome do bucket aparece nas URLs.website.enabled: true— ativa o modo de site estático. O bucket passa a servir HTML com oContent-Typecorreto, segue oindex_documentem requisições de diretório e renderiza oerror_documentem respostas 4xx.
A resposta inclui a URL do bucket:
{
"id": "bkt_01HG7Y3...",
"url": "https://my-site.s3.us-east-1.nimbusnexus.net",
"website_endpoint": "https://my-site.s3.us-east-1.nimbusnexus.net"
}2 · Configurar a CLI do S3
aws configure set aws_access_key_id $NIMBUS_KEY
aws configure set aws_secret_access_key $NIMBUS_SECRET
aws configure set region $REGION
aws configure set s3.endpoint_url https://s3.us-east-1.nimbusnexus.net$NIMBUS_SECRET é a metade secreta de uma chave de acesso compatível com S3, gerada no painel em Settings → Object Storage Keys → New key. Não a confunda com a chave de API comum — são diferentes.
3 · Enviar seu site
aws s3 sync ./dist s3://$BUCKET \
--delete \
--cache-control "public, max-age=3600" \
--endpoint-url https://s3.us-east-1.nimbusnexus.net--delete remove do bucket os arquivos que não estão mais em ./dist. --cache-control define um header de cache de 1 hora em cada objeto — longo o bastante para que os navegadores não busquem tudo de novo a cada carregamento de página e curto o bastante para que você não precise invalidar caches manualmente ao corrigir um erro de digitação.
Para arquivos que NUNCA devem ir para o cache (o seu index.html):
aws s3 cp ./dist/index.html s3://$BUCKET/index.html \
--cache-control "no-cache, max-age=0" \
--endpoint-url https://s3.us-east-1.nimbusnexus.netPadrão: cache longo nos assets com hash (/_app/[hash].js) e no-cache no HTML de entrada que faz referência a eles. É o mesmo padrão que Vercel + Netlify + Cloudflare Pages usam por baixo dos panos.
4 · Verificar se funciona
Acesse https://my-site.s3.us-east-1.nimbusnexus.net em um navegador. Você deve ver seu site.
Se aparecer XML, o endpoint do site não está roteando corretamente — na maioria das vezes porque public_read ou website.enabled não foi definido. Confira de novo a configuração do bucket:
curl https://api.nimbusnexus.net/v1/buckets/$BUCKET \
-H "Authorization: Bearer $NIMBUS_KEY"5 · Domínio próprio (opcional)
Adicione um registro DNS no seu registrador apontando seu domínio para o bucket:
www.example.com CNAME my-site.s3.us-east-1.nimbusnexus.netPara um domínio apex (example.com sem www.), CNAMEs não funcionam — registros CNAME no apex são proibidos pela RFC. Duas opções:
- Use
www.example.comcomo domínio canônico e redirecione apex → www - Adicione um registro A no apex apontando para um IP flutuante anexado a uma VM bem pequena que faz o redirecionamento (300 linhas de configuração do nginx, ~$5/mês)
Depois que o registro DNS se propagar (de 1 minuto a 24 horas, dependendo do TTL do seu registrador):
curl -X PATCH https://api.nimbusnexus.net/v1/buckets/$BUCKET \
-H "Authorization: Bearer $NIMBUS_KEY" \
-H "Content-Type: application/json" \
-d '{
"custom_domains": ["www.example.com"]
}'Isso faz o bucket aceitar requisições com Host: www.example.com e emitir um certificado TLS para esse hostname (via Let's Encrypt, com renovação automática).
6 · Montar um pipeline de deploy
O que está acima é o deploy pontual. Para CI/CD, o padrão é o mesmo aws s3 sync a partir de uma GitHub Action (ou de qualquer runner de CI):
# .github/workflows/deploy.yml (abbreviated)
- name: Deploy
run: |
aws s3 sync ./dist s3://$BUCKET --delete --endpoint-url $ENDPOINT
env:
AWS_ACCESS_KEY_ID: ${{ secrets.NIMBUS_S3_KEY }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.NIMBUS_S3_SECRET }}
BUCKET: my-site
ENDPOINT: https://s3.us-east-1.nimbusnexus.netA maioria dos sistemas de CI já tem actions de deploy compatíveis com S3; basta apontá-las para o nosso endpoint e elas funcionam sem alterações.
Custo
Armazenamento: $0,013/GB·mês na classe Standard. Um site de 50 MB custa cerca de um centavo por mês.
Egress: gratuito nos primeiros 100 GB/mês, $0,01/GB depois disso. Um site que serve 100 mil visualizações de página a 200 KB por página gera 20 GB — ainda dentro da faixa gratuita.
Em comparação com a mesma carga de trabalho no AWS CloudFront + S3: normalmente 4–6× mais barato na linha de egress e parecido na linha de armazenamento.
Próximos passos
- Referência de armazenamento de objetos — a API completa de buckets.
- Zonas DNS — hospede seu DNS diretamente na NimbusNexus em vez de no seu registrador.
- Armazenamento frio — para as partes do seu armazenamento que você quase nunca lê (artefatos de build, releases antigas).