~/VibeHandbook
PDF grátis

Infraestrutura

developers.cloudflare.com

Edge Functions

O que é

Pense em uma rede de pizzarias com uma filial em cada bairro: seu pedido é feito na loja mais próxima de você, então chega quente e rápido, em vez de ser transportado por todo o país. "The " ("a borda") se refere a esses locais próximos. Edge functions (funções de borda) são pequenos trechos de código que rodam em servidores espalhados pelo mundo todo, fisicamente perto de quem está usando o seu app. Em vez de cada requisição viajar até um único data center distante, ela é executada no local mais próximo, então as respostas voltam rápido. Você escreve a função, e a plataforma cuida de onde e quando ela roda.

Pontos fortes

  • Latência muito baixa — o código roda perto do usuário, geralmente em questão de milissegundos.
  • Escala automaticamente para tráfegos enormes, sem servidores para você gerenciar.
  • Barato para cargas de trabalho típicas; você geralmente paga por requisição.
  • Ótimo para personalização, redirecionamentos, verificações de autenticação e APIs (Application Programming Interfaces — Interfaces de Programação de Aplicações — os endpoints que outros softwares chamam para conversar com o seu app) leves.
  • Nenhuma infraestrutura para corrigir ou manter no ar.

Contrapartidas

  • Limites rígidos: tempo de execução curto, memória pequena e tamanho de pacote limitado.
  • Runtime (ambiente de execução) limitado — muitas bibliotecas e módulos nativos do Node.js não funcionam.
  • Sem armazenamento local persistente ou conexões de longa duração; você depende de bancos de dados externos.
  • Mais difícil de depurar, porque a lógica fica distribuída por muitos locais.
  • Trabalho pesado de CPU (processamento de imagens, cálculos grandes) não é uma boa combinação.

Quando usar

Recorra a edge functions quando precisar de respostas rápidas e distribuídas globalmente para tarefas pequenas: testes A/B, geolocalização, reescrita de requisições, validação de tokens ou camadas de finas na frente de um banco de dados.

Encaixe com vibe coding

Este é um dos alvos mais amigáveis para deixar a IA cuidar da fiação. Plataformas como Cloudflare Workers, Vercel e Deno usam arquivos de configuração simples, e um agente de IA pode montar a função, escrever a configuração de deploy e rodar a (command-line tool — ferramenta de linha de comando) para você do início ao fim. Dica: diga ao agente qual é a sua plataforma logo de início (por exemplo, "Cloudflare Workers") para que ele gere o formato de configuração correto e respeite os limites de runtime daquela plataforma — caso contrário, ele pode presumir Node.js completo e produzir código que falha na hora do deploy.

# wrangler.toml — Cloudflare Workers edge function
name = "my-edge-app"
main = "src/index.js"
compatibility_date = "2026-06-01"

[vars]
GREETING = "hello from the edge"
# Deploy and tail logs
npx wrangler deploy
npx wrangler tail