Dokumentasi ServBay: Mengatur Versi Node.js Tertentu untuk Proyek, Skrip, dan Situs Web Anda

ServBay merupakan lingkungan pengembangan web lokal yang kuat dan fleksibel, mendukung berbagai bahasa pemrograman dan teknologi termasuk Node.js. Dalam praktik pengembangan, Anda sering kali perlu menggunakan versi Node.js tertentu untuk proyek berbeda, skrip individu, atau seluruh situs web. Misalnya, sebuah proyek lawas mungkin bergantung pada Node.js 14, sedangkan fitur baru pada proyek lain memerlukan Node.js 20. ServBay menyediakan cara yang fleksibel untuk memenuhi kebutuhan tersebut.

Dokumen ini akan membahas secara detail cara mudah menentukan versi Node.js yang spesifik untuk skrip dan situs web Node.js di ServBay, serta memanfaatkan konfigurasi tingkat proyek.

Menentukan Versi Node.js & Konfigurasi Proyek melalui Berkas .servbay.config

Untuk proyek yang memerlukan kontrol ketat terhadap versi Node.js dan variabel lingkungan terkait, ServBay menyediakan metode konfigurasi tingkat proyek—cukup membuat berkas .servbay.config di direktori root proyek Anda. Melalui berkas ini, Anda dapat mengatur versi Node.js, alamat repositori manajer paket, direktori cache, dan lain-lain secara spesifik—menjamin izolasi serta konsistensi lingkungan proyek.

Format .servbay.config untuk menentukan versi Node.js tertentu serta konfigurasi npm/yarn repositori dan direktori cache kira-kira sebagai berikut:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Contoh: gunakan mirror tertentu
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Contoh: gunakan mirror tertentu
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Contoh: tentukan lokasi cache
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Contoh: tentukan lokasi cache

Penjelasan:

• NODE_VERSION: Menentukan nomor versi utama Node.js yang digunakan proyek ini. ServBay akan mencari dan memanfaatkan Node.js yang terpasang dengan nomor versi sesuai.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Mengatur alamat repositori yang digunakan npm atau yarn di proyek ini.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Menentukan direktori cache yang digunakan npm atau yarn. Contoh pada konfigurasi memakai direktori file sementara bawaan ServBay di /Applications/ServBay/tmp/.

Pada umumnya, file .servbay.config diletakkan pada root direktori proyek Anda. Untuk pengaturan lebih lanjut dan detail, silakan kunjungi bagian .servbay.config di dokumentasi resmi ServBay.

Menjalankan Skrip Node.js Versi Tertentu via Command Line

Jika Anda tidak ingin menetapkan versi Node.js pada tingkat proyek, melainkan hanya ingin menjalankan sebuah skrip menggunakan versi Node.js tertentu secara sementara, Anda dapat memakai alias pada command line yang disediakan ServBay.

Di lingkungan terminal ServBay (dapat dibuka melalui antarmuka aplikasi ServBay), Anda dapat menjalankan perintah node-<version> untuk menentukan versi Node.js yang digunakan saat mengeksekusi skrip. ServBay secara otomatis membuat alias untuk setiap versi Node.js yang terinstal.

Sebagai contoh, untuk menjalankan skrip script.js menggunakan Node.js 14, cukup gunakan perintah berikut:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Contoh output, nomor versi bisa berbeda

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Contoh output, nomor versi bisa berbeda

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Contoh output, nomor versi bisa berbeda

Penjelasan Contoh

• $ node-14 script.js: Menjalankan skrip script.js menggunakan Node.js versi 14 yang telah terpasang di ServBay (nomor versi pastinya tergantung instalasi Anda).
• $ node-16 script.js: Menjalankan skrip menggunakan Node.js versi 16.
• $ node-20 script.js: Menjalankan skrip menggunakan Node.js versi 20.

Dengan metode ini, Anda dapat menguji kompatibilitas dan menjalankan berbagai skrip yang memerlukan versi Node.js berbeda secara fleksibel—tanpa perlu mengubah pengaturan Node.js secara global.

