wrangler 是做什么的?
用于 Cloudflare Wrangler CLI 相关工作:部署、日志追踪、KV/R2/D1/Queues/Workers、Secrets、绑定以及账户路由。
默认行为
- 优先通过检索获取标志/配置:
wrangler --help、子命令--help、本地node_modules/wrangler/config-schema.json,然后才是 Cloudflare 文档。 - 优先使用仓库包装器:
npm exec --yes --package wrangler -- wrangler ...,除非仓库有自己的脚本。 - 执行涉及账户的操作前先运行
wrangler whoami。 - ReleaseBar 生产账户:
[email protected]'s Account/de09342a728de2c25c85cc6b34d68739。 - OpenClaw 项目:使用 OpenClaw 账户 /
91b59577e757131d68d55a471fe32aca。如果不确定请询问。
陷阱
- 不要凭记忆编造标志。Wrangler 4 移除/更改了一些旧标志;请用
--help确认。 wrangler kv key list没有--limit参数;请使用--prefix并在本地过滤。- 当 workerd/本地存储启动时,请串行执行 Wrangler KV/list/get/admin 读取操作;并行运行可能触发 SQLite 的
SQLITE_BUSY错误。 wrangler tail --sampling-rate必须>0且<1;使用0.999实现接近完全的采样,不要使用1。- 停止你启动的 tail。当需要交互式停止时使用 PTY;否则准确杀死
wrangler tail <worker>进程。 - 永远不要打印 Secrets。只查询确切的 Secret 名称;不要转储环境。
快速命令
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 '<term>'
npm exec --yes --package wrangler -- wrangler kv key list --namespace-id <id> --prefix '<prefix>'
npm exec --yes --package wrangler -- wrangler kv key get '<key>' --namespace-id <id>
账户检查
对于仓库配置,在执行命令前先读取 wrangler.toml / wrangler.json(c)。如果配置中的账户与预期产品不一致,请停止并询问。