Node.js-, Next.js- og Nuxt-applikationer.
Sådan genkendes og startes Node.js-projekter: Node-version, pakkehåndtering, Next.js og Nuxt (server eller statisk), SvelteKit, Astro, Express m.fl., variablen PORT og Prisma-migreringer.
Et repositorium med en package.json er et Node.js-projekt. Vi vælger framework, pakkehåndtering og Node-version, bygger og starter det – du skal bare pushe.
Node-version og pakkehåndtering
- Node.js – hentes fra
engines.nodeipackage.jsoneller fra.nvmrc: den nyeste af 24, 22, 20, 18 eller 16, der passer. Uden nogen af dem Node.js 22. - Pakkehåndtering – ud fra lock-filen:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, ellers npm (npm ci, når der er enpackage-lock.json). - Build – scriptet
build, nårpackage.jsonhar et.
Frameworks
| Framework | Sådan køres det |
|---|---|
| Next.js | som server (next start) – serverrendering, API-routes og middleware virker som normalt |
Next.js med output: 'export' | som statisk side fra out |
| Nuxt | som server (.output/server/index.mjs) |
Nuxt med ssr: false og et generate-script | som statisk side fra .output/public |
| SvelteKit | som server med adapter-node; med adapter-static som statisk side |
| Astro | som statisk side; med @astrojs/node som server |
| NestJS | dist/main.js efter build |
| 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 front-end-projekter – Vite, Create React App, Angular, Vue CLI m.fl. – serveres som statiske sider; se Statiske sider.
Lyt på PORT
En server skal lytte på porten i variablen PORT på alle interfaces:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js og Nuxt gør det selv. Lytter din applikation på en fast port, får den ingen besøgende – deployen stopper så ved starttjekket, og den forrige version kører videre.
Værdier ved build
Variabler fra fanen Variabler når den kørende applikation, ikke buildet. Værdier, som buildet skriver ind i klientkoden – som NEXT_PUBLIC_… i Next.js eller VITE_… – læses fra dit repositorium, for eksempel fra en committet .env.production-fil. Kode på serversiden læser fanen Variabler som normalt.
Din egen startkommando
Hvis den fundne start ikke er, hvad du vil have, så angiv Indstillinger → Build-indstillinger → Startkommando, f.eks. node dist/server.js eller npm run start:prod. Installations- og build-kommandoer kan også ændres dér.
Databaser og Prisma
Tilføj PostgreSQL eller MySQL til projektet, og læs DATABASE_URL – den sættes for dig. Med Prisma i dine afhængigheder er den anbefalede release-kommando npx prisma migrate deploy: den køres ved hver deploy, før den nye version får besøgende. Se Deploys.
Til køer med BullMQ tilføjer du Valkey og bruger REDIS_URL. Kør køprocessen som en baggrundsproces – på fanen Processer eller som en separat tjeneste med egne ressourcer. Se Et projekts tjenester.
Filer, der overlever en deploy
Hver deploy starter fra en frisk kopi af dit repositorium. Filer, som din applikation skriver til /data, bevares mellem deploys og tages med i den daglige backup; alt, der skrives andre steder, forsvinder ved næste deploy. Til uploads og medier er objektlager som regel det bedste valg.
Monorepos
Til et repositorium med flere projekter angiver du Projektmappe, når du opretter applikationen (f.eks. apps/web). En anden mappe i samme repositorium kan køre som en separat webtjeneste – se Et projekts tjenester.