1001Ferramentas
☁️Dev

Gerador Cloudflare wrangler.toml

Gera um wrangler.toml para Cloudflare Workers, com nome, data de compatibilidade, variáveis de ambiente e um namespace KV. As rotas você acrescenta à mão.



  

wrangler.toml mínimo de Worker, explicado

O wrangler.toml diz ao Cloudflare qual arquivo é o seu Worker, com que nome ele sobe e a quais recursos tem acesso. Quem está começando costuma tropeçar no compatibility_date e nos bindings: sem eles, ou com o id de KV errado, o wrangler deploy para com erro. Esta página mostra um arquivo mínimo de Worker com nome, entrada, data de compatibilidade, uma variável e um binding de KV.

A página não tem campos: o TOML é fixo, já vem renderizado ao carregar e o botão só o redesenha. Duas ressalvas honestas. Isto é configuração de Workers, não de Pages, e projeto Pages usa pages_build_output_dir e outra estrutura. E, apesar do que a descrição da ferramenta afirma, não existe chave routes na saída; se precisar de domínio próprio, acrescente routes ou route por conta.

Troque your-kv-namespace-id pelo id real, que o comando wrangler kv namespace create CACHE devolve, ou apague o bloco [[kv_namespaces]] inteiro, porque só o placeholder já derruba o deploy. Atualize compatibility_date para a data de hoje em projeto novo; o valor de 2024 prende o runtime a comportamento antigo. E não guarde token em [vars], que vai versionado: use wrangler secret put. Gerado localmente no navegador.

Perguntas frequentes

Serve para Cloudflare Pages?
Do jeito que sai, não. É configuração de Worker; um projeto Pages usa pages_build_output_dir e chaves de build, e o main não significa nada por lá.
O que acontece se eu deixar o id do KV como está?
O deploy é recusado, porque o Cloudflare valida o namespace. Crie o namespace pela CLI e cole o id real, ou remova o bloco se você não usa KV.
Posso usar wrangler.jsonc em vez de TOML?
Pode. Versões recentes do wrangler aceitam JSON e JSONC com as mesmas chaves; o TOML continua funcionando e é o formato que esta página emite.

Ferramentas Relacionadas