Panduan Lengkap Menginstal dan Mengelola Node.js dengan NVM

Node Version Manager (NVM) adalah alat yang sangat berguna untuk para developer JavaScript yang perlu bekerja dengan berbagai versi Node.js. Artikel ini akan membahas cara menginstal NVM, cara menginstal berbagai versi Node.js, dan strategi pengelolaan versi untuk proyek yang berbeda.

Apa itu NVM?

NVM (Node Version Manager) adalah script bash yang memungkinkan Anda menginstal dan mengelola beberapa versi Node.js dengan mudah. Dengan NVM, Anda dapat:

• Menginstal berbagai versi Node.js

• Beralih antara versi yang berbeda dengan cepat

• Menetapkan versi default untuk terminal baru

• Menggunakan versi spesifik untuk proyek yang berbeda

Menginstal NVM

Untuk macOS dan Linux

1. Buka terminal Anda

2. Jalankan perintah instalasi menggunakan curl:

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

   Atau dengan wget:

    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
   

3. Setelah instalasi selesai, tambahkan konfigurasi NVM ke file profile Anda (~/.bash_profile, ~/.zshrc, ~/.profile, atau ~/.bashrc):

    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
    [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
   

4. Reload file profile Anda:

    source ~/.bashrc  # atau source ~/.zshrc jika menggunakan zsh
   

Untuk Windows

Untuk Windows, Anda bisa menggunakan:

1. nvm-windows

2. Unduh installer dari halaman releases

3. Jalankan installer dan ikuti petunjuk

Verifikasi Instalasi NVM

Untuk memastikan NVM telah berhasil diinstal:

nvm --version

Jika berhasil, perintah ini akan menampilkan versi NVM yang terinstal.

Menginstal Node.js dengan NVM

Menginstal Versi Node.js Terbaru

nvm install node

Perintah ini akan menginstal versi Node.js terbaru yang stabil.

Menginstal Versi Node.js Spesifik

nvm install 14.17.0

Ganti 14.17.0 dengan versi yang Anda inginkan.

Melihat Daftar Versi Node.js yang Tersedia

nvm ls-remote

Perintah ini akan menampilkan semua versi Node.js yang tersedia untuk diinstal.

Mengelola Versi Node.js

Melihat Versi Node.js yang Terinstal

nvm ls

Menggunakan Versi Node.js Tertentu

nvm use 14.17.0

Untuk menggunakan versi terbaru:

nvm use node

Menetapkan Versi Default

nvm alias default 14.17.0

Atau menetapkan versi terbaru sebagai default:

nvm alias default node

Menguninstall Versi Node.js

nvm uninstall 14.17.0

Menggunakan Versi Node.js Spesifik untuk Proyek

Anda dapat membuat file .nvmrc di direktori proyek untuk menentukan versi Node.js yang akan digunakan:

1. Buat file .nvmrc:

    echo "14.17.0" > .nvmrc
   

2. Setiap kali masuk ke direktori proyek, jalankan:

    nvm use
   

NVM akan secara otomatis menggunakan versi yang ditentukan dalam file .nvmrc.

Kasus Penggunaan Praktis

Bekerja dengan Proyek Lama

Terkadang Anda perlu bekerja dengan proyek yang menggunakan versi Node.js lama:

cd old-project/
nvm use 12.22.12

Mencoba Fitur Baru

Untuk menguji fitur baru di versi Node.js terbaru tanpa mengubah konfigurasi global:

nvm install 18.15.0
nvm use 18.15.0
# uji fitur baru
nvm use default  # kembali ke versi default

Setup CI/CD

Dalam file konfigurasi CI/CD, pastikan untuk menggunakan versi Node.js yang sama dengan lingkungan pengembangan:

# .gitlab-ci.yml atau .github/workflows/main.yml
script:
  - nvm install 14.17.0
  - nvm use 14.17.0
  - npm install
  - npm test

Pemecahan Masalah

NVM Command Not Found

Jika Anda mendapatkan error "nvm: command not found", pastikan konfigurasi NVM telah ditambahkan ke file profile Anda dan file tersebut telah di-reload:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Konflik dengan Versi Node.js yang Diinstal Secara Global

Jika Anda memiliki instalasi Node.js global (tidak melalui NVM), uninstall terlebih dahulu:

• Di macOS: brew uninstall node

• Di Linux: sudo apt remove nodejs

• Di Windows: Uninstall melalui Control Panel

Kesimpulan

NVM adalah alat yang sangat berguna bagi developer JavaScript untuk mengelola versi Node.js dengan mudah. Dengan NVM, Anda dapat:

1. Bekerja dengan berbagai versi Node.js tanpa konflik

2. Beralih antar versi dengan cepat sesuai kebutuhan proyek

3. Menguji kode pada berbagai versi Node.js untuk memastikan kompatibilitas

Praktik terbaik adalah selalu menentukan versi Node.js yang diperlukan untuk setiap proyek menggunakan file .nvmrc, sehingga semua anggota tim dapat menggunakan versi yang sama tanpa kebingungan.

Dengan mengikuti panduan ini, Anda sekarang memiliki lingkungan pengembangan Node.js yang fleksibel dan mudah dikelola untuk berbagai kebutuhan proyek.