Node.js, Next.js ve Nuxt uygulamaları.
Node.js projeleri nasıl algılanır ve başlatılır: Node sürümü, paket yöneticisi, Next.js ve Nuxt (sunucu veya statik), SvelteKit, Astro, Express ve benzerleri, PORT değişkeni ve Prisma migration'ları.
package.json içeren bir depo bir Node.js projesidir. Framework'ü, paket yöneticisini ve Node sürümünü seçer, derler ve başlatırız — siz yalnızca push'larsınız.
Node sürümü ve paket yöneticisi
- Node.js —
package.jsoniçindekiengines.nodedeğerinden veya.nvmrcdosyasından alınır: 24, 22, 20, 18 veya 16 arasından uyan en yenisi. İkisi de yoksa Node.js 22. - Paket yöneticisi — kilit dosyasına göre:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, aksi halde npm (package-lock.jsonvarsanpm ci). - Derleme —
package.jsoniçinde varsabuildbetiği.
Framework'ler
| Framework | Nasıl çalışır |
|---|---|
| Next.js | sunucu olarak (next start) — sunucu tarafı oluşturma, API rotaları ve middleware her zamanki gibi çalışır |
output: 'export' ile Next.js | out klasöründen statik site olarak |
| Nuxt | sunucu olarak (.output/server/index.mjs) |
ssr: false ve bir generate betiğiyle Nuxt | .output/public klasöründen statik site olarak |
| SvelteKit | adapter-node ile sunucu olarak; adapter-static ile statik site olarak |
| Astro | statik site olarak; @astrojs/node ile sunucu olarak |
| NestJS | derlemeden sonra dist/main.js |
| Express, Fastify, Koa, Hono ve diğer sunucular | scripts.start içindeki dosya (node server.js), yoksa main, yoksa server.js, app.js, index.js veya main.js |
Yalnızca ön yüzden oluşan projeler — Vite, Create React App, Angular, Vue CLI ve diğerleri — statik site olarak sunulur; bkz. Statik siteler.
PORT üzerinde dinleyin
Bir sunucu, PORT değişkenindeki portta, tüm arayüzlerde dinlemelidir:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js ve Nuxt bunu kendileri yapar. Uygulamanız sabit bir portta dinliyorsa ziyaretçi almaz — yayına alma bu durumda başlangıç kontrolünde durur ve önceki sürüm çalışmaya devam eder.
Derleme zamanı değerleri
Değişkenler sekmesindeki değişkenler derlemeye değil, çalışan uygulamaya ulaşır. Derlemenin istemci koduna yazdığı değerler — Next.js'teki NEXT_PUBLIC_… veya VITE_… gibi — deponuzdan, örneğin commit edilmiş bir .env.production dosyasından okunur. Sunucu tarafı kod Değişkenler sekmesini her zamanki gibi okur.
Kendi başlatma komutunuz
Algılanan başlatma istediğiniz gibi değilse Ayarlar → Derleme ayarları → Başlatma komutu'nu ayarlayın, örneğin node dist/server.js veya npm run start:prod. Kurulum ve derleme komutları da orada değiştirilebilir.
Veritabanları ve Prisma
Projeye PostgreSQL veya MySQL ekleyin ve DATABASE_URL değerini okuyun — sizin için ayarlanır. Bağımlılıklarınızda Prisma varsa önerilen yayın komutu npx prisma migrate deploy'dur: her yayına almada, yeni sürüm ziyaretçi almadan önce çalışır. Bkz. Yayına almalar.
BullMQ ile kuyruklar için Valkey ekleyin ve REDIS_URL kullanın. Kuyruk işçisini bir arka plan işçisi olarak çalıştırın — Süreçler sekmesinde ya da kendi kaynakları olan ayrı bir servis olarak. Bkz. Bir projenin servisleri.
Bir yayına almadan sonra da kalan dosyalar
Her yayına alma, deponuzun yeni bir kopyasından başlar. Uygulamanızın /data klasörüne yazdığı dosyalar yayına almalar arasında korunur ve günlük yedeklenir; başka bir yere yazılan her şey bir sonraki yayına almadan sonra gider. Yüklemeler ve medya için genellikle nesne depolama daha iyi bir seçimdir.
Monorepo'lar
Birkaç proje içeren bir depo için uygulamayı oluştururken Proje klasörünü ayarlayın (örneğin apps/web). Aynı deponun başka bir klasörü ayrı bir web servisi olarak çalışabilir — bkz. Bir projenin servisleri.