カスタムビルド

カスタムビルドは、Wrangler が処理する前にコードのコンパイル方法をカスタマイズする仕組みです。

カスタムビルドは、Wrangler 設定ファイル に [build] セクションを追加し、次のオプションで設定します。

• command string optional

  • Worker のビルドに使うコマンドです。Linux と macOS では sh シェル、Windows では cmd シェルで実行されます。シェル演算子の && と || も使えます。このコマンドは wrangler dev と npx wrangler deploy の一部として実行されます。

• cwd string optional

  • コマンドを実行するディレクトリです。

• watch_dir string | string\[] optional

  • wrangler dev 使用時に変更を監視するディレクトリです。デフォルトは現在の作業ディレクトリです。

例:

{
	"build": {
		"command": "npm run build",
		"cwd": "build_cwd",
		"watch_dir": "build_watch_dir"
	}
}

[build]
command = "npm run build"
cwd = "build_cwd"
watch_dir = "build_watch_dir"

Wrangler がカスタムビルドコマンドを実行するとき、環境変数 WRANGLER_COMMAND を設定します。ビルドスクリプトは、どの Wrangler コマンドがビルドを起動したかを判別できます。デプロイの文脈に応じてビルド処理を変えられます。

取りうる値は次のとおりです。

たとえば、開発と本番で異なるビルド設定を適用できます。

#!/bin/bash
if [ "$WRANGLER_COMMAND" = "dev" ]; then
  echo "Building for development..."
  # run a development build
else
  echo "Building for production..."
  # run a production build
fi