Node.js-, Next.js- og Nuxt-applikasjoner.
Slik gjenkjennes og startes Node.js-prosjekter: Node-versjon, pakkebehandler, Next.js og Nuxt (server eller statisk), SvelteKit, Astro, Express og lignende, PORT-variabelen og Prisma-migreringer.
Et repositorium med en package.json er et Node.js-prosjekt. Vi velger rammeverk, pakkebehandler og Node-versjon, bygger og starter det – du trenger bare å pushe.
Node-versjon og pakkebehandler
- Node.js – hentes fra
engines.nodeipackage.jsoneller fra.nvmrc: den nyeste av 24, 22, 20, 18 eller 16 som passer. Uten noen av dem brukes Node.js 22. - Pakkebehandler – ut fra låsefilen:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, ellers npm (npm cinår det finnes enpackage-lock.json). - Bygg –
build-skriptet, nårpackage.jsonhar et.
Rammeverk
| Rammeverk | Slik kjøres det |
|---|---|
| Next.js | som server (next start) – serverrendering, API-ruter og middleware fungerer som vanlig |
Next.js med output: 'export' | som statisk nettsted fra out |
| Nuxt | som server (.output/server/index.mjs) |
Nuxt med ssr: false og et generate-skript | som statisk nettsted fra .output/public |
| SvelteKit | som server med adapter-node; med adapter-static som statisk nettsted |
| Astro | som statisk nettsted; med @astrojs/node som server |
| NestJS | dist/main.js etter byggingen |
| Express, Fastify, Koa, Hono og andre servere | filen i scripts.start (node server.js), ellers main, ellers server.js, app.js, index.js eller main.js |
Rene frontend-prosjekter – Vite, Create React App, Angular, Vue CLI og andre – serveres som statiske nettsteder. Se Statiske nettsteder.
Lytt på PORT
En server må lytte på porten i PORT-variabelen, på alle grensesnitt:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js og Nuxt gjør dette selv. Hvis applikasjonen din lytter på en fast port, får den ikke besøkende – utrullingen stopper da ved oppstartssjekken, og den forrige versjonen fortsetter å kjøre.
Verdier ved bygging
Variabler fra fanen Variabler når den kjørende applikasjonen, ikke byggingen. Verdier som byggingen skriver inn i klientkoden – som NEXT_PUBLIC_… i Next.js eller VITE_… – leses fra repositoriet ditt, for eksempel fra en innsjekket .env.production-fil. Kode på serversiden leser fanen Variabler som vanlig.
Din egen startkommando
Hvis den oppdagede oppstarten ikke er det du vil ha, angir du Innstillinger → Bygginnstillinger → Startkommando, for eksempel node dist/server.js eller npm run start:prod. Installasjons- og byggekommandoer kan også endres der.
Databaser og Prisma
Legg til PostgreSQL eller MySQL i prosjektet og les DATABASE_URL – den settes for deg. Med Prisma blant avhengighetene er anbefalt utgivelseskommando npx prisma migrate deploy: den kjøres ved hver utrulling før den nye versjonen får besøkende. Se Utrullinger.
For køer med BullMQ legger du til Valkey og bruker REDIS_URL. Kjør købehandleren som en bakgrunnsprosess – på fanen Prosesser, eller som en egen tjeneste med egne ressurser. Se Tjenester i et prosjekt.
Filer som overlever en utrulling
Hver utrulling starter fra en fersk kopi av repositoriet ditt. Filer som applikasjonen skriver til /data, beholdes mellom utrullinger og sikkerhetskopieres daglig. Alt som skrives andre steder, forsvinner ved neste utrulling. For opplastinger og media er objektlagring vanligvis et bedre valg.
Monorepoer
For et repositorium med flere prosjekter angir du Prosjektmappe når du oppretter applikasjonen (for eksempel apps/web). En annen mappe i samme repositorium kan kjøres som en egen webtjeneste – se Tjenester i et prosjekt.