← Cloudflare Workers / workers / vite-plugin / reference

Cloudflare Environments

Konfigurační soubor Workeru může obsahovat konfiguraci pro více prostředí Cloudflare. Pomocí pluginu Cloudflare pro Vite vyberete prostředí Cloudflare v době vývoje nebo sestavení tak, že zadáte CLOUDFLARE_ENV proměnná prostředí. Podívejte se na následující příklad konfiguračního souboru Workeru:

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"main": "./src/index.ts",
	"vars": {
		"MY_VAR": "Top-level var"
	},
	"env": {
		"staging": {
			"vars": {
				"MY_VAR": "Staging var"
			}
		},
		"production": {
			"vars": {
				"MY_VAR": "Production var"
			}
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
main = "./src/index.ts"

[vars]
MY_VAR = "Top-level var"

[env.staging.vars]
MY_VAR = "Staging var"

[env.production.vars]
MY_VAR = "Production var"

Pokud spustíte CLOUDFLARE_ENV=production vite build pak výstup wrangler.json soubor vygenerovaný sestavením bude zploštělou konfigurací pro prostředí Cloudflare 'production', jak ukazuje následující příklad:

{
	"name": "my-worker",
	"compatibility_date": "2025-04-03",
	"main": "index.js",
	"vars": { "MY_VAR": "Production var" }
}

Všimněte si, že hodnota MY_VAR je Production var. Tato zploštělá konfigurace kombinuje pouze na nejvyšší úrovni, zděditelný, a nedědičné klíče.

Prostředí Cloudflare lze použít i při vývoji. Můžete například spustit CLOUDFLARE_ENV=development vite dev. Běžně se výchozí prostředí nejvyšší úrovně používá jako vývojové prostředí a podle potřeby se pak přidávají další prostředí.

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:

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é)

Můžete zkombinovat koncepty prostředí Cloudflare a Režimy Vite ↗. Při tomto přístupu lze pomocí režimu Vite vybrat prostředí Cloudflare a jedinou metodou určit konfiguraci a kód specifické pro dané prostředí. Vraťme se znovu k předchozímu příkladu:

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"main": "./src/index.ts",
	"vars": {
		"MY_VAR": "Top-level var"
	},
	"env": {
		"staging": {
			"vars": {
				"MY_VAR": "Staging var"
			}
		},
		"production": {
			"vars": {
				"MY_VAR": "Production var"
			}
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-worker"
# Set this to today's date
compatibility_date = "2026-08-28"
main = "./src/index.ts"

[vars]
MY_VAR = "Top-level var"

[env.staging.vars]
MY_VAR = "Staging var"

[env.production.vars]
MY_VAR = "Production var"

Dále zadejte .env.staging a .env.production soubory:

CLOUDFLARE_ENV=staging

CLOUDFLARE_ENV=production

Standardně vite build používá režim Vite 'production'. Vite proto načte .env.production soubor a získejte proměnné prostředí použité při sestavení. Jelikož .env.production soubor obsahuje CLOUDFLARE_ENV=production, zásuvný modul Cloudflare Vite vybere prostředí Cloudflare 'production'. Hodnota MY_VAR proto bude 'Production var'. Pokud spustíte vite build --mode staging pak se použije režim Vite „staging“ a vybere se prostředí Cloudflare „staging“. Hodnota MY_VAR proto bude 'Staging var'.

Více informací o používání .env soubory s Vite, přečtěte si příslušná dokumentace ↗.