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 (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-ით — როგორც სერვერი |
| 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_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). იმავე რეპოზიტორის სხვა საქაღალდე შეიძლება ცალკე ვებ-სერვისად გაეშვას — იხ. პროექტის სერვისები.