環境変数とシークレット

ローカル開発で使うシークレットは、Wrangler 設定ファイルと同じディレクトリの .dev.vars または .env に置きます。

これらのファイルは dotenv ↗ の構文で記述します。例:

.dev.vars / .envbash

SECRET_KEY="value"
API_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

Cloudflare 環境ごとに異なるシークレットを設定するには、.dev.vars.<environment-name> または .env.<environment-name> という名前のファイルを作成します。

ローカル開発で Cloudflare 環境を選ぶと、対応する環境固有のファイルが、汎用の .dev.vars（または .env）より先に読み込まれます。

.dev.vars.<environment-name> を使う場合、すべてのシークレットを環境ごとに定義する必要があります。.dev.vars.<environment-name> が存在すると、そのファイルだけが読み込まれ、.dev.vars は読み込まれません。
一方、一致する .env ファイルはすべて読み込まれ、値がマージされます。各変数には、もっとも具体的なファイルの値が使われます。優先順位は次のとおりです。
- .env.<environment-name>.local（もっとも具体的）
- .env.local
- .env.<environment-name>
- .env（もっとも汎用）

.dev.vars または .env ファイルを使って、ローカル開発用の環境変数を設定する手順です。

キーと値のペアを追加します。

.dev.vars/.envini

API_HOST="localhost:3000"
DEBUG="true"
SECRET_TOKEN="my-local-secret-token"

複数のローカル環境

ローカル環境を切り替えたい場合は、環境ごとのファイルを用意できます。たとえば、開発環境とは異なる設定が必要な staging 環境がある場合です。

.dev.vars.<environment-name> / .env.<environment-name> という名前のファイルを作成します。例として .dev.vars.staging / .env.staging を使えます。

キーと値のペアを追加します。

.dev.vars.staging/.env.stagingini

API_HOST="staging.localhost:3000"
DEBUG="false"
SECRET_TOKEN="staging-token"