Node.js, Next.js va Nuxt ilovalari.
Node.js loyihalari qanday aniqlanadi va ishga tushiriladi: Node versiyasi, paket menejeri, Next.js va Nuxt (server yoki statik), SvelteKit, Astro, Express va boshqalar, PORT oʻzgaruvchisi va Prisma migratsiyalari.
package.json fayli bor repozitoriy — bu Node.js loyihasi. Biz freymvork, paket menejeri va Node versiyasini tanlaymiz, loyihani yigʻamiz va ishga tushiramiz — sizdan faqat push qilish talab etiladi.
Node versiyasi va paket menejeri
- Node.js —
package.jsondagiengines.nodeyoki.nvmrcdan olinadi: 24, 22, 20, 18 yoki 16 dan mos keladigan eng yangisi. Ikkalasi ham boʻlmasa — Node.js 22. - Paket menejeri — lock-faylga qarab:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, aks holda npm (package-lock.jsonboʻlsa,npm ci). - Yigʻish — agar
package.jsondabuildskripti boʻlsa, u ishga tushiriladi.
Freymvorklar
| Freymvork | Qanday ishlaydi |
|---|---|
| Next.js | server sifatida (next start) — server rendering, API yoʻllari va middleware odatdagidek ishlaydi |
Next.js va output: 'export' | out papkasidan statik sayt sifatida |
| Nuxt | server sifatida (.output/server/index.mjs) |
Nuxt va ssr: false hamda generate skripti | .output/public papkasidan statik sayt sifatida |
| SvelteKit | adapter-node bilan server sifatida; adapter-static bilan statik sayt sifatida |
| Astro | statik sayt sifatida; @astrojs/node bilan server sifatida |
| NestJS | yigʻishdan keyin dist/main.js |
| Express, Fastify, Koa, Hono va boshqa serverlar | scripts.start dagi fayl (node server.js), u boʻlmasa main, u ham boʻlmasa server.js, app.js, index.js yoki main.js |
Faqat frontenddan iborat loyihalar — Vite, Create React App, Angular, Vue CLI va boshqalar — statik sayt sifatida beriladi; Statik saytlar maqolasiga qarang.
PORT ni tinglang
Server PORT oʻzgaruvchisidagi portni barcha interfeyslarda tinglashi kerak:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js va Nuxt buni oʻzi qiladi. Agar ilovangiz qatʼiy belgilangan portni tinglasa, unga tashrifchilar yetib bormaydi — bunda deploy ishga tushirish tekshiruvida toʻxtaydi va oldingi versiya ishlashda davom etadi.
Yigʻish vaqtidagi qiymatlar
Oʻzgaruvchilar boʻlimidagi oʻzgaruvchilar yigʻish jarayoniga emas, ishlab turgan ilovaga yetib boradi. Yigʻish mijoz kodiga yozib qoʻyadigan qiymatlar — masalan, Next.js dagi NEXT_PUBLIC_… yoki VITE_… — repozitoriyingizdan oʻqiladi, masalan, commit qilingan .env.production faylidan. Server tomonidagi kod esa odatdagidek Oʻzgaruvchilar boʻlimini oʻqiydi.
Oʻz ishga tushirish buyrugʻingiz
Agar avtomatik aniqlangan ishga tushirish usuli sizga mos kelmasa, Sozlamalar → Yigʻish sozlamalari → Ishga tushirish buyrugʻi ni belgilang, masalan, node dist/server.js yoki npm run start:prod. Oʻrnatish va yigʻish buyruqlarini ham shu yerda oʻzgartirish mumkin.
Maʼlumotlar bazalari va Prisma
Loyihaga PostgreSQL yoki MySQL qoʻshing va DATABASE_URL ni oʻqing — u siz uchun oʻrnatiladi. Bogʻliqliklaringizda Prisma boʻlsa, tavsiya etilgan reliz buyrugʻi — npx prisma migrate deploy: u har bir deployda yangi versiya tashrifchilarni qabul qilishidan oldin bajariladi. Deploylar maqolasiga qarang.
BullMQ navbatlari uchun Valkey qoʻshing va REDIS_URL dan foydalaning. Navbat workerini fon workeri sifatida ishga tushiring — Jarayonlar boʻlimida yoki oʻz resurslariga ega alohida xizmat sifatida. Loyiha xizmatlari maqolasiga qarang.
Deploydan keyin ham saqlanadigan fayllar
Har bir deploy repozitoriyingizning yangi nusxasidan boshlanadi. Ilovangiz /data papkasiga yozgan fayllar deploylar oraligʻida saqlanadi va har kuni zaxiralanadi; boshqa joyga yozilgan narsalar keyingi deploydan keyin yoʻqoladi. Yuklangan fayllar va media uchun odatda obyekt ombori yaxshiroq tanlov.
Monorepozitoriylar
Bir nechta loyihali repozitoriy uchun ilovani yaratayotganda Loyiha papkasi ni belgilang (masalan, apps/web). Xuddi shu repozitoriyning boshqa papkasi alohida veb-xizmat sifatida ishlashi mumkin — Loyiha xizmatlari maqolasiga qarang.