← Cloudflare Workers / workers / framework-guides

Nasaďte existující projekt

Wrangler dokáže automaticky rozpoznat váš framework a nakonfigurovat projekt pro Cloudflare Workers. Díky tomu můžete existující projekty nasadit jediným příkazem, bez ručního nastavování konfiguračních souborů nebo instalace adaptérů.

Když spustíte wrangler deploy nebo wrangler setup v adresáři projektu, který neobsahuje konfigurační soubor Wrangler, provede Wrangler:

1. Rozpoznejte svůj framework : analyzuje váš projekt a rozpozná framework, který používáte
2. Výzva k potvrzení - Zobrazí zjištěná nastavení a požádá vás o potvrzení před provedením změn
3. Nainstalujte adaptéry - Nainstaluje veškeré potřebné adaptéry Cloudflare pro váš framework
4. Generovat konfiguraci - Vytvoří wrangler.jsonc soubor s příslušným nastavením
5. Aktualizujte package.json : přidá užitečné skripty, jako například deploy, preview, a cf-typegen
6. Nakonfigurujte git : přidá položky specifické pro Wrangler do .gitignore

Automatická konfigurace podporuje následující frameworky:

Automatická konfigurace může fungovat i u jiných projektů, například SPA aplikací v React nebo Vue. Zkuste spustit wrangler deploy nebo wrangler setup a ověřte, zda je váš projekt rozpoznán.

Při spuštění automatické konfigurace mohou být vytvořeny nebo upraveny následující soubory:

Vytvoří se nový konfigurační soubor Wrangler s nastavením odpovídajícím vašemu frameworku:

{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "my-project",
	"main": "dist/_worker.js/index.js",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"compatibility_flags": ["nodejs_compat"],
	"assets": {
		"binding": "ASSETS",
		"directory": "dist",
	},
	"observability": {
		"enabled": true,
	},
}

"$schema" = "node_modules/wrangler/config-schema.json"
name = "my-project"
main = "dist/_worker.js/index.js"
# Set this to today's date
compatibility_date = "2026-08-28"
compatibility_flags = [ "nodejs_compat" ]

[assets]
binding = "ASSETS"
directory = "dist"

[observability]
enabled = true

Přesná konfigurace se liší v závislosti na vašem frameworku.

Nové skripty se přidávají do vašeho package.json:

{
	"scripts": {
		"deploy": "npm run build && wrangler deploy",
		"preview": "npm run build && wrangler dev",
		"cf-typegen": "wrangler types"
	}
}

Přidávají se položky specifické pro Wrangler:

# wrangler files
.wrangler
.dev.vars*
!.dev.vars.example

Pro frameworky, které generují worker soubory ve výstupním adresáři, .assetsignore soubor, který je vyloučí z nahrávání statických aktiv:

_worker.js
_routes.json

Chcete-li nasadit existující projekt, spusťte wrangler deploy v adresáři vašeho projektu:

npx wrangler deploy

Wrangler rozpozná váš framework, zobrazí konfiguraci, kterou použije, a před provedením změn a nasazením vás požádá o potvrzení.

Chcete-li nakonfigurovat projekt bez jeho nasazení, použijte wrangler setup:

npx wrangler setup

To se hodí, pokud chcete před nasazením zkontrolovat vygenerovanou konfiguraci.

Chcete-li zjistit, jaké změny by byly provedeny, aniž by došlo ke skutečné úpravě souborů:

npx wrangler setup --dry-run

Toto vypíše souhrn konfigurace, která by se vygenerovala.

Chcete-li přeskočit potvrzovací výzvy, použijte --yes příznak:

npx wrangler deploy --yes

Tím se konfigurace použije automaticky s rozumnými výchozími hodnotami. To je užitečné v prostředích CI/CD nebo když chcete přijmout zjištěná nastavení bez jejich kontroly.

Když importujete repozitář GitHub nebo GitLab přes Cloudflare dashboard, autoconfig proběhne neinteraktivně. Pokud váš repozitář nemá konfigurační soubor Wrangler, Workers Builds vytvoří pull request s potřebnou konfigurací.

PR obsahuje všechny výše popsané změny konfigurace. Vygeneruje se preview nasazení, abyste mohli změny otestovat ještě před sloučením. Po sloučení je váš projekt připravený k nasazení.

Podrobnosti uvádí Automatické pull requesty.

Pokud nechcete, aby proběhla automatická konfigurace, ujistěte se, že máte platný konfigurační soubor Wrangler (wrangler.toml, wrangler.json, nebo wrangler.jsonc) ve vašem projektu před spuštěním wrangler deploy.

Svůj projekt můžete také nakonfigurovat ručně podle průvodců specifických pro daný framework v Návody pro frameworky.

U projektů Next.js automatická konfigurace používá vinext jako výchozí způsob nasazení pro Cloudflare Workers. Vygenerovaná konfigurace přidá závislosti vinext a Vite, vytvoří konfiguraci pro Cloudflare Workers a doplní skripty balíčku pro vývoj, sestavení a nasazení.

vinext podporuje funkce ukládání do mezipaměti Next.js, jako je Incremental Static Regeneration (ISR), "use cache", a unstable_cache. U produkčních aplikací nakonfigurujte vygenerovaný projekt Workers s cache backendem, který vaše aplikace vyžaduje. Další informace najdete v ukládání do mezipaměti ve vinext ↗.

Pokud místo vinext potřebujete adaptér OpenNext, nakonfigurujte ho ručně podle Průvodce adaptérem OpenNext.

Když importujete repozitář přes Workers Builds v Cloudflare dashboardu, automatická konfigurace selže, pokud projekt obsahuje více frameworků. Chcete-li to vyřešit, nastavte kořenový adresář na cestu obsahující pouze jeden framework. Pro monorepa se podívejte na nastavení monorepa.

Při spuštění wrangler deploy nebo wrangler setup lokálně, Wrangler vás vyzve k výběru frameworku, pokud rozpozná více frameworků.

Pokud není váš framework rozpoznán, ujistěte se, že váš package.json zahrnuje framework jako závislost.

Pokud již konfigurační soubor Wrangleru existuje, automatická konfigurace se nespustí. Chcete-li projekt nakonfigurovat znovu, odstraňte existující konfigurační soubor a spusťte wrangler deploy nebo wrangler setup znovu.

Podpora pro monorepa a pracovní prostory npm/yarn/pnpm je v současné době omezená. Wrangler analyzuje adresář projektu, ve kterém příkaz spouštíte, ale nedetekuje závislosti nainstalované v kořenovém adresáři pracovního prostoru. To může způsobit, že se detekce frameworku nezdaří, pokud je framework uveden jako závislost v kořenovém package.json místo v rámci jednotlivého projektu v package.json.

Pokud narazíte na problémy, nahlaste je v Repozitář Wrangleru na GitHubu ↗.