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.
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.nodevpackage.jsonalebo 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ď existujepackage-lock.json). - Zostavenie — skript
build, ak hopackage.jsonmá.
Frameworky
| Framework | Ako beží |
|---|---|
| Next.js | ako server (next start) — serverové vykresľovanie, API trasy a middleware fungujú ako zvyčajne |
Next.js s output: 'export' | ako statický web z out |
| Nuxt | ako server (.output/server/index.mjs) |
Nuxt s ssr: false a skriptom generate | ako statický web z .output/public |
| SvelteKit | ako server s adapter-node; s adapter-static ako statický web |
| Astro | ako statický web; s @astrojs/node ako server |
| NestJS | dist/main.js po zostavení |
| Express, Fastify, Koa, Hono a ďalšie servery | sú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.