Node.js’i Rocky Linux 9 Üzerine Kurulum Rehberi

Node.js’i Rocky Linux 9 Üzerine Kurulum Rehberi

Node.js’i Rocky Linux 9 sunucunuza kurmak, modern web uygulamaları geliştirmek ve çalıştırmak için atacağınız önemli bir adımdır. Bu kapsamlı rehberde, Node.js’i Rocky Linux 9’a kurmak için kullanabileceğiniz farklı yöntemleri adım adım inceleyeceğiz. İster sisteminizle birlikte gelen DNF depolarını, ister birden fazla Node.js sürümünü yönetmenizi sağlayan NVM’yi (Node Version Manager) ya da en güncel sürüm için NodeSource depolarını tercih edin, bu rehber size ihtiyacınız olan tüm bilgiyi sunacaktır. Ayrıca, kurulumu doğrulama, versiyonları yönetme ve sıkça karşılaşılan sorunları giderme konularına da değineceğiz.

Giriş: Node.js ve Rocky Linux 9

Node.js, Google Chrome’un V8 JavaScript motoru üzerine inşa edilmiş, açık kaynaklı, sunucu tarafı bir JavaScript çalışma zamanı ortamıdır. Geliştiricilerin JavaScript’i tarayıcı dışında, sunucu tarafı uygulamalar, API’ler, mikro hizmetler ve hatta masaüstü uygulamaları oluşturmak için kullanmalarına olanak tanır. Olay güdümlü, asenkron yapısı sayesinde yüksek performanslı ve ölçeklenebilir ağ uygulamaları geliştirmek için idealdir. Node.js’in popülaritesi, geniş bir paket ekosistemi olan npm (Node Package Manager) ile daha da artmıştır. npm, dünyadaki en büyük yazılım kayıt defterlerinden biridir ve binlerce açık kaynaklı kütüphane ve aracı barındırır.

Rocky Linux 9 ise, Red Hat Enterprise Linux (RHEL) tabanlı, topluluk destekli, kurumsal sınıf bir işletim sistemidir. CentOS Linux’un RHEL tarafından terk edilmesinin ardından ortaya çıkan Rocky Linux, RHEL ile tam uyumluluk ve uzun vadeli destek sunarak sunucu ortamları için güvenilir bir seçenek haline gelmiştir. Kararlılığı, güvenliği ve geniş yazılım desteği ile Rocky Linux 9, Node.js uygulamalarınızı barındırmak için mükemmel bir platform sağlar.

Bu rehberin amacı, Rocky Linux 9 üzerinde Node.js kurulumunu en yaygın ve etkili yöntemlerle adım adım açıklamak, böylece geliştiricilerin ve sistem yöneticilerinin projelerini hızlıca hayata geçirmelerini sağlamaktır.

Ön Gereksinimler

Node.js kurulumuna başlamadan önce aşağıdaki ön gereksinimlerin karşılandığından emin olun:

• Rocky Linux 9 kurulu ve çalışan bir sunucu veya sanal makine.
• sudo yetkilerine sahip bir kullanıcı hesabı. Kurulum işlemleri için yönetici ayrıcalıkları gerekecektir.
• Aktif bir internet bağlantısı. Node.js paketlerini ve bağımlılıklarını indirmek için gereklidir.
• Sistemin güncel olması. En iyi uygulama olarak, herhangi bir yazılım kurulumundan önce sisteminizi güncellemek potansiyel uyumluluk sorunlarını önleyecektir. Bunu aşağıdaki komutla yapabilirsiniz:

  sudo dnf update -y

• Bazı derleme araçları. Özellikle NVM veya NodeSource üzerinden kurulum yaparken, Node.js’in bazı bağımlılıklarını derlemek gerekebilir. Gerekli paketleri önceden kurmak faydalı olabilir:

  sudo dnf install gcc-c++ make -y

Yöntem 1: DNF (AppStream) Kullanarak Node.js Kurulumu

Rocky Linux 9, DNF paket yöneticisi aracılığıyla Node.js’i doğrudan resmi AppStream depolarından kurma imkanı sunar. Bu yöntem, genellikle en basit ve en hızlı kurulum yoludur. Ancak, AppStream depolarındaki Node.js versiyonları, en güncel kararlı sürümden biraz daha eski olabilir. Eğer projeniz belirli bir Node.js versiyonuna sıkı sıkıya bağlı değilse veya en son özellikleri kullanmanız gerekmiyorsa, bu yöntem oldukça pratiktir.

Mevcut Node.js Modüllerini Listeleme

