← Cloudflare Workers KV / kv / reference

Prostředí

Jmenné prostory KV lze použít s prostředí. To je užitečné, pokud máte ve svém Workeru kód, který odkazuje na vazbu KV, například MY_KV a chcete, aby tyto vazby směřovaly do různých KV namespace (například jeden pro staging a jeden pro produkci).

Následující kód v souboru Wrangler ukazuje, jak nastavit dvě prostředí se dvěma různými KV namespace, ale se stejným názvem bindingu:

{
	"env": {
		"staging": {
			"kv_namespaces": [
				{
					"binding": "MY_KV",
					"id": "e29b263ab50e42ce9b637fa8370175e8"
				}
			]
		},
		"production": {
			"kv_namespaces": [
				{
					"binding": "MY_KV",
					"id": "a825455ce00f4f7282403da85269f8ea"
				}
			]
		}
	}
}

[[env.staging.kv_namespaces]]
binding = "MY_KV"
id = "e29b263ab50e42ce9b637fa8370175e8"

[[env.production.kv_namespaces]]
binding = "MY_KV"
id = "a825455ce00f4f7282403da85269f8ea"

Použití stejného názvu bindingu pro dva různé jmenné prostory KV zpřehledňuje kód vašeho Workeru.

V staging prostředí, MY_KV.get("KEY") bude číst z namespace ID e29b263ab50e42ce9b637fa8370175e8. V production prostředí, MY_KV.get("KEY") bude číst z namespace ID a825455ce00f4f7282403da85269f8ea.

Chcete-li vložit hodnotu do staging KV namespace, spusťte:

wrangler kv key put --env=staging --binding=<YOUR_BINDING> "<KEY>" "<VALUE>"

Protože --namespace-id je vždy jedinečný (na rozdíl od názvů bindingů), nemusíte zadávat --env argument:

wrangler kv key put --namespace-id=<YOUR_ID> "<KEY>" "<VALUE>"

Většina kv podpříkazy vám také umožňují určit prostředí pomocí volitelného --env příznak.

Zadání prostředí pomocí volitelného --env příznak vám umožňuje publikovat Workers se stejným kódem, ale s odlišnými KV namespace.

Ve svém souboru Wrangler můžete pro data KV použít například oddělené namespace pro staging a produkci:

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"type": "webpack",
	"name": "my-worker",
	"account_id": "<account id here>",
	"route": "staging.example.com/*",
	"workers_dev": false,
	"kv_namespaces": [
		{
			"binding": "MY_KV",
			"id": "06779da6940b431db6e566b4846d64db"
		}
	],
	"env": {
		"production": {
			"route": "example.com/*",
			"kv_namespaces": [
				{
					"binding": "MY_KV",
					"id": "07bc1f3d1f2a4fd8a45a7e026e2681c6"
				}
			]
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
type = "webpack"
name = "my-worker"
account_id = "<account id here>"
route = "staging.example.com/*"
workers_dev = false

[[kv_namespaces]]
binding = "MY_KV"
id = "06779da6940b431db6e566b4846d64db"

[env.production]
route = "example.com/*"

  [[env.production.kv_namespaces]]
  binding = "MY_KV"
  id = "07bc1f3d1f2a4fd8a45a7e026e2681c6"

S výše uvedeným souborem Wrangler můžete zadat --env production když chcete provést akci KV na KV namespace MY_KV v části env.production.

Se souborem Wrangler uvedeným výše můžete například získat hodnotu z produkční instance KV pomocí:

wrangler kv key get --binding "MY_KV" --env=production "<KEY>"