← Cloudflare Workers / workers / local-development

Proměnné prostředí a secrets

Uložte secrets pro použití při lokálním vývoji buď do .dev.vars soubor nebo .env soubor ve stejném adresáři jako konfigurační soubor Wrangleru.

Tyto soubory by měly být formátovány pomocí dotenv ↗ syntax. Například:

.dev.vars / .env

SECRET_KEY="value"
API_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

Chcete-li nastavit různé tajné klíče pro každé prostředí Cloudflare, vytvořte soubory s názvem .dev.vars.<environment-name> nebo .env.<environment-name>.

Když v lokálním vývoji vyberete prostředí Cloudflare, načte se nejprve soubor specifický pro dané prostředí, a to před obecným .dev.vars (nebo .env) soubor.

Při použití .dev.vars.<environment-name> soubory, všechny secrets musí být definovány pro každé prostředí zvlášť. Pokud .dev.vars.<environment-name> existuje, načte se jen ten; .dev.vars soubor se nenačte.
Naproti tomu všechny odpovídající .env soubory se načtou a hodnoty se sloučí. Pro každou proměnnou se použije hodnota z nejspecifičtějšího souboru, a to v tomto pořadí priority:
- .env.<environment-name>.local (nejvíce specifické)
- .env.local
- .env.<environment-name>
- .env (nejméně specifické)

Základní nastavení

Následující kroky ukazují, jak nastavit proměnné prostředí pro lokální vývoj pomocí .dev.vars nebo .env soubory.

Vytvořte .dev.vars / .env soubor v kořenovém adresáři projektu.

Přidejte páry klíč-hodnota:

.dev.vars/.env

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

Spusťte svůj dev příkaz

Wrangler
npx wrangler dev
Plugin Vite
npx vite dev

Více lokálních prostředí

Chcete-li simulovat různá místní prostředí, můžete poskytnout soubory specifické pro dané prostředí. Můžete mít například staging prostředí, které vyžaduje jiná nastavení než vaše vývojové prostředí.

Vytvořte soubor s názvem .dev.vars.<environment-name>/.env.<environment-name>. Můžeme například použít .dev.vars.staging/.env.staging.

Přidejte páry klíč-hodnota:

.dev.vars.staging/.env.staging

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

Zadejte prostředí při spouštění dev příkaz:

Wrangler
npx wrangler dev --env staging
Plugin Vite
CLOUDFLARE_ENV=staging npx vite dev
- Při použití .dev.vars.staging, použijí se pouze hodnoty z tohoto souboru namísto .dev.vars.
- Při použití .env.staging, hodnoty se sloučí s .env soubory, přičemž přednost má nejspecifičtější soubor.

Zjistit více

Chcete-li se dozvědět, jak nakonfigurovat více prostředí v konfiguraci Wrangleru, přečtěte si dokumentaci.
Chcete-li se dozvědět, jak společně používat prostředí Wrangleru a prostředí Vite, přečtěte si dokumentaci k Vite pluginu