Rocky Linux 9’daki AppStream depoları, Node.js’in farklı versiyonlarını modüller halinde sunar. Hangi versiyonların mevcut olduğunu görmek için aşağıdaki komutu kullanabilirsiniz:

sudo dnf module list nodejs

Bu komutun çıktısı, mevcut Node.js modüllerini ve bunların varsayılan ([d]) olarak işaretlenmiş sürümlerini gösterecektir. Örneğin:

Rocky Linux 9 - AppStream
Name       Stream       Profiles            Summary
nodejs     16           default [d], common Node.js JavaScript runtime
nodejs     18           default [d], common Node.js JavaScript runtime
nodejs     20           default [d], common Node.js JavaScript runtime

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

Yukarıdaki örnekte, Node.js’in 16, 18 ve 20 gibi farklı versiyonları mevcuttur. Her birinin yanında [d] işareti varsa, bu o versiyonun varsayılan olarak seçileceği anlamına gelir.

Belirli Bir Node.js Modülünü Etkinleştirme

Kurmak istediğiniz Node.js versiyonunu seçmek için dnf module enable komutunu kullanmalısınız. Örneğin, Node.js 20’yi kurmak istiyorsanız:

sudo dnf module enable nodejs:20 -y

Bu komut, sisteminize Node.js 20 modülünü etkinleştirecek ve DNF’nin bu versiyonu kurmasını sağlayacaktır. Eğer farklı bir versiyonu etkinleştirmek isterseniz, nodejs:20 yerine nodejs:18 veya nodejs:16 gibi istediğiniz versiyonu yazabilirsiniz.

Node.js ve NPM Kurulumu

Modülü etkinleştirdikten sonra, Node.js ve npm’i kurmak için aşağıdaki komutu çalıştırın:

sudo dnf install nodejs -y

Bu komut, etkinleştirdiğiniz Node.js versiyonunu ve onunla birlikte gelen npm paket yöneticisini sisteminize kuracaktır.

Kurulumu Doğrulama

Kurulum tamamlandıktan sonra, Node.js ve npm versiyonlarını kontrol ederek başarılı bir şekilde kurulduklarından emin olabilirsiniz:

node -v
npm -v

Çıktılar, kurduğunuz Node.js ve npm versiyonlarını göstermelidir.

Yöntem 2: NVM (Node Version Manager) Kullanarak Node.js Kurulumu

NVM (Node Version Manager), Node.js’in farklı versiyonlarını aynı makinede yönetmek için kullanılan popüler bir araçtır. Özellikle birden fazla Node.js projesi üzerinde çalışıyorsanız ve her projenin farklı bir Node.js versiyonu gerektirmesi durumunda NVM hayat kurtarıcıdır. NVM ile kolayca versiyonlar arasında geçiş yapabilir, yeni versiyonları kurabilir veya eski versiyonları kaldırabilirsiniz.

NVM Kurulumu

NVM’yi kurmak için, genellikle curl veya wget komutları ile NVM kurulum betiğini indirip çalıştırmak en yaygın yoldur. En güncel kurulum betiği için NVM’nin GitHub deposunu kontrol etmek her zaman en iyisidir. Aşağıdaki komut, genellikle en güncel NVM sürümünü kurar:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Not: v0.39.7 yerine NVM’nin en güncel sürüm numarasını kullanmanız önerilir. NVM GitHub sayfasından kontrol edebilirsiniz.

Bu betik, NVM’yi kullanıcı dizininize (~/.nvm) kuracak ve NVM’nin kabuğunuzda çalışabilmesi için gerekli ortam değişkenlerini ~/.bashrc, ~/.zshrc veya ~/.profile gibi yapılandırma dosyalarına ekleyecektir.

Kurulum betiği tamamlandıktan sonra, kabuğunuzu yeniden yüklemeniz veya yeni bir terminal oturumu açmanız gerekir, böylece NVM ortam değişkenleri etkinleşir:

source ~/.bashrc   # Bash kullanıyorsanız
source ~/.zshrc    # Zsh kullanıyorsanız
source ~/.profile  # Diğer kabuklar için veya yukarıdakiler işe yaramazsa

NVM’nin doğru bir şekilde kurulduğunu doğrulamak için aşağıdaki komutu çalıştırın:

command -v nvm

Eğer çıktı nvm ise, NVM başarıyla kurulmuştur.

NVM ile Node.js Versiyonlarını Kurma

NVM kurulduktan sonra, Node.js versiyonlarını yönetmeye başlayabilirsiniz.

