← Cloudflare Pages / pages / migrations

Migrace z Workers Sites na Pages

V tomto tutoriálu se naučíte, jak migrovat existující Cloudflare Workers Sites aplikace na Cloudflare Pages.

Jako předpoklad byste měli mít projekt Cloudflare Workers Sites vytvořený pomocí Wrangler ↗.

Cloudflare Pages poskytuje vestavěná výchozí nastavení pro každý aspekt obsluhy vašeho webu. Vlastní chování z Workeru, například vlastní logiku ukládání do mezipaměti, můžete do projektu Cloudflare Pages přenést pomocí Funkce. Díky tomu získáte snadno použitelný souborový systém směrování. Vlastní hlavičky a přesměrování můžete do Pages také migrovat.

Možná už máte poměrně složitý Worker, nebo by bylo zdlouhavé jej rozdělit do souborového směrování Pages. Pro tyto případy nabízí Pages vývojářům možnost definovat _worker.js soubor ve výstupním adresáři vašeho projektu Pages.

Po migraci na Cloudflare Pages získáte přístup k funkcím, jako jsou náhledová nasazení a automatická nasazení větví bez nutnosti dalšího nastavení.

Projekty Workers Sites se skládají z následujících částí:

1. Aplikace vytvořená pomocí nástroj pro statické weby nebo statická sada souborů HTML, CSS a JavaScript.
2. Pokud používáte nástroj pro statické weby, adresář sestavení (nazývaný bucket v Konfigurační soubor Wrangler) kde statický projekt sestaví vaše soubory HTML, CSS a JavaScript.
3. Aplikace Worker pro obsluhu tohoto sestavovacího adresáře. U většiny projektů to bude pravděpodobně workers-site adresář.

Při přechodu na Cloudflare Pages odstraňte aplikaci Workers i všechny přidružené konfigurační soubory Wrangler nebo výstupy sestavení. Místo toho si poznamenejte svůj build příkaz (pokud nějaký máte) a bucket pole, respektive sestavovací adresář, ze souboru Wrangler v adresáři vašeho projektu.

Přesměrování můžete do Pages migrovat vytvořením _redirects soubor ve vašem výstupním adresáři. Pages v současnosti nabízí pouze omezenou podporu pokročilých přesměrování. Další podpora bude přidána později. Seznam podporovaných typů najdete v Dokumentace k přesměrování.

Kromě _redirects soubor, Cloudflare navíc nabízí Bulk Redirects, který zpracovává přesměrování přesahující limit 2,100 pravidel pro přesměrování stanovený službou Pages.

Vlastní hlavičky můžete také přesunout do _headers soubor ve vašem výstupním adresáři. Je důležité mít na paměti, že vlastní hlavičky definované v _headers se v současnosti neuplatní na odpovědi z Functions, a to ani v případě, že trasa Function odpovídá vzoru URL. Více o práci s hlavičkami se dozvíte v Hlavičky.

Jakmile si zaznamenáte příkaz pro sestavení a adresář sestavení na samostatné místo, odstraňte ze své aplikace vše ostatní a nahrajte novou verzi projektu k vašemu poskytovateli Git. Postupujte podle Úvodní návod pro přidání vašeho projektu do Cloudflare Pages pomocí příkaz pro sestavení a adresář sestavení kterou jste si dříve uložili.

Pokud se rozhodnete pro svůj projekt Pages použít vlastní doménu, můžete nastavit stejnou vlastní doménu, jakou používá vaše aktuálně nasazená aplikace Workers. Postupujte podle kroků pro přidání vlastní domény do svého projektu Pages.

Pokud má váš web na Workers vlastní nastavení sestavení, můžete přenést předem sestavené assety do Pages pomocí Direct Upload. Assets svého webu navíc můžete odesílat přímo do globální sítě Cloudflare, a to buď pomocí Wrangler CLI nebo možnost přetažení myší.

Tyto možnosti umožňují vytvořit a pojmenovat nový projekt z CLI nebo dashboardu. Po dokončení nasazení projektu můžete nastavit vlastní doménu podle přidání vlastní domény kroky do vašeho projektu Pages.

Jakmile nasadíte aplikaci Pages, Worker odstraníte takto:

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

   Přejděte na Workers & Pages ↗

2. Vyberte svůj Worker.

3. Přejděte na Správa > Delete Worker.

Jakmile odstraníte svou aplikaci Workers, požadavky budou směrovány na vaši aplikaci Pages. Dokončením tohoto průvodce jste úspěšně migrovali svůj projekt Workers Sites na Cloudflare Pages.