Wdróż Static sites and SPAs na Nodion

Wdróż Static sites and SPAs krok po kroku

1. Dodaj do repozytorium lockfile i skrypt build Dodaj swój lockfile do repozytorium; bez niego build kończy się błędem. Nodion uruchamia skrypt build i bierze katalog wynikowy Twojego frameworka: dist/ w Vite, build/ w Create React App, dist/<projekt>/browser w Angularze, public/ w Gatsby i _site/ w Eleventy. package.json

   "scripts": {
     "dev": "vite",
     "build": "vite build"
   }

2. Ustaw zmienne buildu Twój bundler wpisuje zmienne, takie jak VITE_*, REACT_APP_* czy GATSBY_*, do plików podczas buildu, więc wymagają one opcji Build w zakładce Environment. Wszystko, co zawierają, jest publiczne, więc nigdy nie umieszczaj w nich sekretów.
3. Podaj inne katalogi wynikowe w static.toml Inne generatory też działają: Nodion szuka pliku index.html w dist, build, out, .output/public, public i _site. Jeśli Twój zapisuje go gdzie indziej, jak VitePress, dodaj plik static.toml obok package.json. Sprawia on też, że Nodion traktuje repozytorium jako stronę statyczną, gdy sam by jej nie wykrył. fallback wskazuje plik serwowany dla nieistniejących ścieżek. static.toml

   output-dir = "docs/.vitepress/dist"
   fallback = "index.html"

4. Sam HTML nie potrzebuje buildu Repozytorium z plikiem index.html w katalogu głównym i bez package.json jest serwowane bez zmian. Nodion pomija .git, pliki .env i niektóre typowe pliki z kluczami, ale traktuj wszystko, co dodajesz do repozytorium, jako publiczne i nie trzymaj sekretów w repozytorium.
5. Utwórz aplikację i zrób push W dashboardzie utwórz aplikację ze swojego repozytorium GitHub, GitLab, Bitbucket lub Gitea w regionie EU Central i wybierz najmniejszy rozmiar. Każdy push tworzy nowy release, a ruch przechodzi na niego, gdy / zacznie odpowiadać dzięki plikowi index.html.

Warto wiedzieć

• Routing po stronie klienta działaŚcieżki, które nie pasują do żadnego pliku, dostają Twój index.html, więc trasy React Router, Vue Router i Angulara działają także po przeładowaniu strony. Fallbacku nie da się wyłączyć; fallback w static.toml tylko podmienia plik.
• Bez procesów z Procfile, bez kodu serweraProcesy z Procfile nie mają wpływu na stronę statyczną, a publikowany jest tylko katalog wynikowy. Linia release: nadal by się uruchomiła, ale w obrazie zawierającym tylko zbudowane pliki, więc ją pomiń. Jeśli Twoje repozytorium to serwer Node.js ze skryptem build, przeczytaj przewodnik Node.js, aby dowiedzieć się, jak Nodion rozróżnia te dwa przypadki.
• Angular SSRNodion buduje projekty Angular jako strony statyczne, także z @angular/ssr, więc renderowanie po stronie serwera nie działa. Dla SSR użyj Dockerfile.
• Hugo i JekyllNodion nie uruchamia buildów Hugo ani Jekyll. Zbuduj stronę samodzielnie, dodaj wygenerowany folder do repozytorium (public/ lub _site/) i ustaw na niego Base directory aplikacji: folder z plikiem index.html i bez package.json jest serwowany bez zmian. Możesz też zbudować stronę w Dockerfile.

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ć

• Ś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.
• Cloud Native Buildpacks: czym są i jak działają Buildpacki zamieniają Twój kod źródłowy w obraz kontenera bez Dockerfile. Czym są i jak działają.

Static sites and SPAs na Nodion: pytania i odpowiedzi