wrangler

Wrangler の使用

Version: 4.59.2+（2026年1月）。設定形式には .toml より wrangler.jsonc を推奨します。

クイックスタート

# Create new project
npx create-cloudflare@latest my-worker

# Local dev
wrangler dev

# Deploy
wrangler deploy

# View logs
wrangler tail

正確なプロンプト — Worker をデプロイする

Deploy Worker to Cloudflare:
1. Check wrangler.jsonc exists with name, main, compatibility_date
2. wrangler deploy (auto-provisions KV/R2/D1 bindings if IDs missing)
3. wrangler tail to verify

主なコマンド

タスク	コマンド
ローカル開発	wrangler dev
デプロイ	wrangler deploy
ログを表示	wrangler tail
シークレットを追加	wrangler secret put NAME
シークレットを一覧表示	wrangler secret list
型を生成	wrangler types
設定を確認	wrangler check startup

設定（wrangler.jsonc）

{
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2025-01-01",

  // Routes
  "routes": [
    { "pattern": "example.com/*", "zone_name": "example.com" }
  ],

  // Bindings (IDs optional - auto-provisioned on deploy)
  "kv_namespaces": [{ "binding": "KV", "id": "..." }],
  "r2_buckets": [{ "binding": "BUCKET", "bucket_name": "my-bucket" }],
  "d1_databases": [{ "binding": "DB", "database_id": "..." }],

  // Environment variables
  "vars": { "ENV": "production" }
}

自動プロビジョニング（v4.57+）

ID を指定せずにバインディングを追加できます — Wrangler がデプロイ時にリソースを作成します。

{
  "kv_namespaces": [{ "binding": "CACHE" }],  // No id - auto-created
  "r2_buckets": [{ "binding": "ASSETS" }],    // No bucket_name - auto-created
  "d1_databases": [{ "binding": "DB" }]       // No database_id - auto-created
}

非公開／実験的なフラグ

フラグ	用途
--x-provision	リソースの自動プロビジョニングを強制する
--x-auto-create	新しいリソースとともにバインディングを自動作成する
--x-autoconfig	フレームワーク（Next.js、Remix など）を自動検出する

環境変数

変数	用途
CLOUDFLARE_API_TOKEN	CI/CD の認証
CLOUDFLARE_ACCOUNT_ID	アカウントを上書き

判断フロー

What to do?
├─ New project → npx create-cloudflare@latest
├─ Local dev → wrangler dev
├─ Deploy → wrangler deploy
├─ Add secret → wrangler secret put NAME
├─ View logs → wrangler tail
├─ Database ops → wrangler d1 ...
├─ Storage ops → wrangler r2 ... or wrangler kv ...
└─ Scheduled jobs → Add [triggers] to config

よくあるパターン

シークレットを追加する

wrangler secret put API_KEY
# Enter value when prompted (or pipe: echo "value" | wrangler secret put API_KEY)

複数の環境

{
  "name": "my-worker",
  "env": {
    "staging": {
      "vars": { "ENV": "staging" },
      "routes": [{ "pattern": "staging.example.com/*" }]
    },
    "production": {
      "vars": { "ENV": "production" },
      "routes": [{ "pattern": "example.com/*" }]
    }
  }
}

wrangler deploy --env staging
wrangler deploy --env production

D1 データベース

wrangler d1 create my-db
wrangler d1 execute my-db --file schema.sql
wrangler d1 execute my-db --command "SELECT * FROM users"

R2 ストレージ

wrangler r2 bucket create my-bucket
wrangler r2 object put my-bucket/file.txt --file ./local.txt
wrangler r2 object get my-bucket/file.txt

---

AGENTS.md の説明

これをプロジェクトの AGENTS.md にコピーします。

### Cloudflare Wrangler

Wrangler is installed and authenticated.

R2 bucket: `<BUCKET_NAME>`
Account ID: `<ACCOUNT_ID>`

Common commands:

\`\`\`bash
wrangler r2 object put <BUCKET>/<path> --file ./local-file
wrangler r2 object get <BUCKET>/<path> --file ./downloaded
wrangler r2 bucket list
wrangler d1 execute <DB> --command "SELECT * FROM users"
wrangler deploy
\`\`\`

---

リファレンス一覧

トピック	リファレンス
すべてのコマンド	COMMANDS.md
設定オプション	CONFIG.md
Pages のデプロイ	PAGES.md

注意点

• ダッシュボードの変更が上書きされる： ダッシュボードでの編集を保持するには "keep_vars": true を追加します
• 設定にシークレットを記載しない： wrangler secret put を使用し、設定にはシークレットを記載しないでください
• 型が古い： 設定を変更した後に wrangler types を実行します
• 古い compatibility_date： 新機能を利用するため、毎年更新します

参照元

• リポジトリ：cloudflare/workers-sdk @ v4.59.2
• ドキュメント：developers.cloudflare.com/workers/wrangler