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.
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.nodetai 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 onpackage-lock.json). - Koonti –
build-skripti, jospackage.jsonsisältää sellaisen.
Sovelluskehykset
| Sovelluskehys | Miten se ajetaan |
|---|---|
| Next.js | palvelimena (next start) – palvelinrenderöinti, API-reitit ja middleware toimivat tavalliseen tapaan |
Next.js asetuksella output: 'export' | staattisena sivustona hakemistosta out |
| Nuxt | palvelimena (.output/server/index.mjs) |
Nuxt asetuksella ssr: false ja generate-skriptillä | staattisena sivustona hakemistosta .output/public |
| SvelteKit | palvelimena adapter-node-sovittimella; adapter-static-sovittimella staattisena sivustona |
| Astro | staattisena sivustona; @astrojs/node-sovittimella palvelimena |
| NestJS | dist/main.js koonnin jälkeen |
| Express, Fastify, Koa, Hono ja muut palvelimet | tiedosto 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.