Node.js, Next.js және Nuxt қолданбалары.
Node.js жобалары қалай анықталып, іске қосылады: Node нұсқасы, пакет менеджері, Next.js пен Nuxt (сервер немесе статикалық), SvelteKit, Astro, Express және ұқсастары, PORT айнымалысы және Prisma миграциялары.
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.js | out қалтасынан статикалық сайт ретінде |
| Nuxt | сервер ретінде (.output/server/index.mjs) |
ssr: false баптауы және generate скрипті бар Nuxt | .output/public қалтасынан статикалық сайт ретінде |
| SvelteKit | adapter-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). Сол репозиторийдің басқа қалтасын жеке веб-қызмет ретінде іске қосуға болады — Жоба қызметтері мақаласын қараңыз.