Cara deploy aplikasi Node.js di Web Hosting AwanCerah

Web Hosting AwanCerah tidak hanya untuk situs PHP. Lewat Setup Node.js App, aplikasi Node.js Anda berjalan terus sebagai proses sendiri di server, dengan batas CPU dan RAM sesuai paket. Domain atau path diarahkan ke aplikasi itu, lengkap dengan SSL dan WebSocket.

Kami mencoba langkah di panduan ini dengan aplikasi Express yang dibuat dari nol dan aplikasi contoh yang di-clone dari GitHub, sampai keduanya tampil lewat HTTPS.

Yang Anda perlukan

• Web Hosting paket Kecil atau lebih tinggi. Paket Kecil memuat 1 aplikasi, Sedang 3, dan Besar 5. Jumlah ini dihitung gabungan untuk Node.js, Python, dan Ruby. Di paket Mikro, Setup Node.js App tampil terkunci. Naikkan paket di Paket & Pengaturan.
• Domain yang sudah mengarah ke hosting dengan SSL aktif. Caranya ada di panduan Web Hosting. Untuk mencoba lebih dulu, alamat sementara hosting juga bisa dipakai.
• Kode aplikasi yang membaca port dari process.env.PORT.

Siapkan kode agar membaca PORT

Server memberi tahu aplikasi port yang harus dipakai lewat environment variable PORT, dan mengisi NODE_ENV dengan production. Jangan menulis port tetap seperti 3000 di kode.

const express = require('express');

const app = express();
const port = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Halo dari Express di AwanCerah!');
});

app.listen(port, '127.0.0.1', () => {
  console.log(`Aplikasi berjalan di port ${port}`);
});

Aplikasi cukup mendengarkan di 127.0.0.1. Permintaan dari internet masuk lewat server web hosting, lalu diteruskan ke port aplikasi Anda.

Buat aplikasi

1. Di dasbor hosting, buka Setup Node.js App di kelompok Software.
2. Klik Buat aplikasi.
3. Pilih Versi, misalnya Node.js 22.
4. Isi Folder aplikasi, misalnya tokoku. Kode disimpan di apps/tokoku, di luar public_html, jadi file seperti .env tidak bisa dibuka dari browser.
5. Pilih Domain, lalu isi Path URL. Isi / bila seluruh domain dilayani aplikasi, atau path seperti /api bila situs PHP atau WordPress tetap di alamat utama.
6. Isi Startup file dengan file yang dijalankan, misalnya app.js, server.js, atau dist/main.js.
7. Klik Buat aplikasi.

Bila foldernya masih kosong, folder diisi contoh aplikasi. Klik Buka di kartu aplikasi dan Anda akan melihat tulisan "It works!" beserta versi Node.js.

Masukkan kode aplikasi

Pilih salah satu cara berikut.

Dari Git, sebelum aplikasi dibuat. Buka Terminal di kelompok Advanced, isi Folder kerja dengan apps, lalu jalankan:

git clone https://github.com/akun-anda/tokoku.git tokoku

Setelah itu buat aplikasi dengan Folder aplikasi tokoku. Folder yang sudah berisi tidak diisi contoh aplikasi. Untuk repository privat, pakai fine-grained personal access token GitHub yang hanya bisa membaca repository itu, misalnya https://TOKEN@github.com/akun-anda/tokoku.git.

Upload dari komputer. Kompres proyek menjadi .zip tanpa folder node_modules. Di File Manager, buka folder apps/tokoku, hapus file contoh, upload file .zip, lalu ekstrak. Untuk proyek di atas 50 MB, pakai SFTP.

Mulai dari contoh. Buat aplikasi dengan folder baru, edit app.js di File Manager, lalu pasang paket yang dibutuhkan seperti langkah berikutnya.

Pasang dependency lalu restart

Setiap kartu aplikasi punya kotak Jalankan perintah di folder aplikasi. Perintah berjalan di folder aplikasi dengan versi Node.js yang Anda pilih.

1. Klik tombol npm install, atau ketik perintah lalu klik Jalankan, misalnya npm install express.
2. Bila proyek perlu di-build, klik npm run build.
3. Klik ikon Restart di kartu aplikasi supaya kode baru dipakai.
4. Klik Buka untuk melihat hasilnya.

Perintah yang bisa dijalankan: node, npm, npx, dan git. Perintah berjalan tanpa input interaktif dan berhenti otomatis setelah 15 menit. Di uji kami, npm install express selesai dalam sekitar 5 detik.

Environment variables

Simpan konfigurasi seperti URL database atau API key di environment variables, bukan di kode.

1. Klik ikon Ubah di kartu aplikasi.
2. Di bagian Environment variables, klik Tambah, lalu isi nama dan nilainya, misalnya DATABASE_URL.
3. Klik Simpan. Aplikasi di-restart otomatis dengan nilai baru.

Nilainya dibaca lewat process.env.DATABASE_URL. PORT dan HOST diatur oleh server dan tidak bisa diubah.

Hubungkan ke database

Buat database MariaDB di Databases, lalu hubungkan dari aplikasi dengan host localhost dan port 3306. Contoh dengan paket mysql2:

const mysql = require('mysql2/promise');

const db = mysql.createPool(process.env.DATABASE_URL);

Isi DATABASE_URL dengan mysql://pengguna:password@localhost:3306/nama_database.

Log dan restart otomatis

• Klik Lihat log di kartu aplikasi untuk melihat 200 baris terakhir keluaran console.log, error, serta catatan start dan stop.
• Aplikasi yang crash dinyalakan ulang otomatis. Bila terus gagal, kartu menampilkan Gagal berjalan. Perbaiki penyebabnya dari log, lalu klik Restart.
• Pemakaian memori tampil di kartu. Aplikasi berbagi CPU dan RAM paket dengan PHP dan proses lain di akun Anda.
• Ikon Hentikan mematikan aplikasi sementara. Selama berhenti, alamatnya menampilkan halaman 503.

Memperbarui aplikasi

Untuk kode dari Git, jalankan git pull di kotak perintah aplikasi, lalu npm install bila dependency berubah, dan klik Restart. Untuk kode dari komputer, upload file yang berubah lewat File Manager atau SFTP, lalu restart.

Aplikasi di path selain /

Bila Path URL diisi, misalnya /api, aplikasi menerima path lengkap seperti /api/produk. Server mengisi environment variable APP_BASE_PATH dengan path itu, jadi rute bisa ditulis seperti ini:

const base = process.env.APP_BASE_PATH || '';

app.get(base + '/', (req, res) => res.send('Halo'));
app.get(base + '/produk', (req, res) => res.json([]));

Tips

• WebSocket, misalnya Socket.IO, bisa dipakai tanpa pengaturan tambahan.
• Folder apps ikut backup harian, termasuk node_modules.
• Build yang membutuhkan banyak memori sebaiknya dijalankan di komputer Anda, lalu unggah hasil build-nya.
• Bila aplikasi dihapus dari console, file di foldernya tidak ikut terhapus.
• Butuh lebih dari 5 aplikasi atau akses root? Pakai Cloud VPS.