Menentukan Versi Node.js untuk Situs Web Via Antarmuka ServBay

ServBay memungkinkan Anda mengatur versi Node.js default untuk masing-masing situs web yang dikelola, langsung dari antarmuka pengguna. Ini sangat berguna untuk situs yang bergantung pada layanan backend Node.js (misal aplikasi framework Node.js yang diproxy melalui Caddy ataupun Nginx), atau memerlukan lingkungan Node.js khusus.

Langkah-langkah

1. Buka Antarmuka ServBay: Jalankan aplikasi ServBay, lalu akses antarmuka manajemennya melalui browser (biasanya di http://localhost:5200 atau melalui tautan di jendela utama aplikasi ServBay).

2. Navigasi ke Manajemen Situs Web: Pada panel navigasi sebelah kiri, klik menu Website (Situs Web).

3. Pilih & Edit Situs Web: Cari situs web yang ingin Anda atur (misal situs yang dibuat di /Applications/ServBay/www/servbay.demo). Klik tombol edit di samping nama situs (biasanya berbentuk ikon roda gigi atau pensil), atau klik langsung nama situs untuk masuk ke detail.

4. Atur Versi Node.js: Di halaman konfigurasi situs, cari opsi pengaturan versi Node.js—umumnya berupa dropdown menu. Pilih versi Node.js yang ingin dijadikan default untuk situs tersebut.

5. Simpan Perubahan: Setelah memilih versi, pastikan klik tombol Simpan atau Apply di bagian bawah halaman agar perubahan tersimpan.

6. Restart Situs Web atau ServBay (Jika Diperlukan): Beberapa perubahan pengaturan mungkin baru berlaku setelah me-restart server web terkait (seperti Caddy atau Nginx) atau ServBay secara keseluruhan. ServBay biasanya akan memberikan notifikasi apabila diperlukan restart.

Catatan Penting

• Pastikan Versi Node.js Sudah Terpasang & Aktif: Versi Node.js yang dapat dipilih pada pengaturan situs web, harus sudah diinstal dan berjalan di halaman Packages (Paket) pada ServBay. Jika belum terinstal/aktif, lakukan instalasi atau aktifkan terlebih dahulu di halaman tersebut.
• Jenis Situs Web: Pengaturan ini terutama berlaku untuk situs web yang membutuhkan Node.js sebagai environment backend (misal aplikasi Express.js, Next.js, NestJS, dsb). Untuk situs statis murni atau yang seluruhnya menggunakan backend PHP/Python/Go, pengaturan ini mungkin tidak relevan.
• Uji Kompatibilitas: Setelah mengubah versi Node.js, pastikan untuk menguji seluruh fungsi situs agar semua dependensi berjalan lancar dan tidak ada masalah kompatibilitas.
• Relasi dengan .servbay.config: Pengaturan versi Node.js pada tingkat situs web bertindak sebagai default. Jika di dalam direktori situs juga terdapat .servbay.config dan ada pengaturan NODE_VERSION, maka pengaturan pada .servbay.config akan mengambil prioritas lebih tinggi karena cakupannya lebih spesifik.

Kesimpulan

Sebagai lingkungan pengembangan lokal yang menyeluruh, ServBay menyediakan berbagai metode fleksibel serta canggih untuk mengatur dan mengelola runtime Node.js Anda. Anda dapat menggunakan berkas .servbay.config di root proyek guna kontrol lebih rinci pada level proyek beserta variabel lingkungan, menjalankan skrip Node.js versi tertentu secara cepat melalui perintah node-<version>, atau menetapkan default versi Node.js untuk situs web Anda langsung melalui antarmuka ServBay.

Fitur-fitur ini memudahkan Anda memenuhi tuntutan berbagai proyek dan skenario terkait kebutuhan versi Node.js—baik itu guna kompatibilitas proyek lama, menguji fitur baru, maupun memastikan keseragaman antara lingkungan pengembangan dengan produksi. ServBay siap mendukung Anda secara efektif, sehingga efisiensi dan kemampuan manajemen lingkungan pengembangan meningkat signifikan.