Plesk Panel Üzerinde Node.js Uygulaması Yayına Alma

Plesk Panel, web hosting yönetiminde popüler bir araçtır ve Node.js uygulamalarını kolayca yayına almanızı sağlar. Bu panel, geliştiricilere sunucu yapılandırması olmadan hızlı deploy imkanı sunar. Node.js’in asenkron yapısı sayesinde yüksek performanslı uygulamalar geliştirebilirsiniz. Bu makalede, Plesk üzerinden bir Node.js uygulamasını adım adım yayına alma sürecini inceleyeceğiz. Süreç, extension yüklemeden başlayarak uygulama başlatma ve izlemeye kadar uzanır. Bu rehber, kurumsal ortamlar için optimize edilmiş pratik adımları içerir ve olası sorunlara karşı önlemler sunar.

Plesk Panelini Node.js İçin Hazırlama

Plesk Paneli Node.js desteği için öncelikle gerekli uzantıları yüklemeniz gerekir. Plesk’in güncel sürümlerinde Node.js extension’ı mevcut olup, bu sayede birden fazla Node.js sürümünü yönetebilirsiniz. Panel arayüzünden Extensions bölümüne giderek Node.js’i arayın ve yükleyin. Yükleme tamamlandıktan sonra, domain’iniz altında Node.js uygulamasını etkinleştirebilirsiniz. Bu adım, sunucunuzun Node.js runtime’ını hazır hale getirir ve ek bağımlılıkları otomatik yönetir.

Hazırlık aşamasında, sunucu kaynaklarını gözden geçirin. Node.js uygulamaları bellek yoğun olabilir, bu yüzden en az 1 GB RAM ayrılmış hosting planı önerilir. Ayrıca, firewall kurallarını kontrol edin; varsayılan olarak 3000 gibi portlar Node.js için ayrılır. Plesk, bu portları otomatik proxy’ler ve yönetir, böylece uygulamanız standart 80/443 portlarından erişilebilir hale gelir.

Node.js Extension Yükleme Adımları

Extensions > My Extensions’a gidin ve Node.js’i bulun. Yükleme butonuna tıklayın; işlem birkaç dakika sürer. Yükleme sonrası, domain listenizde Node.js sekmesi görünür. Bu sekmede sürüm seçimi yapın, örneğin LTS olan 18.x veya 20.x. Seçim sonrası, panel Node.js’i domain root’una kurar ve PATH değişkenini günceller. Bu işlem, npm ve npx gibi araçları da hazırlar. Potansiyel hata durumunda, sunucu loglarını Extensions > Logs’tan inceleyin ve gerekirse yeniden başlatın. Bu adımla, ortamınız production-ready olur ve bağımlılık çakışmalarını önlersiniz.

Gerekli Sistem Paketlerini Kurma

Plesk Obsidian 18+ sürümlerde çoğu paket önceden yüklüdür, ancak emin olmak için SSH erişimiyle sunucuya bağlanın. Komut satırında sudo apt update && sudo apt install build-essential çalıştırın (Debian/Ubuntu için). Node.js native modülleri için Python ve make gerekebilir. Plesk’te Node.js sekmesinden “NPM Install” butonuyla package.json’u otomatik işleyin. Bu, global bağımlılıkları domain izolasyonunda tutar ve güvenlik sağlar. Kurulum sonrası, node -v ile doğrulanır; çıktı sürümünüzü gösterir. Bu detaylı hazırlık, deploy sırasında kesintileri minimize eder ve ölçeklenebilirlik sağlar.

Node.js Uygulamasını Yükleme ve Yapılandırma

Uygulamanızı Plesk’e yüklemek için Git entegrasyonu veya dosya yöneticisi kullanın. Git tercih edin zira Plesk Git extension’ı ile repository’nizi doğrudan clone edebilirsiniz. Domain > Git sekmesinden repository URL’sini ekleyin ve branch’i master/main olarak ayarlayın. Deploy sonrası, Node.js sekmesine geçerek uygulama kök dizinini belirtin (genellikle /httpdocs). package.json dosyanızın “start” script’ini tanımlayın, örneğin “node server.js”. Bu yapılandırma, uygulamanızın otomatik parse edilmesini sağlar.

1. Dosya yöneticisinden uygulamanızı ZIP olarak yükleyin ve çıkarın.
2. Node.js sekmesinde “Install dependencies” butonuna tıklayın; npm install çalışır.
3. Ortam değişkenlerini ekleyin, örneğin PORT=3000 veya veritabanı bağlantıları.

Bu adımlar, uygulamanızı izolasyonlu hale getirir. Plesk, her domain için ayrı Node.js instance’ı yönetir, böylece çakışma olmaz. Yapılandırma sonrası, uygulama loglarını gerçek zamanlı izleyin.

Uygulamayı Yayına Alma ve İzleme

Yayına alma için Node.js sekmesindeki “Start” butonuna tıklayın. Plesk, PM2 process manager’ı kullanarak uygulamanızı daemon olarak çalıştırır. PM2, crash recovery ve clustering sağlar; örneğin pm2 start ecosystem.config.js ile özelleştirin. Uygulama başladıktan sonra, domain URL’nizi tarayıcıda test edin. Proxy ayarları otomatik olduğundan, HTTPS desteği dahil çalışır. İzleme için Plesk Metrics entegrasyonu kullanın; CPU, bellek ve response time’ları grafiklerle görün.

Otomatik Başlatma ve Yeniden Başlatma

Node.js sekmesinde “Restart App on Reboot” seçeneğini etkinleştirin. Bu, sunucu yeniden başladığında uygulamanızı otomatik yükler. PM2 cluster mode’u için ecosystem.config.js oluşturun: module.exports = { apps: [{ name: ‘app’, script: ‘server.js’, instances: ‘max’, exec_mode: ‘cluster’ }] }. Deploy sonrası pm2 reload yapın. Bu konfigürasyon, yüksek trafikli kurumsal uygulamalarda %30’a varan performans artışı sağlar. Log rotasyonu için PM2’nin out_file ve error_file ayarlarını domain log dizinine yönlendirin, böylece depolama sorunları önlenir.

Hata Ayıklama ve Performans Optimizasyonu

Hatalarda, Node.js > Logs sekmesinden stdout/stderr inceleyin. Yaygın sorunlar: port çakışması (Plesk otomatik çözer) veya eksik modül (npm rebuild). Debug için NODE_ENV=development ayarlayın ve nodemon entegre edin. Optimizasyon adına, compression middleware ekleyin (örneğin express-compression) ve cluster’ı etkinleştirin. Plesk’te resource limits belirleyin; bellek limitini 512MB yapın. Düzenli güncellemeler için Git hook’ları kurun, deploy sonrası otomatik restart tetikleyin. Bu pratikler, uygulamanızın 99.9% uptime’ına ulaşmasını sağlar ve bakım yükünü azaltır.

Sonuç olarak, Plesk Panel üzerinden Node.js uygulaması yayına almak, geliştiriciler için verimli bir süreçtir. Bu adımları takip ederek, güvenli ve ölçeklenebilir bir deployment elde edersiniz. Düzenli log takibi ve güncellemelerle uygulamanızı optimize edin. Kurumsal projelerinizde bu yöntem, zaman tasarrufu ve güvenilirlik sağlar; her adımda test ederek ilerleyin.