Aloita

Node.js-, Next.js- ja Nuxt-sovellukset.

Miten Node.js-projektit tunnistetaan ja käynnistetään: Node-versio, paketinhallinta, Next.js ja Nuxt (palvelin tai staattinen), SvelteKit, Astro, Express ja muut, PORT-muuttuja ja Prisma-migraatiot.

2 MIN LUKUAIKA

Repositorio, jossa on package.json, on Node.js-projekti. Valitsemme sovelluskehyksen, paketinhallinnan ja Node-version, koostamme projektin ja käynnistämme sen – sinä vain teet pushin.

Node-versio ja paketinhallinta

  • Node.js – otetaan package.json-tiedoston kentästä engines.node tai tiedostosta .nvmrc: uusin sopiva versioista 24, 22, 20, 18 ja 16. Jos kumpaakaan ei ole, Node.js 22.
  • Paketinhallinta – lukitustiedoston mukaan: pnpm-lock.yaml → pnpm, yarn.lock → yarn, muuten npm (npm ci, kun mukana on package-lock.json).
  • Koonti – build-skripti, jos package.json sisältää sellaisen.

Sovelluskehykset

SovelluskehysMiten se ajetaan
Next.jspalvelimena (next start) – palvelinrenderöinti, API-reitit ja middleware toimivat tavalliseen tapaan
Next.js asetuksella output: 'export'staattisena sivustona hakemistosta out
Nuxtpalvelimena (.output/server/index.mjs)
Nuxt asetuksella ssr: false ja generate-skriptillästaattisena sivustona hakemistosta .output/public
SvelteKitpalvelimena adapter-node-sovittimella; adapter-static-sovittimella staattisena sivustona
Astrostaattisena sivustona; @astrojs/node-sovittimella palvelimena
NestJSdist/main.js koonnin jälkeen
Express, Fastify, Koa, Hono ja muut palvelimettiedosto kentästä scripts.start (node server.js), muuten main, muuten server.js, app.js, index.js tai main.js

Pelkät käyttöliittymäprojektit – Vite, Create React App, Angular, Vue CLI ja muut – tarjoillaan staattisina sivustoina; katso Staattiset sivustot.

Kuuntele PORT-porttia

Palvelimen on kuunneltava PORT-muuttujan porttia kaikilla verkkoliitännöillä:

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

Next.js ja Nuxt tekevät tämän itse. Jos sovelluksesi kuuntelee kiinteää porttia, se ei saa kävijöitä – julkaisu pysähtyy silloin käynnistystarkistukseen ja edellinen versio jatkaa toimintaansa.

Koonnin aikaiset arvot

Muuttujat-välilehden muuttujat välittyvät käynnissä olevalle sovellukselle, eivät koonnille. Arvot, jotka koonti kirjoittaa asiakaskoodiin – kuten Next.js:n NEXT_PUBLIC_… tai VITE_… – luetaan repositoriostasi, esimerkiksi commitoidusta .env.production-tiedostosta. Palvelinpuolen koodi lukee Muuttujat-välilehteä tavalliseen tapaan.

Oma käynnistyskomento

Jos tunnistettu käynnistys ei ole haluamasi, aseta Asetukset → Koontiasetukset → Käynnistyskomento, esim. node dist/server.js tai npm run start:prod. Myös asennus- ja koontikomentoja voi muuttaa samassa paikassa.

Tietokannat ja Prisma

Lisää projektiin PostgreSQL tai MySQL ja lue DATABASE_URL – se asetetaan puolestasi. Jos riippuvuuksissasi on Prisma, suositeltu julkaisukomento on npx prisma migrate deploy: se ajetaan jokaisessa julkaisussa ennen kuin uusi versio alkaa ottaa vastaan kävijöitä. Katso Julkaisut.

BullMQ-jonoja varten lisää Valkey ja käytä muuttujaa REDIS_URL. Aja jonon käsittelijä taustaprosessina – Prosessit-välilehdellä tai erillisenä palveluna omilla resursseillaan. Katso Projektin palvelut.

Julkaisun yli säilyvät tiedostot

Jokainen julkaisu alkaa repositoriosi tuoreesta kopiosta. Tiedostot, jotka sovelluksesi kirjoittaa hakemistoon /data, säilyvät julkaisujen välillä ja varmuuskopioidaan päivittäin; muualle kirjoitettu katoaa seuraavassa julkaisussa. Latauksille ja mediatiedostoille objektitallennus on yleensä parempi valinta.

Monorepot

Jos repositoriossa on useita projekteja, aseta Projektikansio sovellusta luodessasi (esim. apps/web). Saman repositorion toinen kansio voi toimia erillisenä verkkopalveluna – katso Projektin palvelut.

Jäikö jotain epäselväksi?

Kirjoita meille chatissa — AI vastaa heti, ja insinööri liittyy mukaan tarvittaessa mihin aikaan tahansa.

Ota yhteyttä tukeen