設定

Git リポジトリを Worker に接続するとき、ビルドとデプロイに必要な設定をカスタマイズできます。

接続したリポジトリにコミットが push されると、Workers Builds は次の 2 ステップを実行します。

1. ビルドコマンド （任意） — プロジェクトをコンパイルします（例: Next.js や Astro などのフレームワーク向けの npm run build）
2. デプロイコマンド — Worker を Cloudflare にデプロイします（既定は npx wrangler deploy）

プレビュービルド（本番ブランチ以外へのコミット）では、デプロイコマンドの代わりに プレビューデプロイコマンド（既定は npx wrangler versions upload）が使われます。プレビューバージョンを作成し、本番には昇格しません。

ビルド設定は、Worker 内の Settings > Build から確認できます。

ビルド設定を更新して保存すると、更新後の設定は 次の ビルドに適用されます。ビルドを 再試行 すると、再試行時点のビルド設定が適用されます。

デプロイコマンドは、任意のパッケージマネージャーで実行できます。

package.json に Wrangler のデプロイコマンドをスクリプトとして追加している場合は、それをデプロイコマンドに指定して実行できます。例: npm run deploy。

設定できるデプロイコマンドの例は次のとおりです。

非本番ブランチのデプロイコマンドは、非本番ブランチビルド を有効にしている場合にだけ適用されます。

既定は npx wrangler versions upload で、プレビュー URL を生成します。ビルドコマンドやデプロイコマンドと同様に、任意のコマンドにカスタマイズできます。

設定できる非本番ブランチのデプロイコマンドの例は次のとおりです。

リポジトリに Wrangler 設定ファイルがない場合、デプロイコマンド（wrangler deploy）は プロジェクトの自動設定 を起動します。フレームワークを検出し、必要な設定を作成して、確認用の プルリクエスト を開きます。PR をマージするとプロジェクトが設定され、以降のビルドは通常どおりデプロイされます。

Workers Builds の API トークンは、Workers Builds がアカウントのリソースにアクセスする権限を定義します。現在はユーザートークンのみ対応しており、アカウント所有トークンの対応は近日公開予定です。

Create new token を選ぶと、次の権限を持つ API トークンが自動作成されます。

• Account: Account Settings（読み取り）、Workers Scripts（編集）、Workers KV Storage（編集）、Workers R2 Storage（編集）
• Zone: アカウント上のすべてのゾーンに対する Workers Routes（編集）
• User: User Details（読み取り）、Memberships（読み取り）

この API トークンの権限は、ユーザートークンの場合 My Profile > API Tokens から設定できます。

Worker のアップロードとデプロイでは、同じ API トークンを一貫して使い、アクセス権限を揃えることを推奨します。

Cloudflare Workers では 静的アセット と フレームワーク に対応しています。Workers プロジェクトのセットアップと、各フレームワークのコマンドはフレームワークガイドで確認できます。

• Web アプリケーション
  • React + Vite
  • Astro
  • React Router（旧 Remix）
  • Next.js
  • OpenNext アダプター
  • Vue
  • RedwoodSDK
  • TanStack Start
  • SvelteKit
  • マイクロフロントエンド
  • Vike
  • その他のガイド...
    • Analog
    • Angular
    • Docusaurus
    • Gatsby
    • Hono
    • Nuxt
    • Qwik
    • Solid
    • Waku
• 既存プロジェクトのデプロイ
• モバイルアプリケーション
  • Expo
• API
  • FastAPI
  • Flask
  • Hono
• AI とエージェント
  • Agents SDK
  • LangChain

ビルドにカスタムの環境変数を渡せます。

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-worker-dev",
	"vars": {
		"API_HOST": "example.com",
		"API_ACCOUNT_ID": "example_user",
		"SERVICE_X_DATA": {
			"URL": "service-x-api.dev.example",
			"MY_ID": 123
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-worker-dev"

[vars]
API_HOST = "example.com"
API_ACCOUNT_ID = "example_user"

  [vars.SERVICE_X_DATA]
  URL = "service-x-api.dev.example"
  MY_ID = 123

次のシステム環境変数は既定で注入されます（上書きできます）。