====== Menjalankan Project Node.js menggunakan PM2 ======

===== Install Node.js =====

Sebelumnya pastikan nodejs sudah terinstall. Lihat laman [[:nodejs:nodejs_di_debian_dan_ubuntu|instalasi]] nodejs.

===== Menyiapkan directory dari project =====

Sebelum menjalankan program, siapkan directory terlebih dahulu. Directory /opt pada linux digunakan untuk meletakkan program 3rd party agar tidak mengganggu program internal dari sistem linux

==== Pindah ke directory /opt ====
<code>

cd /opt

</code>

==== Buat directory baru bernama projects ====

<code>
sudo mkdir projects

</code>

===== Menyiapkan permission dari project =====

Agar sistem linux anda aman, maka program akan dijalankan sebagai user biasa, bukan sebagai user root. Untuk itu perlu disiapkan permission dari project tersebut. Pada contoh kasus ini, kami menggunakan group projects sebagai group yang akan menjalankan program.

==== Buat group baru ====

<code>
sudo addgroup projects

</code>

==== Jadikan directory /opt/projects menjadi milik group projects ====

<code>
sudo chgrp projects /opt/projects

</code>

==== Tambahkan user saat ini kepada group projects ====

Pada kasus ini username yang akan menjalankan project adalah
 <font inherit/inherit;;#8e44ad;;inherit>saya</font>  . Perintah berikut ini menggunakan parameter -aG (huruf a kecil dan G kapital) yang berarti

  * a: menambahkan user ke group tertentu,
  * G: menambahkan tanpa menghapus user dari group yang sudah ada.

<code>
sudo usermod -aG projects saya

</code>

===== Menginisiasi project =====

==== Masuk ke directory projects ====

<code>
cd /opt/projects

</code>

==== Inisiasi sebuah project nest ====

Pada kasus ini kami membuat sebuah project bernama [[https://patra.smartsystem.id|PATRA]], dengan bahasa Javascript (bukan Typescript), menggunakan framework [[https://nestjs.com|Nestjs]]. Perintah ini akan secara otomatis membuatkan sebuah directory di dalam directory saat ini (''/opt/projects/'').
<code>

sudo nest new patra –language=js

</code>

==== Ubah kepemilikan directory patra ke group projects ====

Agar user yang tergabung dalam group
 <font inherit/inherit;;#8e44ad;;inherit>projects</font>  dapat melakukan aktivitas di dalam directory, maka kepemilikannya perlu diubah menjadi group
 <font inherit/inherit;;#8e44ad;;inherit>projects</font>  .

<code>
sudo chgrp -R projects /opt/projects/patra

</code>

===== Menjalankan project =====

==== Ujicoba menjalankan project sebagai user biasa ====

Untuk menguji apakah program dapat berjalan, biasanya dicoba dengan menggunakan perintah

<code>
node app.js

</code>

atau jika menggunakan framework seperti diatas dapat juga dijalankan dengan perintah

<code>
npm run start

</code>

Untuk menghentikan program gunakan kombinasi tombol ** <font inherit/inherit;;#e74c3c;;inherit>[ctrl]+[c]</font> **

===== Menginstall, mengkonfigurasi dan menggunakan PM2 =====

==== Menginstall pm2 secara global ====

PM2 adalah sebuah service yang akan menjalankan program nodejs dan memantau program tersebut serta merestartnya jika dibutuhkan. Untuk menginstall PM2 secara global gunakan perintah berikut

<code>
sudo npm install -g pm2

</code>

==== Menjalankan program dengan pm2 sebagai user biasa ====

Untuk menambahkan program ke PM2, gunakan perintah

<code>
pm2 start node /opt/projects/patra/index.js –name patra

</code>

Untuk melihat proses yang sedang berjalan dapat menggunakan perintah

<code>
pm2 list

</code>

==== Menjadikan agar PM2 langsung berjalan saat boot ====

Agar PM2 dapat langsung berjalan saat server boot, gunakan perintah

<code>
pm2 startup

</code>

Perintah tersebut akan memunculkan perintah yang akan dijalankan sebagai user root. Copy perintah yang muncul pada tahapan diatas dan jalankan.

<code>
sudo env PATH=$PATH:/usr/local/bin /usr/local/lib/node_modules/pm2/bin/pm2 startup systemd -u saya –hp /home/saya

</code>

Perintah ini membuat sebuah service baru atas nama user biasa, yaitu user
 <font inherit/inherit;;#8e44ad;;inherit>saya</font>

Kita dapat menyimpan daftar proses saat ini, agar ikut berjalan saat server boot

<code>
pm2 save

</code>

Jika ingin mencoba, mematikan semua proses

<code>
pm2 stop all

</code>

Jika ingin mematikan salah satu proses saja, gunakan id dari proses tersebut

<code>
pm2 stop 2

</code>

Menghidupkan service tertentu, gunakan id proses tersebut, misalnya 2

<code>
pm2 start 2

</code>

Setelah konfigurasi pm2 selesai, restart server

<code>
sudo reboot

</code>