Бастау

Node.js, Next.js және Nuxt қолданбалары.

Node.js жобалары қалай анықталып, іске қосылады: Node нұсқасы, пакет менеджері, Next.js пен Nuxt (сервер немесе статикалық), SvelteKit, Astro, Express және ұқсастары, PORT айнымалысы және Prisma миграциялары.

2 МИН ОҚУ

package.json файлы бар репозиторий — Node.js жобасы. Фреймворкті, пакет менеджерін және Node нұсқасын өзіміз таңдап, жобаны құрастырып, іске қосамыз — сізге тек push жасау қалады.

Node нұсқасы және пакет менеджері

  • Node.js — package.json ішіндегі engines.node немесе .nvmrc файлынан алынады: 24, 22, 20, 18 немесе 16 нұсқаларының ішінен сәйкес келетін ең жаңасы. Екеуі де болмаса — Node.js 22.
  • Пакет менеджері — lock-файл бойынша: pnpm-lock.yaml → pnpm, yarn.lock → yarn, әйтпесе npm (package-lock.json болса, npm ci).
  • Құрастыру — package.json ішінде build скрипті болса, сол орындалады.

Фреймворктар

ФреймворкҚалай іске қосылады
Next.jsсервер ретінде (next start) — серверлік рендеринг, API маршруттары және middleware әдеттегідей жұмыс істейді
output: 'export' баптауы бар Next.jsout қалтасынан статикалық сайт ретінде
Nuxtсервер ретінде (.output/server/index.mjs)
ssr: false баптауы және generate скрипті бар Nuxt.output/public қалтасынан статикалық сайт ретінде
SvelteKitadapter-node болса, сервер ретінде; adapter-static болса, статикалық сайт ретінде
Astroстатикалық сайт ретінде; @astrojs/node болса, сервер ретінде
NestJSқұрастырудан кейін dist/main.js
Express, Fastify, Koa, Hono және басқа серверлерscripts.start ішіндегі файл (node server.js), болмаса main, болмаса server.js, app.js, index.js немесе main.js

Тек фронтендтен тұратын жобалар — Vite, Create React App, Angular, Vue CLI және басқалары — статикалық сайт ретінде беріледі; Статикалық сайттар мақаласын қараңыз.

PORT портын тыңдаңыз

Сервер PORT айнымалысындағы портты барлық интерфейстерде тыңдауы керек:

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

Next.js пен Nuxt мұны өздері жасайды. Қолданбаңыз тұрақты портты тыңдаса, оған келушілер жетпейді — бұл жағдайда жариялау іске қосу тексеруінде тоқтайды, ал алдыңғы нұсқа жұмысын жалғастырады.

Құрастыру кезіндегі мәндер

Айнымалылар қойындысындағы айнымалылар құрастыруға емес, жұмыс істеп тұрған қолданбаға жетеді. Құрастыру клиенттік кодқа жазатын мәндер — мысалы, Next.js-тегі NEXT_PUBLIC_… немесе VITE_… — репозиторийіңізден, мысалы, коммитке енгізілген .env.production файлынан оқылады. Серверлік код Айнымалылар қойындысын әдеттегідей оқиды.

Өз іске қосу командаңыз

Анықталған іске қосу тәсілі сізге сай келмесе, Баптаулар → Құрастыру баптаулары → Іске қосу командасы өрісін толтырыңыз, мысалы node dist/server.js немесе npm run start:prod. Орнату және құрастыру командаларын да сол жерде өзгертуге болады.

Дерекқорлар және Prisma

Жобаға PostgreSQL немесе MySQL қосып, DATABASE_URL айнымалысын оқыңыз — ол сіз үшін орнатылады. Тәуелділіктеріңізде Prisma болса, ұсынылатын релиз командасы — npx prisma migrate deploy: ол әр жариялауда жаңа нұсқа келушілерді қабылдамас бұрын орындалады. Жариялау мақаласын қараңыз.

BullMQ кезектері үшін Valkey қосып, REDIS_URL пайдаланыңыз. Кезек воркерін фондық воркер ретінде іске қосыңыз — Процестер қойындысында немесе өз ресурстары бар жеке қызмет ретінде. Жоба қызметтері мақаласын қараңыз.

Жариялаудан кейін сақталатын файлдар

Әр жариялау репозиторийіңіздің жаңа көшірмесінен басталады. Қолданбаңыз /data қалтасына жазатын файлдар жариялаулар арасында сақталады және күн сайын сақтық көшірмесі жасалады; басқа жерге жазылғанның бәрі келесі жариялаудан кейін жоғалады. Жүктелген файлдар мен медиа үшін әдетте объектілік қойма тиімдірек.

Монорепозиторийлер

Бірнеше жобасы бар репозиторий үшін қолданбаны жасау кезінде Жоба қалтасы өрісін көрсетіңіз (мысалы, apps/web). Сол репозиторийдің басқа қалтасын жеке веб-қызмет ретінде іске қосуға болады — Жоба қызметтері мақаласын қараңыз.

Әлі де сұрақтарыңыз бар ма?

Бізге чатқа жазыңыз — AI бірден жауап береді, қажет болса тәуліктің кез келген уақытында инженер қосылады.

Қолдау қызметіне жазу