ServBay ile Projelerde Bağımsız Node.js Sürüm Yapılandırma Kılavuzu
ServBay, entegre bir geliştirme ortamı olarak, çoklu Node.js sürümlerinin paralel yönetimini ve hızlı geçişini yerel olarak destekler. Bu, geleneksel araçların (NVM veya Docker gibi) karmaşıklık ve kaynak tüketimi sorunlarını çözer. Aşağıda yaygın senaryolar için tamamlayıcı yapılandırma planları bulunmaktadır:
.servbay.config
ile Proje Düzeyinde Versiyon Kontrolü
1. Temel Prensip
ServBay, macOS (arm64/x86_64) üzerinde Node.js v12’den v23’e kadar tüm ana sürümleri önceden yüklemiştir ve her proje, yapılandırma dosyası aracılığıyla gerekli sürümü dinamik olarak bağlayabilir.
Avantajlar:
• Manuel kurulum veya derleme gerektirmez, sürüm çatışmalarını önler
• Birden fazla sürümün eşzamanlı çalışmasını destekler (örneğin, Proje A Node 18, Proje B Node 22 kullanır)
• PHP, veritabanları gibi hizmetlerle bağımsızdır, bağımsız çalışma ortamı sistemi kirletmez
2. Yapılandırma Adımları
Adım 1: Yapılandırma Dosyası Oluşturma
Proje ana dizininde yeni bir .servbay.config
dosyası oluşturun ve aşağıdaki içeriği ekleyin:
NODE_VERSION=20 # Node.js 20.x’i belirtir
# İsteğe bağlı: npm/pnpm ayna yapılandırması (ör. ağ hızlandırma)
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache
2
3
4
5
Adım 2: Sürümün Geçerli Olduğunu Doğrulama
$ node -v
v20.12.2 # Yapılandırma dosyasıyla tutarlı olmalıdır
$ npm run dev # Bağımlılık çözümü mevcut Node sürümüne bağlıdır
2
3
3. İleri Düzey Özellikler
• Birden Fazla Sürümün Bir Arada Bulunması: Aynı terminal penceresinde dizin değiştirildiğinde, otomatik olarak ilgili Node.js sürümünü yükler
• Önbellek Yönetimi: NPM_CONFIG_CACHE
ile önbellek dizinini belirleyerek global kirlenmeyi önler
• Araç Zinciri Desteği: npm, pnpm, yarn gibi paket yöneticilerini yerleşik olarak destekler; sürümler Node.js ile sıkı bir şekilde eşleşir
Çalışma Örneği
Aşağıda, .servbay.config
'ın çalışma mekanizmasını gösteren pratik bir örnek bulunmaktadır.