~/VibeHandbook
PDF grátis

Cloudflare

developers.cloudflare.com

Cloudflare Workers

O que é

Pense em uma rede de cafeterias que usam a mesma receita em todas as cidades, de modo que, onde quer que você esteja, você pega seu pedido na unidade mais próxima. O Cloudflare Workers funciona da mesma forma: ele permite rodar JavaScript, TypeScript ou WebAssembly na rede global da Cloudflare — mais de 300 cidades — em vez de em uma única região. Cada requisição roda em um mini-ambiente minúsculo e isolado chamado V8 isolate. Ele inicia em bem menos de um milissegundo, então na prática não existe cold start (o aquecimento lento da primeira requisição). Você escreve um handler de fetch, faz o com um único comando, e seu código roda automaticamente perto de cada usuário.

Pontos fortes

  • Cold starts praticamente inexistentes graças aos V8 isolates em vez de containers completos.
  • Global por padrão — seu código é implantado em todos os locais da Cloudflare de uma vez.
  • Camada gratuita generosa; você paga por requisição e por tempo de CPU, não por tempo ocioso.
  • Bindings (conexões prontas) de primeira classe para D1 (um banco de dados ), R2 (armazenamento de arquivos), KV (um armazenamento chave-valor, como um dicionário gigante de pares rótulo-valor), Queues, Durable Objects e Workers AI.
  • Uma única (ferramenta de linha de comando na qual você digita comandos) chamada wrangler cuida do desenvolvimento, dos segredos e do deploy.

Desvantagens

  • O runtime não é o Node.js — muitos pacotes npm com dependências nativas ou de sistema de arquivos não funcionam, embora a compatibilidade com Node esteja melhorando.
  • O tempo de CPU e a memória por requisição têm limites, então computação pesada não é uma boa opção.
  • Não há disco local nem estado persistente dentro do processo; em vez disso, você recorre aos bindings.
  • A execução distribuída torna a depuração passo a passo entre regiões mais difícil.

Quando usar

Recorra ao Workers quando você quiser uma (Application Programming Interface — Interface de Programação de Aplicações, o conjunto de endpoints que outros softwares chamam para conversar com o seu app) rápida e distribuída globalmente, middleware de borda (), verificações de autenticação, redirecionamentos, handlers de , ou um full-stack que se apoie nos bindings de armazenamento e IA da Cloudflare.

Encaixe no vibe coding

O Workers é um dos destinos de deploy mais amigáveis para codificação guiada por IA: o projeto é um único arquivo de configuração mais um handler, e um agente consegue montar a estrutura, conectar serviços e fazer o deploy de ponta a ponta. Avise o agente desde o início que o alvo é o Workers (não o Node), para que ele respeite os limites do runtime e use bindings em vez de, por exemplo, fs. O exemplo abaixo conecta um Worker a um namespace do KV.

# wrangler.toml
name = "my-worker"
main = "src/index.ts"
compatibility_date = "2026-06-01"

[[kv_namespaces]]
binding = "CACHE"
id = "your-kv-namespace-id"
npx wrangler dev      # local edge runtime
npx wrangler deploy   # ship to the global network