¿Qué hace wrangler?
Usa para trabajo con el CLI de Cloudflare Wrangler: despliegues, tails, KV/R2/D1/Queues/Workers, secretos, bindings y enrutamiento de cuentas.
Valores por defecto
- Recupera primero los flags/config:
wrangler --help,--helpdel subcomando,node_modules/wrangler/config-schema.jsonlocal, luego la documentación de Cloudflare. - Prefiere el wrapper del repositorio:
npm exec --yes --package wrangler -- wrangler ...a menos que el repositorio tenga su propio script. - Ejecuta
wrangler whoamiantes de trabajo que involucre la cuenta. - Cuenta de producción de ReleaseBar:
[email protected]'s Account/de09342a728de2c25c85cc6b34d68739. - Proyectos OpenClaw: usa la cuenta de OpenClaw /
91b59577e757131d68d55a471fe32aca. Pregunta si no estás seguro.
Trampas
- No inventes flags de memoria. Wrangler 4 eliminó/cambió algunos flags antiguos; confírmalos con
--help. wrangler kv key listno tiene--limit; usa--prefixy filtra localmente.- Ejecuta lecturas de Wrangler KV/list/get/admin en serie cuando workerd/almacenamiento local se inicia; ejecuciones paralelas pueden encontrar
SQLITE_BUSY. wrangler tail --sampling-ratedebe ser>0y<1; usa0.999para muestreo casi completo, no1.- Detén los tails que inicies. Usa una PTY cuando la parada interactiva sea importante; de lo contrario, mata el proceso exacto de
wrangler tail <worker>. - Nunca imprimas secretos. Consulta solo los nombres exactos de los secretos; no vuelques el entorno.
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 '<término>'
npm exec --yes --package wrangler -- wrangler kv key list --namespace-id <id> --prefix '<prefijo>'
npm exec --yes --package wrangler -- wrangler kv key get '<clave>' --namespace-id <id>
Verificación de cuenta
Para la configuración del repositorio, lee wrangler.toml / wrangler.json(c) antes de los comandos. Si la cuenta de configuración y el producto previsto no coinciden, detente y pregunta.