Mevcut Node.js Versiyonlarını Listeleme:
Uzaktan kurulabilecek Node.js versiyonlarını görmek için:

nvm ls-remote

Bu komut, Node.js’in tüm kararlı ve LTS (Uzun Süreli Destek) versiyonlarını listeleyecektir.

Belirli Bir Node.js Versiyonunu Kurma:
Örneğin, Node.js 20’yi kurmak için:

nvm install 20

Veya belirli bir versiyon numarasını (örn. 20.10.0) kurmak için:

nvm install 20.10.0

NVM, Node.js ile birlikte gelen npm’i de otomatik olarak kuracaktır.

Varsayılan Node.js Versiyonunu Ayarlama:
Kurduğunuz versiyonlardan birini varsayılan olarak ayarlamak için:

nvm alias default 20

Bu, her yeni terminal oturumu açtığınızda otomatik olarak Node.js 20’nin kullanılmasını sağlayacaktır.

Farklı Versiyonlar Arasında Geçiş Yapma:
Mevcut oturumunuzda farklı bir Node.js versiyonuna geçmek için:

nvm use 18

Bu komut, o anki terminal oturumunuzda Node.js 18’i etkinleştirecektir.

Kurulu Node.js Versiyonlarını Görüntüleme:
Sisteminizde kurulu olan tüm Node.js versiyonlarını görmek için:

nvm ls

Kurulumu Doğrulama

NVM ile kurulan Node.js’i doğrulamak için, istediğiniz bir versiyonu kullanıma aldıktan sonra node -v ve npm -v komutlarını çalıştırın:

node -v
npm -v

Çıktılar, o anki aktif Node.js ve npm versiyonlarını göstermelidir.

Yöntem 3: NodeSource Depolarını Kullanarak Node.js Kurulumu

NodeSource, Node.js’in en güncel kararlı versiyonlarını ve LTS (Uzun Süreli Destek) versiyonlarını doğrudan sağlamak için özel DNF/Yum depoları sunar. Bu yöntem, DNF’nin basitliğini korurken, AppStream depolarında bulunmayan en yeni Node.js özelliklerine erişmenizi sağlar. Eğer projeniz en son Node.js özelliklerini veya belirli bir güncel LTS sürümünü gerektiriyorsa, NodeSource depoları ideal bir çözümdür.

NodeSource Depolarını Ekleme

NodeSource depolarını sisteminize eklemek için, Node.js’in hangi ana versiyonunu kurmak istediğinize bağlı olarak farklı bir kurulum betiği çalıştırmanız gerekir. NodeSource’un GitHub sayfasında (github.com/nodesource/distributions) en güncel talimatları bulabilirsiniz.

Örneğin, Node.js 20’yi kurmak için aşağıdaki betiği kullanabilirsiniz:

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

Not: Eğer Node.js 18’i kurmak isterseniz, URL’deki setup_20.x kısmını setup_18.x olarak değiştirmeniz gerekir.

Bu komut:

1. NodeSource kurulum betiğini indirir.
2. sudo bash - komutuyla betiği yönetici ayrıcalıklarıyla çalıştırır.
3. Betiğin çalışması, NodeSource deposunu sisteminizin DNF yapılandırmasına ekler.
4. Gerekli GPG anahtarlarını içe aktarır.

Betiğin çıktısı, deponun başarıyla eklendiğini ve Node.js’i kurmaya hazır olduğunuzu belirtmelidir.

Node.js ve NPM Kurulumu

Depo eklendikten sonra, Node.js ve npm’i standart DNF komutuyla kurabilirsiniz:

sudo dnf install nodejs -y

DNF, artık NodeSource deposundan en güncel Node.js ve npm paketlerini indirecek ve kuracaktır.

Kurulumu Doğrulama

Kurulum tamamlandıktan sonra, Node.js ve npm versiyonlarını kontrol ederek başarılı bir şekilde kurulduklarından emin olabilirsiniz:

node -v
npm -v

Çıktılar, NodeSource deposundan kurduğunuz Node.js ve npm versiyonlarını göstermelidir.

NodeSource Deposunu Kaldırma (İsteğe Bağlı)

Eğer ileride NodeSource deposunu sisteminizden kaldırmak isterseniz, ilgili DNF depo dosyasını silebilirsiniz:

sudo rm /etc/yum.repos.d/nodesource-*.repo

Bu işlemden sonra, sisteminiz NodeSource deposundan paket aramayacaktır.

Node.js Kurulumunu Doğrulama

