システム環境変数

システム環境変数は、Wranglerの動作を変更できるローカル環境変数です。システム環境変数を設定する方法は3つあります。

1. プロジェクトディレクトリに.envファイルを作成します。環境変数の値を.envファイルに設定します。これは、Wranglerセッション間で値を持続させるため、これらの変数を設定する推奨方法です。

2. Wranglerコマンドに値をインラインで設定します。例えば、WRANGLER_LOG="debug" npx wrangler deployは、このコマンドの実行に対してWRANGLER_LOGの値を"debug"に設定します。

3. シェル環境に値を設定します。例えば、Zシェルを使用している場合、~/.zshrcファイルにexport CLOUDFLARE_API_TOKEN=...を追加すると、このトークンがシェル設定の一部として設定されます。

サポートされている環境変数

Wranglerは以下の環境変数をサポートしています：

• CLOUDFLARE_ACCOUNT_ID string optional

  • Workers関連アカウントのアカウントID。

• CLOUDFLARE_API_TOKEN string optional

  • CloudflareアカウントのAPIトークン、CI/CDやその他の自動化のための認証に使用できます。

• CLOUDFLARE_API_KEY string optional

  • CloudflareアカウントのAPIキー、通常はCLOUDFLARE_EMAIL=を使用した古い認証方法に使用されます。

• CLOUDFLARE_EMAIL string optional

  • Cloudflareアカウントに関連付けられたメールアドレス、通常はCLOUDFLARE_API_KEY=を使用した古い認証方法に使用されます。

• WRANGLER_SEND_METRICS string optional

  • これに対するオプションはtrueとfalseで、デフォルトの動作はfalseです。

• WRANGLER_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING_NAME> string optional

  • Hyperdriveを使用したローカル開発のためのローカル接続文字列。例えば、HyperdriveのバインディングがPROD_DBと名付けられている場合、これはWRANGLER_HYPERDRIVE_LOCAL_CONNECTION_STRING_PROD_DB="postgres://user:password@127.0.0.1:5432/testdb"となります。各Hyperdriveはバインディング名によって一意に識別されます。

• CLOUDFLARE_API_BASE_URL string optional

  • デフォルト値は"https://api.cloudflare.com/client/v4"です。

• WRANGLER_LOG string optional

  • ロギングレベルのオプションは"none"、"error"、"warn"、"info"、"log"、および"debug"です。レベルは大文字小文字を区別せず、デフォルトは"log"です。無効なレベルが指定された場合、Wranglerはデフォルトにフォールバックします。

• FORCE_COLOR string optional

  • これを0に設定することで、Wranglerのカラフルな出力を無効にでき、特定のターミナル設定で読みやすくなります。例えば、FORCE_COLOR=0。

例 .env ファイル

以下は例の.envファイルです：

CLOUDFLARE_ACCOUNT_ID=<YOUR_ACCOUNT_ID_VALUE>
CLOUDFLARE_API_TOKEN=<YOUR_API_TOKEN_VALUE>
CLOUDFLARE_EMAIL=<YOUR_EMAIL>
WRANGLER_SEND_METRICS=true
CLOUDFLARE_API_BASE_URL=https://api.cloudflare.com/client/v4
WRANGLER_LOG=debug

廃止されたグローバル変数

以下の変数は廃止されています。問題や不要なメッセージを防ぐために、上記の新しい変数を使用してください。

• CF_ACCOUNT_ID
• CF_API_TOKEN
• CF_API_KEY
• CF_EMAIL
• CF_API_BASE_URL