Skip to content
Latchkey

O Que É Static Site Generation? HTML Construído em Tempo de Build

A static site generation (SSG) renderiza todas as suas páginas em HTML durante o build, para que um CDN possa servir arquivos puros sem trabalho de servidor por requisição.

Em vez de renderizar páginas a cada requisição como o SSR, o SSG as renderiza uma vez em tempo de build. A saída é uma pasta de HTML, CSS, JS e assets estáticos que qualquer CDN consegue servir. É rápido, barato e seguro, e se encaixa perfeitamente em um pipeline de CI cujo trabalho é justamente transformar a fonte em arquivos deployáveis.

Como o SSG funciona

Durante o build, o gerador executa o código de cada página para cada rota, busca os dados necessários e escreve o HTML finalizado no disco. Não há servidor de app em runtime; o CDN apenas retorna arquivos.

SSG vs SSR

O SSR renderiza por requisição, então o conteúdo está sempre atual, mas cada requisição custa tempo de servidor. O SSG renderiza uma vez no build, então servir é gratuito e instantâneo, mas o conteúdo fica congelado até o próximo build. O SSG combina com conteúdo que não muda a cada segundo.

Pontos fortes da saída estática

  • Servida por qualquer CDN sem um servidor em execução.
  • Muito rápida e barata, com uma superfície de ataque mínima.
  • Trivialmente cacheável e distribuível globalmente.

O limite de atualização

Como as páginas são geradas em tempo de build, novo conteúdo exige um rebuild e um redeploy. Para sites com milhares de páginas, rebuilds completos podem ficar lentos, que é exatamente o problema que as abordagens incrementais resolvem.

SSG no CI/CD

O SSG é o modo de renderização mais nativo de CI: o pipeline roda o gerador, produz uma pasta estática e a envia para um CDN ou host estático. O tempo de build cresce com a quantidade de páginas, então cachear as buscas de dados e reconstruir apenas as páginas alteradas mantém os pipelines rápidos.

Principais conclusões

  • O SSG renderiza todas as páginas em HTML estático em tempo de build, sem servidor por requisição.
  • É rápido, barato e seguro, mas o conteúdo fica congelado até o próximo build.
  • É o modo mais nativo de CI: build para uma pasta, upload para um CDN.

Guias relacionados