Hangi yöntemi kullanırsanız kullanın, Node.js ve npm’in doğru bir şekilde kurulduğunu doğrulamak önemlidir.

Versiyon Kontrolü

Terminalinizde aşağıdaki komutları çalıştırın:

node -v
npm -v

Bu komutlar, sırasıyla Node.js ve npm’in yüklü versiyonlarını göstermelidir. Örneğin:

v20.10.0
10.2.3

Basit Bir Node.js Uygulaması Çalıştırma

Kurulumunuzu daha kapsamlı bir şekilde test etmek için basit bir Node.js uygulaması oluşturup çalıştırabilirsiniz.

1. Yeni bir dosya oluşturun, örneğin app.js:

nano app.js

2. Dosyanın içine aşağıdaki kodu yapıştırın:

// app.js
    const http = require('http');

    const hostname = '127.0.0.1';
    const port = 3000;

    const server = http.createServer((req, res) => {
      res.statusCode = 200;
      res.setHeader('Content-Type', 'text/plain');
      res.end('Merhaba Node.js! Rocky Linux 9 Uzerinde Calisiyorum!\n');
    });

    server.listen(port, hostname, () => {
      console.log(Sunucu http://${hostname}:${port}/ adresinde calisiyor.);
    });

3. Dosyayı kaydedin ve kapatın (Nano’da Ctrl+X, Y ve Enter).
4. Uygulamayı çalıştırmak için Node.js’i kullanın:

node app.js

5. Terminalinizde “Sunucu http://127.0.0.1:3000/ adresinde calisiyor.” mesajını görmelisiniz.
6. Başka bir terminal açın veya mevcut terminalde Ctrl+C ile sunucuyu durdurmadan önce, curl komutuyla sunucuya bir istek gönderin:

curl http://127.0.0.1:3000

7. Çıktı olarak “Merhaba Node.js! Rocky Linux 9 Uzerinde Calisiyorum!” görmelisiniz. Bu, Node.js’in düzgün çalıştığını gösterir.
8. Sunucuyu durdurmak için ilk terminalde Ctrl+C tuşlarına basın.

Node.js Versiyonlarını Yönetme (Özellikle NVM ile)

Eğer NVM ile kurulum yaptıysanız, Node.js versiyonlarını yönetmek oldukça kolaydır. İşte bazı temel NVM komutları:

* Yeni bir Node.js versiyonu kurma:

nvm install <versiyon_numarası>

Örnek: nvm install 16 veya nvm install 20.10.0
* Belirli bir versiyonu kullanma (mevcut oturum için):

nvm use <versiyon_numarası>

Örnek: nvm use 16
* Kurulu tüm Node.js versiyonlarını listeleme:

nvm ls

* Varsayılan Node.js versiyonunu ayarlama (yeni oturumlar için):

nvm alias default <versiyon_numarası>

Örnek: nvm alias default 20
* Bir Node.js versiyonunu kaldırma:

nvm uninstall <versiyon_numarası>

Örnek: nvm uninstall 16
* NPM paketlerini güncelleme:
Node.js ile birlikte gelen npm, bazen Node.js’in kendisinden daha yeni bir sürüm gerektirebilir. npm’i en son sürümüne güncellemek için:

npm update -g npm

Sıkça Karşılaşılan Sorunlar ve Çözümleri

Node.js kurulumu sırasında veya sonrasında bazı yaygın sorunlarla karşılaşabilirsiniz. İşte bunlardan bazıları ve olası çözümleri:

PATH Sorunları (NVM Kullanırken)

Sorun: NVM ile Node.js kurduktan sonra node veya npm komutlarını çalıştırdığınızda “command not found” hatası alıyorsunuz.
Çözüm: Bu genellikle NVM’nin ortam değişkenlerinin mevcut kabuk oturumunuzda yüklenmediği anlamına gelir. NVM kurulum betiği tarafından ~/.bashrc, ~/.zshrc veya ~/.profile dosyalarınıza eklenen satırların doğru olduğundan ve kabuğunuzu yeniden yüklediğinizden emin olun.

source ~/.bashrc   # veya kullandığınız kabuk yapılandırma dosyası

Ayrıca, doğru Node.js versiyonunu kullandığınızdan emin olmak için nvm use komutunu çalıştırmayı unutmayın.

Yetersiz İzinler (EACCES Hatası)

Sorun: npm install -g ile global bir paket kurmaya çalışırken EACCES veya “Permission denied” hatası alıyorsunuz.
Çözüm: Bu, npm’in global paketleri yüklemeye çalıştığı dizine yazma izniniz olmadığı anlamına gelir.

1. Yöntem 1 (Önerilmez, ancak hızlı çözüm): Komutu sudo ile çalıştırmak.

   sudo npm install -g <paket_adı>

   Bu, izin sorununu çözebilir ancak sudo ile npm paketleri kurmak güvenlik riskleri taşıyabilir ve önerilen bir uygulama değildir.

2. Yöntem 2 (Önerilen): npm’in global paketleri kullanıcı dizininize kurmasını sağlamak.

   npm config set prefix '~/.npm-global'

   Ardından, bu dizini PATH ortam değişkeninize eklemeniz gerekir. ~/.bashrc veya ~/.zshrc dosyanıza aşağıdaki satırı ekleyin:

   export PATH=~/.npm-global/bin:$PATH

   Dosyayı kaydedin ve kabuğunuzu yeniden yükleyin (source ~/.bashrc). Artık sudo kullanmadan global paketler kurabilirsiniz.

Derleme Hataları (node-gyp Hataları)

Sorun: Bazı npm paketlerini kurarken (özellikle C++ eklentileri içerenler) node-gyp ile ilgili derleme hataları alıyorsunuz.
Çözüm: Bu hatalar genellikle Node.js’in bağımlılıklarını derlemek için gerekli olan geliştirme araçlarının (derleyici, make vb.) eksik olmasından kaynaklanır. Gerekli araçları kurmak için:

sudo dnf install gcc-c++ make -y

Depo Çakışmaları (DNF/NodeSource)

Sorun: Hem AppStream’den hem de NodeSource’dan Node.js kurmaya çalıştığınızda veya farklı NodeSource versiyonlarını eklediğinizde bağımlılık veya versiyon çakışmaları yaşıyorsunuz.
Çözüm: DNF tabanlı kurulumlarda yalnızca tek bir Node.js kaynağını (AppStream veya NodeSource’un belirli bir versiyonu) etkin tutmak en iyisidir.

1. Mevcut tüm Node.js modüllerini devre dışı bırakın:

   sudo dnf module reset nodejs -y

2. Eğer NodeSource deposu eklediyseniz, depo dosyasını kaldırın:

   sudo rm /etc/yum.repos.d/nodesource-*.repo

3. Ardından, istediğiniz tek bir kurulum yöntemini (DNF AppStream veya NodeSource) kullanarak Node.js’i yeniden kurun.

Sonuç

Bu rehberde, Node.js’i Rocky Linux 9 sunucunuza kurmak için üç ana yöntemi detaylı bir şekilde inceledik: DNF (AppStream) depolarını kullanmak, NVM (Node Version Manager) ile versiyonları yönetmek ve NodeSource depolarından en güncel sürümleri kurmak. Her yöntemin kendine özgü avantajları ve kullanım senaryoları bulunmaktadır:

* DNF (AppStream) Yöntemi: En basit ve hızlı kurulum yoludur. Eğer en güncel Node.js versiyonuna ihtiyacınız yoksa ve tek bir kararlı sürümle çalışacaksanız idealdir.
* NVM Yöntemi: Birden fazla Node.js versiyonunu aynı makinede yönetmeniz gerektiğinde vazgeçilmezdir. Özellikle farklı projeler farklı Node.js versiyonları gerektirdiğinde esneklik sağlar.
* NodeSource Depoları Yöntemi: DNF’nin kolaylığını korurken, Node.js’in en güncel kararlı veya LTS sürümlerine erişmenizi sağlar. En yeni özellikleri kullanmanız veya belirli bir güncel LTS sürümüne bağlı kalmanız gerektiğinde tercih edilebilir.

Hangi yöntemi seçerseniz seçin, kurulum sonrası node -v ve npm -v komutlarıyla versiyonları kontrol etmeyi ve basit bir Node.js uygulaması çalıştırarak işlevselliği doğrulamayı unutmayın. Karşılaşabileceğiniz yaygın sorunlar için sunduğumuz çözümler, kurulum sürecinizi daha sorunsuz hale getirmeye yardımcı olacaktır.

Artık Rocky Linux 9 sunucunuzda Node.js kurulu ve çalışır durumda. Bu platformu kullanarak güçlü ve ölçeklenebilir web uygulamaları geliştirmeye, API’ler oluşturmaya veya mevcut projelerinizi dağıtmaya başlayabilirsiniz. Node.js’in geniş ekosistemi ve aktif topluluğu sayesinde, ihtiyacınız olan her türlü kütüphane ve araca kolayca ulaşabileceksiniz. Başarılar dileriz!