← Diário de Construção

Automatizando deploy: do banco editorial ao Cloudflare Pages

Como desenhar uma esteira em que Baserow, n8n, GitHub API e Cloudflare Pages publicam um site Astro sem operação manual repetitiva.

Publicar um site estático não precisa ser um ritual manual. Se o conteúdo já está estruturado em um banco editorial, a próxima etapa natural é transformar aprovação em arquivo, arquivo em commit e commit em deploy.

Esse é o papel de uma esteira com Baserow, n8n, GitHub API e Cloudflare Pages: reduzir a publicação a um fluxo previsível, rastreável e menos dependente de ação manual.

A esteira de publicação

O fluxo começa antes do deploy. Ele começa quando uma ideia vira conteúdo aprovado.

Uma esteira simples pode seguir esta ordem:

  1. Baserow guarda a pauta, o status e os campos editoriais.
  2. n8n identifica registros aprovados.
  3. n8n monta os arquivos Markdown.
  4. A GitHub API cria ou atualiza os arquivos no repositório.
  5. Cloudflare Pages detecta o commit e publica o site.

O ponto importante é que cada ferramenta faz uma coisa. O banco organiza. O n8n orquestra. O GitHub versiona. A Cloudflare publica.

GitHub como ponto de entrega

Usar o GitHub como ponto de entrega tem uma vantagem enorme: todo conteúdo publicado vira histórico.

Se um post sai com erro, existe diff. Se uma tradução precisa ser ajustada, existe commit. Se uma automação gerar algo estranho, dá para auditar o arquivo final antes de culpar o site.

No caso de um projeto Astro, o n8n pode enviar arquivos para:

  • src/content/blog/pt
  • src/content/blog/en
  • src/content/blog/es

Cada arquivo precisa respeitar o schema da collection. Essa é a proteção contra conteúdo incompleto, metadados quebrados e páginas publicadas fora do padrão.

Cloudflare Pages como publicador

Cloudflare Pages fecha a esteira porque transforma commit em publicação. O site não precisa de servidor rodando PHP, banco de dados público ou painel administrativo exposto.

O deploy passa a ser uma consequência do versionamento. Isso muda a mentalidade: publicar deixa de ser clicar em um botão e passa a ser promover uma mudança rastreável.

Uma boa esteira de deploy não é aquela que publica qualquer coisa rápido. É aquela que publica somente o que passou por critérios claros.

Cuidados antes de automatizar

Antes de liberar uma automação para publicar sozinha, vale impor algumas travas:

  • Validar campos obrigatórios antes do commit.
  • Gerar draft: true para conteúdo que ainda precisa de revisão.
  • Conferir se o canonicalId existe nas traduções.
  • Impedir overwrite acidental de posts já publicados.
  • Registrar o resultado do deploy no banco editorial.

Automação boa não é ausência de controle. É controle codificado.

Documentação