O que wrangler faz?
Use para trabalho com a CLI Wrangler do Cloudflare: deploys, tails, KV/R2/D1/Queues/Workers, segredos, bindings e roteamento de contas.
Padrões
- Recupere primeiro as flags/config:
wrangler --help, subcomando--help,node_modules/wrangler/config-schema.jsonlocal e depois a documentação do Cloudflare. - Prefira wrapper do repositório:
npm exec --yes --package wrangler -- wrangler ...a menos que o repositório tenha seu próprio script. - Execute
wrangler whoamiantes de operações sensíveis à conta. - Conta de produção ReleaseBar:
[email protected]'s Account/de09342a728de2c25c85cc6b34d68739. - Projetos OpenClaw: use a conta OpenClaw /
91b59577e757131d68d55a471fe32aca. Pergunte se não tiver certeza.
Armadilhas
- Não invente flags de memória. O Wrangler 4 removeu/alterou algumas flags antigas; confirme com
--help. wrangler kv key listnão tem--limit; use--prefixe filtre localmente.- Executar operações serialmente (KV/list/get/admin) quando o workerd/armazenamento local iniciar; execuções paralelas podem causar
SQLITE_BUSYno SQLite. wrangler tail --sampling-ratedeve ser>0e<1; use0.999para amostragem quase completa, não1.- Pare os tails que você iniciar. Use um PTY quando a parada interativa for importante; caso contrário, mate o processo exato
wrangler tail <worker>. - Nunca imprima segredos. Consulte apenas nomes de segredos exatos; não despeje o ambiente.
Comandos Rápidos
npm exec --yes --package wrangler -- wrangler whoami
npm exec --yes --package wrangler -- wrangler deploy
npm exec --yes --package wrangler -- wrangler tail <worker> --format json --sampling-rate 0.999 --search '<termo>'
npm exec --yes --package wrangler -- wrangler kv key list --namespace-id <id> --prefix '<prefixo>'
npm exec --yes --package wrangler -- wrangler kv key get '<chave>' --namespace-id <id>
Verificação de Conta
Para configuração do repositório, leia wrangler.toml / wrangler.json(c) antes dos comandos. Se a conta configurada e o produto pretendido discordarem, pare e pergunte.