ServBay Belgeleri: Projeniz, Scriptiniz ve Web Siteniz için Özgül Node.js Sürümü Ayarlama

ServBay, güçlü bir yerel web geliştirme ortamı olarak Node.js de dahil olmak üzere birçok programlama dili ve teknoloji yığınını destekler. Gerçek geliştirici uygulamalarında, farklı projeleriniz, tekil scriptleriniz ya da tüm web siteniz için belirli bir Node.js sürümünü kullanmanız gerekebilir. Örneğin, eski bir projeniz Node.js 14’e bağımlı olabilirken, yeni bir projeniz Node.js 20’nin yeniliklerine ihtiyaç duyabilir. ServBay, bu ihtiyaçları esnek biçimde karşılamanın yollarını sunar.

Bu dokümanda, ServBay’de Node.js scriptleri ve web siteleri için özel bir Node.js sürümünü kolayca nasıl belirleyeceğinizi ve proje bazında nasıl konfigürasyon yapabileceğinizi tüm ayrıntılarıyla bulacaksınız.

Projeye Özgü Node.js Sürümü ve Konfigürasyon için .servbay.config Dosyasını Kullanma

Node.js sürümü ve ilgili ortam değişkenlerini sıkı şekilde kontrol etmeniz gereken projeler için ServBay, proje seviyesinde özel ayarlama imkanı sunar. Bunu projenizin kök dizininde bir .servbay.config dosyası oluşturarak yapabilirsiniz. Bu dosya ile projenizin Node.js çalışma sürümünü, paket yöneticisi depolarını, önbellek dizinlerini ve diğer ilgili ayarları özelleştirerek proje ortamınızın izole ve tutarlı olmasını sağlayabilirsiniz.

Belirli Node.js sürümü, npm/yarn deposu ve cache dizinini ayarlayan bir .servbay.config dosyası örneği şu şekildedir:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Örnek: özel mirror adresi kullanımı
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Örnek: özel mirror adresi kullanımı
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Örnek: önbellek klasörü belirleme
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Örnek: önbellek klasörü belirleme

Açıklama:

• NODE_VERSION: Bu projenin kullanacağı ana Node.js sürümünü belirtir. ServBay, mevcut kurulu olan ve bu sürümle uyumlu Node.js'i bulur ve kullanır.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Proje kapsamında npm veya yarn paket yöneticisinin kullanacağı depo adresini tanımlar.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Projede kullanılacak npm veya yarn’ın önbellek klasörlerini tanımlar. Yukarıdaki örnekte, ServBay’in varsayılan geçici dizininin alt klasörleri kullanılmıştır: /Applications/ServBay/tmp/.

Genellikle, .servbay.config dosyanızı projenizin kök dizinine yerleştirmeniz önerilir. Detaylı ayar ve kullanımlar için ServBay resmi dokümantasyonundaki .servbay.config Dosyası bölümüne göz atabilirsiniz.

Komut Satırı ile Belirli Node.js Sürümü ile Script Çalıştırmak

Proje bazında Node.js sürümünü ayarlamak istemiyor ve yalnızca belirli bir sürümle script veya komut çalıştırmak istiyorsanız, ServBay’in sunduğu komut satırı kısayollarından yararlanabilirsiniz.

ServBay’in terminal ortamında (ServBay uygulaması üzerinden terminal başlatabilirsiniz), node-<sürüm> komutunu kullanarak scriptler için kullanılacak Node.js sürümünü kolayca seçebilirsiniz. ServBay, yüklü olan her Node.js sürümü için bu şekilde bir takma ad oluşturur.

Örneğin, script.js scriptini Node.js 14 ile çalıştırmak için:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Örnek çıktı, sürüm değişebilir

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Örnek çıktı, sürüm değişebilir

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Örnek çıktı, sürüm değişebilir

Açıklama

• $ node-14 script.js: ServBay’de kurulu olan Node.js 14 (14.x.x) sürümüyle script.js çalıştırılır.
• $ node-16 script.js: ServBay’de kurulu olan Node.js 16 sürümüyle scripti çalıştırır.
• $ node-20 script.js: ServBay’de kurulu olan Node.js 20 sürümüyle çalıştırır.

Bu yöntemle, farklı Node.js sürümleriyle uyumluluk testleri yapabilir, belirli sürüm gerektiren işleri hızlıca gerçekleştirebilirsiniz ve global Node.js sürümünü değiştirmeye gerek kalmaz.

