Migrace existujícího projektu Next.js do Netlify

Ahoj!

Takže máte projekt Next.js, který funguje bezchybně, a chcete ho poprvé umístit na Netlify. Zábava! Zde je několik věcí, které možná budete muset udělat.

Přidejte netlify.toml soubor

Budete potřebovat netlify.toml soubor přidán na nejvyšší úroveň vašeho projektu, abyste se ujistili, že je vše importováno správně.

[build]
  command = "npm run build"
  publish = "out"

Můžete to také udělat v uživatelském rozhraní Netlify, pokud tento soubor nechcete vytvořit vyplněním příkazu build a publikování adresáře!

Pokud nepoužíváte výchozí hodnoty pro svůj publikační adresář Next.js nebo adresář funkcí, můžete hodnoty změnit zde! Například:

[build]
  command = "npm run build"
  functions = "my_functions_dir"
  publish = "my_publish_dir"

Pokud byste chtěli upravit ještě více nastavení sestavení, podívejte se na dokumentaci, kde najdete další informace o tomto!

Aktualizujte svůj next.config.json

Pokud máte next.config.json musíte přidat target: serverless k tomu. Pokud žádný nemáte, nemusíte to dělat. Důvodem je to, že nechceme pokazit žádný existující next.config.js obsah, který již možná máte!

Také vaše přesměrování a přepisy v tomto souboru budou muset být přesunuty. Což nás přivádí k…

Přesměrování

Svá vlastní přesměrování a přepisy můžete definovat v _redirects soubor na nejvyšší úrovni vašeho projektu (nebo můžete použít přesměrování ve vašem netlify.toml soubor také). Další informace o tom, jak je lze strukturovat, naleznete v dokumentech!

Ještě něco?

Upřímně, asi ne. Každý z těchto kroků je volitelný v závislosti na vašem projektu! Do všech nových projektů Next.js na platformě automaticky nainstalujeme Essential Next.js Build Plugin, který umožní vykreslování na straně serveru a další funkce specifické pro framework ve vašich sestaveních. Pokud s ním máte nějaké problémy, můžete jej odinstalovat nebo nahlásit problém na repo nebo položit otázky v naší komunitě!

Co když nemám existující projekt Next.js?

Byl tam! Zde je úvodní projekt, do kterého se můžete pustit:

(Kliknutím na toto tlačítko nasadíte startovací projekt Next.js do Netlify a naklonujete jej do vámi zvoleného poskytovatele Git, A protože je zcela nový, můžete předchozí části tohoto příspěvku zcela ignorovat)