დაწყება

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 (npm ci, თუ package-lock.json არსებობს).
  • აწყობა — სკრიპტი build, თუ ის package.json-შია.

ფრეიმვორკები

ფრეიმვორკიროგორ ეშვება
Next.jsროგორც სერვერი (next start) — სერვერული რენდერინგი, API მარშრუტები და middleware ჩვეულებრივ მუშაობს
Next.js output: 'export'-ითროგორც სტატიკური საიტი out-დან
Nuxtროგორც სერვერი (.output/server/index.mjs)
Nuxt ssr: false-ითა და generate სკრიპტითროგორც სტატიკური საიტი .output/public-დან
SvelteKitროგორც სერვერი adapter-node-ით; adapter-static-ით — როგორც სტატიკური საიტი
Astroროგორც სტატიკური საიტი; @astrojs/node-ით — როგორც სერვერი
NestJSdist/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_PUBLIC_… Next.js-ში ან 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 მაშინვე გპასუხობთ, საჭიროებისას კი ინჟინერი უერთდება, დღე-ღამის ნებისმიერ დროს.

მხარდაჭერასთან დაკავშირება