Začať

Aplikácie Node.js, Next.js a Nuxt.

Ako rozpoznávame a spúšťame projekty Node.js: verzia Node, správca balíčkov, Next.js a Nuxt (server alebo statický web), SvelteKit, Astro, Express a ďalšie, premenná PORT a migrácie Prisma.

3 MIN. ČÍTANIA

Repozitár s package.json je projekt Node.js. Vyberieme framework, správcu balíčkov a verziu Node, zostavíme ho a spustíme — vy len pushnete.

Verzia Node a správca balíčkov

  • Node.js — podľa engines.node v package.json alebo podľa .nvmrc: najnovšia z verzií 24, 22, 20, 18 alebo 16, ktorá vyhovuje. Bez nich Node.js 22.
  • Správca balíčkov — podľa lock súboru: pnpm-lock.yaml → pnpm, yarn.lock → yarn, inak npm (npm ci, keď existuje package-lock.json).
  • Zostavenie — skript build, ak ho package.json má.

Frameworky

FrameworkAko beží
Next.jsako server (next start) — serverové vykresľovanie, API trasy a middleware fungujú ako zvyčajne
Next.js s output: 'export'ako statický web z out
Nuxtako server (.output/server/index.mjs)
Nuxt s ssr: false a skriptom generateako statický web z .output/public
SvelteKitako server s adapter-node; s adapter-static ako statický web
Astroako statický web; s @astrojs/node ako server
NestJSdist/main.js po zostavení
Express, Fastify, Koa, Hono a ďalšie serverysúbor v scripts.start (node server.js), inak main, inak server.js, app.js, index.js alebo main.js

Čisto front-endové projekty — Vite, Create React App, Angular, Vue CLI a ďalšie — sa poskytujú ako statické weby; pozrite Statické weby.

Počúvanie na PORT

Server musí počúvať na porte z premennej PORT, na všetkých rozhraniach:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js a Nuxt to robia samy. Ak vaša aplikácia počúva na pevnom porte, nedostane návštevníkov — nasadenie sa vtedy zastaví pri kontrole štartu a beží ďalej predchádzajúca verzia.

Hodnoty pri zostavení

Premenné z karty Premenné sa dostanú do bežiacej aplikácie, nie do zostavenia. Hodnoty, ktoré zostavenie zapíše do klientskeho kódu — napríklad NEXT_PUBLIC_… v Next.js alebo VITE_… —, sa čítajú z vášho repozitára, napríklad z commitnutého súboru .env.production. Serverový kód číta kartu Premenné ako zvyčajne.

Vlastný príkaz na spustenie

Ak rozpoznané spustenie nie je to, čo chcete, nastavte Nastavenia → Nastavenia zostavenia → Príkaz na spustenie, napr. node dist/server.js alebo npm run start:prod. Tam môžete zmeniť aj príkazy inštalácie a zostavenia.

Databázy a Prisma

Pridajte do projektu PostgreSQL alebo MySQL a čítajte DATABASE_URL — je nastavená za vás. S Prisma v závislostiach je odporúčaný príkaz pri vydaní npx prisma migrate deploy: spustí sa pri každom nasadení, skôr než nová verzia dostane návštevníkov. Pozrite Nasadenia.

Pre fronty s BullMQ pridajte Valkey a použite REDIS_URL. Spracovanie fronty spustite ako proces na pozadí — na karte Procesy alebo ako samostatnú službu s vlastnými prostriedkami. Pozrite Služby projektu.

Súbory, ktoré prežijú nasadenie

Každé nasadenie začína z čerstvej kópie vášho repozitára. Súbory, ktoré aplikácia zapíše do /data, sa medzi nasadeniami uchovávajú a denne zálohujú; všetko zapísané inde po ďalšom nasadení zmizne. Pre nahrávané súbory a médiá je zvyčajne lepšou voľbou objektové úložisko.

Monorepozitáre

Pri repozitári s viacerými projektmi nastavte pri vytváraní aplikácie Priečinok projektu (napr. apps/web). Iný priečinok toho istého repozitára môže bežať ako samostatná webová služba — pozrite Služby projektu.

Stále si neviete rady?

Napíšte nám do chatu — AI odpovie okamžite a technik sa pripojí, keď treba, v ktorúkoľvek dennú hodinu.

Kontaktovať podporu