Wdróż Next.js na Nodion

Wdróż Next.js krok po kroku

1. Zachowaj lockfile i standardowe skrypty Dodaj do repozytorium package-lock.json, yarn.lock, pnpm-lock.yaml lub bun.lock; bez pliku lockfile build kończy się błędem. next start nasłuchuje na porcie PORT ustawianym przez Nodion, więc domyślne skrypty działają bez zmian. package.json

   "scripts": {
     "build": "next build",
     "start": "next start"
   }

2. Utwórz aplikację W dashboardzie utwórz aplikację ze swojego repozytorium GitHub, GitLab, Bitbucket lub Gitea, wybierz branch i region EU Central. Pozostaw strategię buildu Buildpacks; jeśli w repozytorium jest Dockerfile, formularz wybierze zamiast tego Dockerfile.
3. Ustaw zmienne środowiskowe Wszystko, co odczytuje next build, np. NEXT_PUBLIC_*, wymaga zaznaczenia opcji Build w zakładce Environment; pozostałe zmienne istnieją tylko podczas działania aplikacji. Klucze API oznacz jako sekrety.
4. Podłącz PostgreSQL i uruchom migracje Utwórz bazę danych w tym samym regionie i podłącz ją w zakładce Environment; przy następnym wdrożeniu aplikacja dostanie DATABASE_URL. Linia release: w Procfile uruchamia się raz na każdy build, zanim wystartuje nowa wersja. Narzędzie do migracji trzymaj w dependencies: zależności deweloperskie są usuwane po buildzie. Procfile

   release: npm run migrate

5. Wdrażaj przez push Każdy push do brancha tworzy nowy release. Ruch przechodzi na niego, gdy odpowie na / statusem 2xx lub 3xx; jeśli krok release się nie powiedzie, działająca wersja pozostaje online.

Warto wiedzieć

• Eksport statycznyPrzy output: 'export' w next.config Nodion udostępnia out/ przez statyczny serwer WWW z obsługą nieznanych ścieżek przez index.html. Nie działa żaden serwer Node, więc wystarczy najmniejszy rozmiar.
• Ścieżka health checkuJeśli / odpowiada kodem 401 lub 404, ustaw w ustawieniach aplikacji ścieżkę health checku, która zwraca 200, na przykład trasę serwerową pod /api/health.
• MonorepoUstaw Base directory na katalog aplikacji Next.js. Build widzi tylko ten katalog, więc lockfile musi się w nim znajdować.

Czym Nodion zajmuje się za Ciebie

• Wdrożenia bez przestojów Wypchnij zmiany do swojej gałęzi, a Nodion zbuduje nowy release. Ruch przełącza się, gdy nowe instancje przejdą health check; nieudany release nie wpływa na działającą wersję. Aplikacje z lokalnym wolumenem są natomiast uruchamiane ponownie, bo dysk należy do jednej instancji.
• Bazy danych obok aplikacji Zarządzane PostgreSQL, pgvector, MySQL, Valkey i ClickHouse w tym samym regionie. Podłączone bazy danych trafiają do aplikacji jako DATABASE_URL, REDIS_URL lub CLICKHOUSE_URL.
• Środowiska podglądu dla pull requestów Włącz środowiska podglądu, a każdy pull request z Twojego repozytorium dostanie własną aplikację z własnym adresem URL i nowymi, pustymi bazami danych, tworzoną automatycznie lub ręcznie. Forki i pull requesty od botów są pomijane.
• Workery, zadania cron i skalowanie Uruchamiaj workery jako dodatkowe procesy tej samej aplikacji, planuj zadania w zakładce Cron i skaluj każdy proces do 16 instancji.
• Etap release W przypadku buildpacków linia release: w Procfile uruchamia się przy każdym nowym buildzie. Aplikacje z Dockerfile, a także ponowne wdrożenia i rollbacki do wcześniejszego obrazu, korzystają z polecenia release ustawionego w samej aplikacji, które ma też pierwszeństwo przed linią z Procfile. W przypadku stron statycznych krok release działa w obrazie zawierającym tylko zbudowane pliki.
• Logi i metryki W dashboardzie znajdziesz logi z builda, release'u i działania aplikacji oraz metryki CPU, pamięci, dysku i sieci dla każdej instancji.
• Domeny i HTTPS Domyślna nazwa hosta z HTTPS od pierwszego wdrożenia; Twoje własne domeny automatycznie dostają certyfikaty.

Warto przeczytać

• Alternatywy dla Vercel w Europie: 5 opcji dla Next.js Funkcje na edge czy stale działający serwer Node.js obok Twojej bazy danych: pięć alternatyw dla Vercel do Next.js, porównanych według modelu uruchamiania i lokalizacji.
• Środowiska podglądu: aplikacja dla każdego pull requesta Działająca kopia Twojej aplikacji dla każdego pull requesta: do czego przydają się środowiska podglądu, gdzie robi się trudno i jak obsługuje je Nodion.

Next.js na Nodion: pytania i odpowiedzi