ServBay Yönetici Paneli ile Web Sitesi için Node.js Sürümü Seçmek

ServBay, yönetici paneli üzerinden barındırdığınız web sitelerine varsayılan Node.js sürümünü kolayca atamanıza olanak tanır. Özellikle, Node.js’i arka uçta kullanan (ör. kimi frameworklerle, Caddy veya Nginx reverse proxy ile çalışan) veya belirli Node.js ortamı gerektiren web siteleri için bu işlev çok kullanışlıdır.

Adımlar

1. ServBay Yönetici Panelini Açın: ServBay uygulamasını başlatın ve tarayıcıda yönetici arayüzüne gidin (http://localhost:5200 veya uygulama ana penceresindeki ilgili bağlantı).

2. Site Yönetimine Gidin: Sol navigasyon menüsünden Web Sitesi (Sites) bölümünü seçin.

3. Siteyi Seçin ve Düzenleyin: Listede ayar yapmak istediğiniz web sitesini bulun (örneğin, /Applications/ServBay/www/servbay.demo klasöründe oluşturduğunuz site). İlgili satırdaki düzenleme butonuna (genellikle dişli ya da kalem simgesi) veya doğrudan site ismine tıklayarak detay sayfasına girin.

4. Node.js Sürümünü Ayarlayın: Site ayarları sayfasında Node.js ile ilgili sürüm seçme bölümünü bulun (genellikle açılır menüdür). İstediğiniz Node.js sürümünü seçin.

5. Değişiklikleri Kaydedin: Sürümü seçtikten sonra sayfanın altında Kaydet ya da Uygula butonuna basarak değişikliklerinizi kaydedin.

6. Siteyi veya ServBay'i Yeniden Başlatın (Gerekliyse): Bazı ayarlar, ilgili web sunucunun (Caddy veya Nginx gibi) ya da ServBay’in tamamen yeniden başlatılmasını gerektirebilir. ServBay size gerekli olduğunda bir uyarı gösterecektir.

Dikkat Edilmesi Gerekenler

• Node.js Sürümü Kurulu ve Çalışır Durumda Olmalı: Site ayarlarında seçmek istediğiniz Node.js sürümü, ServBay’in Paketler (Packages) sayfasında yüklü ve çalışıyor olmalıdır. Kurulu değilse veya çalışmıyorsa, önce Paketler sayfasından yükleyip başlatmalısınız.
• Site Tipi: Bu özellik, arka uçta Node.js kullanan (ör. Express.js, Next.js, NestJS vb. frameworklerle geliştirilen) uygulamalardaki web siteleri için geçerlidir. Tamamen statik siteler ya da sadece PHP/Python/Go gibi dillerle çalışan sitelerde bir etkisi olmayabilir.
• Uyumluluk Testleri: Site için Node.js sürümünü değiştirdikten sonra, tüm işlevselliğin doğru çalıştığına emin olmak için kapsamlı test yapmalısınız. Tüm bağımlılık ve servislerin seçili sürümle uyumlu olduğundan emin olun.
• .servbay.config ile İlişki: Site düzeyindeki sürüm, bir varsayılan sağlar. Eğer site dizininde .servbay.config dosyası ve orada NODE_VERSION belirtilmişse, genellikle proje seviyesindeki (yani .servbay.config içeriği) ayar daha yüksek önceliğe sahiptir ve site düzeyindeki ayarı geçersiz kılar.

Sonuç

ServBay, kapsamlı bir yerel geliştirme ortamı olarak Node.js çalışma ortamınızı yönetmek ve belirlemek için birden fazla esnek ve güçlü yol sunar. Projenizin kök dizinindeki .servbay.config dosyası ile ayrıntılı, proje bazlı kontrol ve ortam değişkeni ayarı yapabilir; komut satırında node-<sürüm> kısayolu ile istediğiniz Node.js sürümüyle scriptlerinizi hızlıca çalıştırabilir veya yönetici panelinden web siteniz için varsayılan Node.js sürümünü kolayca atayabilirsiniz. Bu olanaklar sayesinde, farklı projeler ve ihtiyaçlar için gereken Node.js sürümünü seçmek, eski projelere uyumluluk sağlamak, yeni özellikleri test etmek ve yerel-üretim ortamı tutarlılığını korumak artık çok kolay. ServBay, geliştirme verimliliğinizi ve ortam yönetimi yeteneklerinizi önemli ölçüde ileri taşıyacaktır.