← Hyperdrive (Postgres & MySQL) / hyperdrive / configuration

Lokální vývoj

Hyperdrive lze používat i při lokálním vývoji a testování vašich Workers. Wrangler, rozhraní příkazové řádky pro Workers, nabízí dvě možnosti místního vývoje:

• wrangler dev (výchozí): Spustí kód vašeho Workeru lokálně na vašem počítači. Nakonfigurujete localConnectionString pro přímé připojení k databázi (lokální nebo vzdálené). V tomto režimu se mezipaměť dotazů Hyperdrive neuplatní.
• wrangler dev --remote: Spustí váš Worker v síti Cloudflare pomocí vaší nasazené konfigurace Hyperdrive. To je užitečné pro testování se zapnutým sdružováním připojení a ukládáním dotazů do mezipaměti v Hyperdrive.

Standardně wrangler dev spouští kód Workeru lokálně na vašem počítači. Pokud se chcete během lokálního vývoje připojit k databázi, nakonfigurujte localConnectionString směřující přímo k vaší databázi.

localConnectionString funguje s místními i vzdálenými databázemi:

• Lokální databáze: Připojte se k instanci databáze běžící na vašem počítači (například postgres://user:password@localhost:5432/database)
• Vzdálené databáze: Připojte se přímo ke vzdáleným databázím přes TLS (například postgres://user:[email protected]:5432/database?sslmode=require nebo mysql://user:[email protected]:3306/database?sslMode=required). Pokud je to potřeba, musíte zadat režim SSL/TLS.

Doporučeným postupem je použít proměnnou prostředí, abyste se vyhnuli ukládání přihlašovacích údajů do systému správy verzí:

# Your configured Hyperdrive binding is "HYPERDRIVE"
export CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_HYPERDRIVE="postgres://user:password@your-database-host:5432/database"
npx wrangler dev

Formát proměnné prostředí je CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING_NAME>, kde <BINDING_NAME> je název bindingu přiřazeného vašemu Hyperdrive ve vašem Konfigurační soubor Wrangler.

Chcete-li zrušit proměnnou prostředí: unset CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING_NAME>

Chcete-li například nastavit připojovací řetězec pro lokální databázi:

export CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_HYPERDRIVE="postgres://user:password@localhost:5432/databasename"
npx wrangler dev

Alternativně můžete nastavit localConnectionString ve vašem Konfigurační soubor Wrangler:

{
	"hyperdrive": [
		{
			"binding": "HYPERDRIVE",
			"id": "c020574a-5623-407b-be0c-cd192bab9545",
			"localConnectionString": "postgres://user:password@localhost:5432/databasename"
		}
	]
}

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "c020574a-5623-407b-be0c-cd192bab9545"
localConnectionString = "postgres://user:password@localhost:5432/databasename"

Pokud jsou nastaveny proměnná prostředí i localConnectionString v konfiguračním souboru Wrangler jsou nastaveny, má přednost proměnná prostředí.

Když spustíte wrangler dev --remote, váš Worker běží v síti Cloudflare a používá vaši nasazenou konfiguraci Hyperdrive. To znamená:

• Kód vašeho Workeru se spouští v produkčním prostředí Cloudflare, nikoli lokálně
• Sdružování připojení a ukládání dotazů do mezipaměti ve službě Hyperdrive jsou aktivní
• Připojujete se k databázi nastavené ve vaší konfiguraci Hyperdrive (vytvořené pomocí wrangler hyperdrive create)
• Změny provedené během relace interagují se vzdálenými prostředky

Tento režim je užitečný pro otestování chování Workeru s povolenými funkcemi Hyperdrive ještě před nasazením.

Nakonfigurujte binding Hyperdrive v wrangler.jsonc:

{
	"hyperdrive": [
		{
			"binding": "HYPERDRIVE",
			"id": "your-hyperdrive-id",
		},
	],
}

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "your-hyperdrive-id"

Chcete-li spustit relaci vzdáleného vývoje:

npx wrangler dev --remote

Viz wrangler dev dokumentace a dozvíte se více o konfiguraci relace lokálního vývoje.

• Použijte wrangler dev ke spuštění vašeho Workeru a Hyperdrive lokálně a k ladění problémů před nasazením.
• Přečtěte si jak funguje Hyperdrive.
• Seznamte se s tím, jak nakonfigurovat ukládání dotazů do mezipaměti v Hyperdrive.