CRM Docs

CloudFront

CDN global para conteúdo estático e cache de origem

O Amazon CloudFront é a CDN (Content Delivery Network) da AWS: replica conteúdo em edge locations perto do usuário, reduz latência e carga na origem (S3 ou ALB).

Quando usar no CRM

CenárioOrigem CloudFrontBenefício
Painel SPA / assetsS3 ou AmplifyJS/CSS/imagens carregam mais rápido no Brasil e exterior
Downloads públicosS3 com OACMenos tráfego direto no bucket
API com cache seletivoALBSó se endpoints forem idempotentes e cacheáveis (cuidado)

A API dinâmica do CRM normalmente não deve ser cacheada agressivamente sem políticas explícitas de Cache-Control.

Distribuição: peças principais

ComponenteFunção
DistributionConfiguração global (domínio, certificado, behaviors)
OriginS3 bucket, ALB, custom HTTP
BehaviorPath pattern → qual origin, métodos, TTL de cache
Cache policyO que entra no cache (headers, query strings, cookies)
Origin request policyO que repassa à origem
Response headers policyCORS, security headers (HSTS, CSP)

Cache: o que importa

ConfiguraçãoImpacto
TTL mínimo/default/máximoTempo no edge antes de revalidar
Query stringsIncluir na chave de cache só o necessário (ex. ?v=hash)
CookiesIncluir cookies na chave fragmenta cache — evite em assets públicos
Invalidation/* após deploy de frontend — custo por path

Para SPA em S3, behavior comum:

PathOriginCache
/static/*S3Longo (1 ano com hash no filename)
/*S3 index.htmlCurto ou sem cache para HTML

HTTPS e domínio customizado

ItemDetalhe
CertificadoACM na região us-east-1 (requisito CloudFront)
Alternate domain (CNAME)app.exemplo.com na distribution
DNSRoute 53 alias para a distribution

S3 privado + Origin Access Control (OAC)

Sem OACCom OAC
Bucket público ou URLs vazandoApenas CloudFront lê objetos; Block Public Access ativo

Fluxo: usuário → CloudFront (assinatura) → S3; acesso direto ao bucket negado.

Erros comuns

SintomaCausa
SPA roteamento 404 em refreshFalta custom error 403/404 → /index.html
Asset antigo após deployCache TTL alto sem invalidation ou sem hash no filename
CORS no browserResponse headers policy ou CORS no S3/origem inconsistentes
API retorna dado velhoBehavior cacheando GET indevidamente

Preço (visão)

  • Cobrança por tráfego de saída (data transfer out) e requisições por edge.
  • Origem S3 na mesma região reduz custo de pull origin.

Relação com outros serviços

ServiçoRelação
S3Origem mais comum para estáticos
Route 53Aponta domínio para distribution
ALBOrigem opcional para APIs
AmplifyPode usar CloudFront gerenciado pelo Amplify

On this page