Wdróż Astro na Nodion

Wdróż Astro krok po kroku

1. Dodaj lockfile do repozytorium i uruchom build Dodaj swój lockfile do repozytorium; bez niego build kończy się błędem. Nodion uruchamia Twój skrypt build i udostępnia dist/ przez statyczny serwer WWW. Nie działa żaden serwer Node.js, więc statyczna strona Astro nie potrzebuje adaptera. package.json

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

2. Oznacz zmienne buildu Statyczny build odczytuje wszystkie zmienne podczas astro build, więc zaznacz dla nich Build w zakładce Environment. W trybie serwerowym to samo dotyczy zmiennych PUBLIC_*, które trafiają do kodu w przeglądarce.
3. Dla SSR: dodaj adapter Node Uruchom npx astro add node lub zainstaluj @astrojs/node samodzielnie, użyj go w trybie standalone i ustaw output: 'server' (lub 'hybrid' w Astro 4). Nodion uruchamia serwer tylko wtedy, gdy astro.config.mjs, .js lub .ts zawiera to ustawienie; nie odczytuje astro.config.mts. Trzymaj astro i @astrojs/node w dependencies, bo zależności deweloperskie są usuwane po buildzie. astro.config.mjs

   import { defineConfig } from "astro/config";
   import node from "@astrojs/node";
   
   export default defineConfig({
     output: "server",
     adapter: node({ mode: "standalone" }),
   });

4. Niech serwer nasłuchuje na wszystkich interfejsach Serwer standalone odczytuje PORT, który ustawia Nodion, oraz HOST. Ustaw HOST na 0.0.0.0 w zakładce Environment, aby serwer przyjmował połączenia spoza instancji, także health check. Nodion uruchamia node ./dist/server/entry.mjs, chyba że package.json ma skrypt start; jeśli Twój uruchamia astro dev, usuń go.
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. Każdy push tworzy nowy release, a ruch przechodzi na niego, gdy / odpowie statusem 2xx lub 3xx.

Warto wiedzieć

• Strony renderowane na żądanie wymagają output: 'server'Nodion decyduje na podstawie ustawienia output, a nie adaptera. Projekt, który zostaje przy domyślnym statycznym output i renderuje pojedyncze strony na żądanie przez export const prerender = false, nie jest uruchamiany jako serwer. Ustaw zamiast tego output: 'server', a strony, które mają pozostać statyczne, oznacz przez export const prerender = true.
• Twoja strona błędu 404Dla nieistniejących ścieżek statyczny serwer odpowiada Twoim plikiem index.html. Aby zamiast tego pokazać stronę, którą Astro buduje z src/pages/404.astro, dodaj plik static.toml z fallback = "404.html". Rób to tylko przy statycznym output: z plikiem static.toml Nodion zawsze serwuje projekt jako pliki statyczne.

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.

Astro na Nodion: pytania i odpowiedzi