Hemen başlayın

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ı.

2 DK OKUMA

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.json içindeki engines.node değerinden veya .nvmrc dosyası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.json varsa npm ci).
  • Derleme — package.json içinde varsa build betiği.

Framework'ler

FrameworkNasıl çalışır
Next.jssunucu olarak (next start) — sunucu tarafı oluşturma, API rotaları ve middleware her zamanki gibi çalışır
output: 'export' ile Next.jsout klasöründen statik site olarak
Nuxtsunucu olarak (.output/server/index.mjs)
ssr: false ve bir generate betiğiyle Nuxt.output/public klasöründen statik site olarak
SvelteKitadapter-node ile sunucu olarak; adapter-static ile statik site olarak
Astrostatik site olarak; @astrojs/node ile sunucu olarak
NestJSderlemeden sonra dist/main.js
Express, Fastify, Koa, Hono ve diğer sunucularscripts.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.

Hâlâ takıldınız mı?

Bizimle sohbet edin — AI hemen yanıt verir, gerektiğinde günün her saati bir mühendis katılır.

Destekle iletişime geçin