Início
Arquitetura
Etapa 1
Etapa 2
Convenções
Regras
Custos
Ajuda
Documentação Interna

Guia de Hospedagem
de Páginas na AWS

Para equipes que precisam publicar páginas estáticas (landing pages, formulários, páginas institucionais) usando a infraestrutura AWS do Grupo Scalco.

Plataforma Amazon Web Services
CDN CloudFront + Cloudflare
Deploy via Claude Code
Visão Geral

Arquitetura

O caminho que cada requisição percorre, do navegador do usuário até os arquivos hospedados.

🌐

Usuário acessa a URL

navegador faz requisição HTTPS

🔶

Cloudflare DNS

resolve o subdomínio para o CloudFront

🟢

AWS CloudFront

CDN global + certificado SSL (ACM)

🪣

AWS S3

bucket com arquivos HTML/CSS/JS

Custo por página: ~R$3/mês para até 10.000 visitas
ETAPA 1

Configuração Inicial da Infraestrutura

Esta etapa é feita UMA VEZ por máquina. Depois de configurado, você não precisa repetir.
1
Instalar o AWS CLI

Peça ao Claude para instalar a ferramenta de linha de comando da AWS. Ele vai baixar e instalar automaticamente, confirmando a versão ao final.

Claude Code
> Instale o AWS CLI v2 na minha máquina

O Claude vai baixar e instalar automaticamente. Ao final, ele vai confirmar a versão instalada.

2
Configurar o perfil de acesso AWS

Configure o perfil SSO para a conta de marketing do Grupo Scalco.

Claude Code
> Configure o perfil MarketingAccess da conta Scalco Marketing (784608887097) na região us-east-2

O Claude vai criar o profile no arquivo ~/.aws/config com SSO configurado.

3
Fazer login na AWS

Autentique-se na AWS via SSO. Um link vai abrir no navegador para você autorizar o acesso.

Claude Code
> Faça login na AWS com o perfil MarketingAccess

O Claude vai executar o comando de login SSO. Um link vai abrir no navegador para você autorizar o acesso.

4
Solicitar o Token do Cloudflare

Solicite ao responsável de infraestrutura o token de API do Cloudflare com permissões Zone:DNS:Edit e Zone:Zone:Read. Guarde esse token em local seguro.

5
Validar tudo

Verifique se todos os acessos estão funcionando corretamente.

Claude Code
> Verifique se meu acesso AWS e Cloudflare estão funcionando

O Claude vai testar a identidade AWS e confirmar que está tudo pronto.

ETAPA 2

Solicitar Deploy de uma Página

Use este fluxo sempre que precisar publicar uma página nova ou atualizar uma existente.
Página Nova

Publicar uma nova página

1
Preparar os arquivos

Tenha sua página pronta (HTML/CSS/JS) funcionando localmente. Coloque os arquivos numa pasta dentro de sites/ no repositório, seguindo a convenção:

Estrutura
📁 sites/{nome-da-pagina}/
Exemplo: sites/formulario-rh/
2
Solicitar o deploy

Peça ao Claude e ele vai executar todo o fluxo automaticamente.

Claude Code
> Faça o deploy da página sites/{nome-da-pagina} para {nome}.gruposcalco.com.br
  • Criar o bucket S3 (scalco-lp-{nome})
  • Configurar hospedagem estática
  • Fazer upload dos arquivos
  • Solicitar certificado SSL
  • Criar registro DNS de validação no Cloudflare
  • Aguardar validação do certificado
  • Criar distribuição CloudFront
  • Apontar o DNS do subdomínio
  • Validar que tudo está funcionando
⏱️ Tempo total: 30 a 60 minutos (a maior parte é espera de validação SSL e propagação DNS).
3
Confirmar

O Claude vai informar quando a página estiver no ar e fornecer a URL final.

🔄 Atualizar página existente 3-5 min
Claude Code
> Atualize a página {nome}.gruposcalco.com.br com os arquivos de sites/{nome-da-pagina}
  • Sincronizar os arquivos atualizados no S3
  • Invalidar o cache do CloudFront
  • Confirmar que a atualização está no ar
⏪ Rollback (versão anterior)
Claude Code
> Faça rollback da página {nome}.gruposcalco.com.br para a versão anterior
  • Encontrar o último commit estável no git
  • Restaurar aquela versão
  • Refazer o deploy
Padronização

Convenções Obrigatórias

Todos os recursos seguem um padrão de nomenclatura consistente.

Recurso Padrão Exemplo
Bucket S3 scalco-lp-{nome} scalco-lp-formulario-rh
Subdomínio {nome}.gruposcalco.com.br formulario-rh.gruposcalco.com.br
Pasta no repo sites/{nome}/ sites/formulario-rh/
Atenção

Regras Importantes

Siga estas regras para evitar problemas na infraestrutura.

🔶
Cloudflare: apenas CRIAR novos registros DNS. Nunca editar ou deletar existentes.
🔴
Certificado ACM: nunca deletar o registro de validação DNS.
📍
Região S3: sempre us-east-2 (Ohio).
📍
Região ACM: sempre us-east-1 (Virginia).
🔶
Proxy Cloudflare: sempre desligado (proxied: false).
Financeiro

Estimativa de Custos

Custos estimados por página hospedada, baseados no volume de tráfego mensal.

1.000 visitas/mês
~R$3
por mês
10.000 visitas/mês
~R$25
por mês
100.000 visitas/mês
~R$250
por mês
Suporte

Precisa de ajuda?

Recursos e contatos para quando você precisar de suporte adicional.

📖

Playbook Técnico

Documentação completa do fluxo de deploy em tech/infrastructure/lp-deploy-playbook.md

🔑

Acesso AWS (SSO)

Solicitar ao responsável de TI a criação de usuário e vinculação ao SSO da conta Scalco Marketing.

🛡️

Token Cloudflare

Solicitar ao responsável de infraestrutura o token de API com permissões DNS.