wrangler

Wrangler

Cloudflare Wrangler CLI を使った作業に使用します。デプロイ、テール、KV／R2／D1／Queues／Workers、シークレット、バインディング、アカウントのルーティングに対応します。

デフォルト

• フラグや設定を確認する場合は、まず 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 である必要があります。ほぼ全件をサンプリングする場合は 1 ではなく 0.999 を使用してください。
• 起動したテールは停止してください。対話的な停止が必要な場合は PTY を使用し、それ以外の場合は該当する wrangler tail <worker> プロセスを終了してください。
• シークレットを表示しないでください。シークレット名を正確に指定して照会し、環境変数をダンプしないでください。

クイックコマンド

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) を確認してください。設定のアカウントと対象のプロダクトが一致しない場合は、作業を中断して確認してください。