← Cloudflare Workers / workers / local-development

Přidávání lokálních dat

Zda používáte Wrangler, nebo Cloudflare Vite plugin ↗, váš workflow pro přístup data během lokálního vývoje zůstávají stejná. Můžete však pouze naplnit lokální prostředky daty prostřednictvím Wrangler CLI.

Jak to funguje

Když spustíte buď wrangler dev nebo vite ↗, Miniflare automaticky vytváří lokální verze vašich prostředků (například KV, D1, nebo R2). To znamená, že nemusíte nemusíte ručně nastavovat samostatné lokální instance pro každou službu. Nově vytvořené lokální prostředky však nebude neobsahuje žádná data: budete muset použít příkazy Wrangler s --local příznak, abyste je naplnili daty. Změny provedené v lokálních prostředcích neovlivní produkční data.

Plnění místních prostředků daty

Když začnete s vývojem, vaše lokální prostředky budou prázdné. Budete je muset naplnit daty pomocí Wrangler CLI.

KV namespaces

Přidejte jeden pár klíč-hodnota

npx wrangler kv key put <KEY> <VALUE> --binding=<BINDING> --local

Hromadné nahrání

npx wrangler kv bulk put <FILENAME.json> --binding=<BINDING> --local

R2 buckety

Nahrání souboru

npx wrangler r2 object put <BUCKET>/<KEY> --file=<PATH_TO_FILE> --local

Můžete také uvést další metadata.

Databáze D1

Spusťte příkaz SQL

npx wrangler d1 execute <DATABASE_NAME> --command="<SQL_QUERY>" --local

Spusťte soubor SQL

npx wrangler d1 execute <DATABASE_NAME> --file=./schema.sql --local

Durable Objects

Na rozdíl od KV, D1 a R2 neexistují pro Durable Objects žádné příkazy CLI pro naplnění lokálními daty. Chcete-li data do Durable Objects přidat během lokálního vývoje, musíte napsat kód aplikace, který vytvoří instance Durable Object a volá na nich metody, které ukládají stav. Obvykle to znamená vytvoření vývojových endpointů nebo testovacích routes, které inicializují vaše Durable Objects požadovanými daty.

Kde se ukládají lokální data

Ve výchozím nastavení ukládají Wrangler i Plugin Vite lokální data bindingů na stejné místo: do .wrangler/state složku v adresáři projektu. Tato složka ukládá data v podadresářích pro všechny místní vazby: jmenné prostory KV, buckety R2, databáze D1, Durable Objects a další.

Vymazání místního úložiště

Můžete odstranit .wrangler/state složku kdykoli smazat a resetovat tak místní prostředí, Miniflare ji znovu vytvoří při příštím spuštění dev příkaz. Můžete také odstranit konkrétní podsložky uvnitř .wrangler/state pro cílenější úklid.

Změna lokálního datového adresáře

Pokud chcete pro místní úložiště zadat jiný adresář, můžete to udělat přes rozhraní Wrangler CLI nebo v konfiguraci pluginu Vite.

Používání Wrangleru

Použijte --persist-to příznak s wrangler dev. Tento příznak musíte zadat při každém spuštění dev příkaz:

npx wrangler dev --persist-to <DIRECTORY>

Použití --local hodnotou --persist-to

Pokud spustíte wrangler dev --persist-to <DIRECTORY> pro zadání vlastního umístění lokálních dat, musíte zároveň zahrnout stejný --persist-to <DIRECTORY> při spouštění dalších příkazů Wrangler, které upravují lokální data (a nezapomeňte zahrnout --local příznak).

Chcete-li například vytvořit klíč KV s názvem test s hodnotou 12345 v lokálním KV namespace spusťte:

npx wrangler kv key put test 12345 --binding MY_KV_NAMESPACE --local --persist-to worker-local

Tento příkaz:

Nastaví klíč KV test na 12345 v bindingu MY_KV_NAMESPACE (definováno ve vašem Konfigurační soubor Wrangler).
Používá --persist-to worker-local abyste zajistili, že se data vytvoří v worker-local adresář místo výchozího .wrangler/state.
Přidá --local příznak, který signalizuje, že chcete upravit lokální data.

Pokud --persist-to není zadáno, Wrangler ve výchozím nastavení použije .wrangler/state pro lokální data.

Použití pluginu Cloudflare Vite

Chcete-li změnit, kam Vite plugin ukládá lokální data, nakonfigurujte persistState možnost v konfiguračním souboru Vite:

vite.config.js

import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
	plugins: [
		cloudflare({
			persistState: { path: "./my-custom-directory" },
		}),
	],
});

Pokud chcete, aby si Wrangler a plugin Vite sdílely stejný stav, nakonfigurujte je na stejnou cestu perzistence.