Hai, Sobat Jagoan! Node.js semakin populer sebagai backend yang cepat dan efisien. Jika kamu ingin mengunggah proyek Node.js ke cPanel hosting, ikuti panduan ini untuk proses yang lancar dan tanpa kendala.
Prasyarat
- Akses cPanel
- Sudah melakukan inisialisasi deployment Node.js di cPanel. Kalau belum punya project, bisa mengikuti panduan Cara Install NodeJS di Hosting cPanel. Tapi, kalau kamu sudah punya project sendiri, cukup ikuti panduan tersebut hingga langkah ke 5 lalu arahkan “Application startup file” ke file utama project kamu yang diupload (misalnya index.js atau app.js)
Kalau kamu sudah memenuhi apa yang sudah dicantumkan di bagian Prasyarat, kamu bisa mengikuti langkah-langkah berikut untuk mengunggah project Node.js ke cPanel
Step 1: Login ke cPanel > pilih menu File Manager > masuk ke direktori tempat project Node.js akan dijalankan. Misalnya test.domainkamu.com
Step 2: Unggah file project Node.js yang sudah dikompres menjadi file .zip di dalam folder tersebut.
Step 3: Setelah diunggah, ekstrak file .zip tersebut dan pastikan semua filenya (seperti index.js, package.json, dan lainnya) langsung di dalam direktori Node.js yang sudah kamu inisialisasi di cPanel. Jika file masih berada di dalam subfolder (misalnya belajarnodejs/), pindahkan (Move) seluruh isinya ke direktori root Node.js di cPanel
CATATAN: Pastikan kamu sudah menyesuaikan nama file pada bagian “Application startup file” dengan file utama project Node.js kamu. Dalam artikel ini menggunakan index.js, namun kamu bisa menggunakan nama lain sesuai project kamu, seperti app.js, server.js, atau yang lain.
Step 4: Sesuaikan running port Node.js project kamu ke 8080 (harus ke port ini).
Step 5: Kemudian, masuk ke menu Setup Node.js Application di cPanel untuk copy path URL virtual environment Node.js kamu – URL ini biasanya diperlukan saat ingin menjalankan perintah di terminal atau melakukan pengaturan lebih lanjut.
Klik path URL untuk menyalin virtual environment-nya.
Step 6: Selanjutnya, buka terminal di cPanel hosting. Dan paste URL yang sudah disalin ke terminal > tekan Enter. Hasilnya kamu akan diarahkan ke dalam folder Node.js yang kamu gunakan.
Step 7: Kemudian jalankan command:
npm install
Tunggu sampai proses selesai. Semakin banyak node module yang kamu gunakan semakin lama pula prosesnya dan semakin tinggi juga resource hosting yang dipakai.
Pastikan tidak ada error pada proses ini, jika ada error, berarti node module dan project kamu tidak support di jalankan melalui cPanel.
Step 8: Setelah npm install selesai, silahkan kembali ke menu Setup Nodejs Application di cPanel. Lalu restart runtime nodejs yang kamu gunakan.
Step 9: Terakhir, akses URL aplikasi Node.js kamu untuk melihat hasil deployment. Clear cache browser atau coba akses URL di icognito / private mode browser. Kalau tidak ada error, website kamu akan dapat tertampil dengan baik di browser.
Troubleshooting
Kalau kamu bertemu pesan “Cloudlinux NodeJS Selector demands to store node modules for application in separate folder (virtual environment) pointed by symlink called “node_modules”. That’s why application should not contain folder/file with such name in application root” setelah menjalankan command npm install.
Artinya:
- CloudLinux Node.js Selector memiliki mekanisme khusus untuk mengelola folder node_modules.
- Saat kamu menjalankan npm install di terminal (dalam kondisi virtual environment aktif), sistem akan otomatis membuat symlink node_modules yang menunjuk ke folder di nodevenv.
Pesan ini muncul karena kemungkinan kamu sudah meng-upload folder node_modules dari lokal ke direktori project di CPanel. Folder node_modules hasil build di komputer lokal tidak perlu di-upload ke CPanel.
Solusi: Hapus folder node_modules yang diupload dari lokal. Setelah itu, jalankan ulang perintah:
npm install
Maka nanti CloudLinux Node.js Selector akan membuat symlink node_modules sendiri, sesuai aturan hosting.
Kalau ada yang masih bikin bingung, jangan ragu hubungi Tim Support Jagoan Hosting via Live Chat atau Open Ticket Sob!
Tambahan
- Tidak semua node module dapat berjalan di nodejs cPanel
- Silahkan cari referensi alternatif node module jika ada kendala deployment di forum online seperti forum cPanel, stack overflow dan lainnya.