INTEGRITY Dokumentace

Migrace z Netlify na Pages

V tomto tutoriálu se naučíte, jak migrovat svou aplikaci Netlify na Cloudflare Pages.

Jak zjistit příkaz sestavení a adresář sestavení

Chcete-li přesunout svou aplikaci na Cloudflare Pages, zjistěte svůj příkaz sestavení a adresář sestavení. Cloudflare Pages tyto údaje použije k sestavení a nasazení vaší aplikace.

V Netlify Dashboardu vyhledejte projekt, který chcete nasadit. Měl by být nastaven tak, aby se nasazoval z repozitáře na GitHubu.

Výběr webu v Netlify Dashboard

V dashboardu svého webu vyberte Nastavení webu, a poté Sestavení a nasazení.

Výběr Site Settings v dashboardu webu Výběr Build and Deploy v postranním panelu

V Sestavení a nasazení kartě najděte Nastavení sestavení panel, ve kterém bude Příkaz sestavení a Adresář pro publikování pole. Uložte si je pro nasazení do Cloudflare Pages. Na obrázku níže Příkaz sestavení je yarn build, a Adresář pro publikování je build/.

Vyhledání polí Build command a Publish directory

Migrace přesměrování a hlaviček

Pokud váš web obsahuje _redirects soubor ve vašem adresáři pro publikaci, můžete stejný soubor použít i v Cloudflare Pages a vaše přesměrování budou fungovat správně. Pokud máte přesměrování ve svém netlify.toml soubor, budete je muset přidat do _redirects složka. Cloudflare Pages v současnosti nabízí omezenou podpora pokročilých přesměrování. Pokud máte více než 2000 statických nebo 100 dynamických pravidel přesměrování, doporučujeme použít Bulk Redirects.

Soubory s hlavičkami můžete také přesunout do _headers složka ve vašem publikační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 funkcí, a to ani v případě, že trasa funkce odpovídá vzoru URL. Více o tom, jak jak pracovat s hlavičkami, najdete v části Hlavičky.

Formuláře

Ve své komponentě formuláře odstraňte data-netlify = "true" atribut nebo atribut Netlify z <form> značku. Nyní můžete logiku formuláře implementovat jako Pages Function a ukládat záznamy do databáze nebo do Airtable. Další informace najdete v zpracování odesílaných formulářů pomocí Pages Functions tutoriál s dalšími informacemi.

Serverless funkce

Netlify functions a Pages Functions používají stejnou konvenci systému souborů pomocí functions adresář v základu projektu, který obsluhuje vaše bezserverové funkce. Syntaxe a způsob nasazení funkcí se ale liší. Pages Functions běží na Cloudflare Workers, které standardně pracují na globální síti Cloudflare a nevyžadují pro nasazení žádný další kód ani konfiguraci.

Cloudflare Pages Functions navíc nabízí middleware, který dokáže zpracovat libovolnou logiku potřebnou před a/nebo po obsluze trasy funkce.

Syntaxe Functions

Netlify functions exportují asynchronní obslužnou funkci (event handler), která jako argumenty přijímá event a context. V případě Pages Functions musíte exportovat jedinou onRequest funkce, která přijímá context objekt. context objekt obsahuje všechny informace o požadavku, například request, env, params, a vrátí nový Response. Další informace o napsání první funkce

Hello World pomocí Netlify functions:

exports.handler = async function (event, context) {
	return {
		statusCode: 200,
		body: JSON.stringify({ message: "Hello World" }),
	};
};

Hello World pomocí Pages Functions:

export async function onRequestPost(request) {
	return new Response(`Hello world`);
}

Další konfigurace Netlify

Váš netlify.toml soubor může obsahovat další konfigurace podporované v Pages, například preview deployment, určení adresáře pro publikaci nebo pluginy. Po migraci konfigurace můžete soubor smazat.

Správa přístupu

Správu přístupu můžete migrovat na Cloudflare Zero Trust která vám umožňuje spravovat ověřování uživatelů ve vašich aplikacích, protokolování událostí a požadavky.

Vytvoření nového projektu Pages

Jakmile zjistíte svůj build adresář a build příkaz, můžete projekt přesunout do Cloudflare Pages.

Úvodní návod vás provede přidáním vašeho projektu GitHub do Cloudflare Pages.

Pokud se rozhodnete pro Pages použít vlastní doménu, můžete nastavit stejnou vlastní doménu, jakou používá vaše aktuálně nasazená aplikace Netlify. Chcete-li vlastní doménu přiřadit k projektu Pages, přečtěte si Custom Domains.

Úklid staré aplikace a přiřazení domény

V dashboardu Cloudflare přejděte na DNS záznamy stránce.

Přejděte na Záznamy ↗

Zkontrolujte, že jste aktualizovali záznam CNAME domény z Netlify na Cloudflare Pages. Po aktualizaci DNS záznamu budou požadavky směřovat na vaši aplikaci Pages.

V DNS, vašeho záznamu Obsah by měl být váš <SUBDOMAIN>.pages.dev subdoména.

Po dokončení výše uvedených kroků jste úspěšně migrovali svůj projekt Netlify na Cloudflare Pages.