← Cloudflare Durable Objects / durable-objects / reference

Prostředí

Prostředí poskytují izolovaný prostor, ve kterém váš kód běží s konkrétními závislostmi a konfigurací. To se hodí z několika důvodů, například pro testování kompatibility nebo správu verzí. Používání různých prostředí pomáhá udržet konzistenci kódu, usnadňuje testování a odděluje produkční prostředí, čímž snižuje riziko chyb při nasazování kódu.

Wrangler umožňuje nasadit stejnou aplikaci Worker s odlišnou konfigurací pro každé prostředí.

Pokud používáte prostředí Wrangler, musíte zadat všechny Vazby Durable Object který chcete použít pro jednotlivá prostředí.

Vazby Durable Object se nedědí. Můžete si například definovat prostředí s názvem staging jak je uvedeno níže:

{
	"env": {
		"staging": {
			"durable_objects": {
				"bindings": [
					{
						"name": "EXAMPLE_CLASS",
						"class_name": "DurableObjectExample"
					}
				]
			}
		}
	}
}

[[env.staging.durable_objects.bindings]]
name = "EXAMPLE_CLASS"
class_name = "DurableObjectExample"

Protože Wrangler připojuje název prostředí na název nejvyšší úrovně při publikování, pro Worker s názvem worker-name výše uvedený příklad odpovídá:

{
	"env": {
		"staging": {
			"durable_objects": {
				"bindings": [
					{
						"name": "EXAMPLE_CLASS",
						"class_name": "DurableObjectExample",
						"script_name": "worker-name-staging"
					}
				]
			}
		}
	}
}

[[env.staging.durable_objects.bindings]]
name = "EXAMPLE_CLASS"
class_name = "DurableObjectExample"
script_name = "worker-name-staging"

"EXAMPLE_CLASS" ve stagingovém prostředí je svázán s jiným kódovým názvem Workeru než na nejvyšší úrovni "EXAMPLE_CLASS" vazbu, a proto bude přistupovat k jiným Durable Objects s jiným trvalým úložištěm.

Pokud chcete binding specifický pro dané prostředí, který přistupuje ke stejným objektům jako binding na nejvyšší úrovni, zadejte explicitně název kódu Worker z nejvyšší úrovně pomocí script_name:

{
	"env": {
		"another": {
			"durable_objects": {
				"bindings": [
					{
						"name": "EXAMPLE_CLASS",
						"class_name": "DurableObjectExample",
						"script_name": "worker-name"
					}
				]
			}
		}
	}
}

[[env.another.durable_objects.bindings]]
name = "EXAMPLE_CLASS"
class_name = "DurableObjectExample"
script_name = "worker-name"

Migraci Durable Object můžete definovat pro každé prostředí i na nejvyšší úrovni. Migrace na úrovni prostředí mají přednost před migracemi na nejvyšší úrovni.

Další informace najdete v tématu Konfigurace migrace Wrangler.

Relace lokálního vývoje vytvoří samostatné, čistě lokální prostředí, které odpovídá produkčnímu prostředí, takže si Worker a Durable Objects můžete otestovat ještě před nasazením do produkce.

Existující binding Durable Object s názvem DB by byla dostupná vašemu Workeru při lokálním spouštění.

Viz Workers Lokální vývoj.

Durable Objects podporované KV umožňují vzdálený vývoj pomocí playgroundu v dashboardu. Playground v dashboardu využívá webovou verzi Visual Studio Code, díky které můžete na svém Workeru rychle iterovat přímo v prohlížeči.

Chcete-li spustit vzdálený vývoj:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte existující Worker.

3. Vyberte Upravit kód ikonu umístěnou v pravém horním rohu obrazovky.