Ghid Complet: Deployment Node.js cu Express, Socket.io si SQLite pe cPanel

Cum sa faci deploy la o aplicatie Node.js cu Express, Socket.io si SQLite pe cPanel

In ecosistemul hostingului partajat, configurarea unei aplicatii moderne care foloseste Express si comunicare in timp real prin Socket.io poate parea o provocare. Acest ghid iti arata pas cu pas cum sa folosesti CloudLinux Setup Node.js App si Git™ Version Control pentru a pune in functiune proiectul tau.

Vom folosi ca exemplu repository-ul: https://github.com/ClausWebRo/cpanel-chat-example.git.

1. Cerinte Tehnice (Stack-ul Aplicatiei)

Aplicatia noastra utilizeaza un set de tehnologii moderne care necesita o configurare atenta pe server:

• Express (^4.18.2): Framework-ul web principal.
• Socket.io (^4.7.2): Pentru transfer de date instantaneu (WebSockets).
• Sqlite3 (^5.1.6) & Sqlite (^5.0.1): Pentru stocarea datelor intr-un fisier local, fara server MySQL.

2. Clonarea proiectului via Git™ Version Control

In loc sa incarci fisierele prin FTP, este mult mai eficient sa folosesti integrarea nativa Git din cPanel.

1. Logheaza-te in cPanel si cauta sectiunea Files.
2. Deschide Git™ Version Control si apasa pe Create.

1. La Clone URL, introdu: https://github.com/ClausWebRo/cpanel-chat-example.git.
2. La Repository Path, alege un nume de folder (ex: cpanel-chat).
3. Apasa butonul Create.

3. Configurarea mediului prin „Setup Node.js App”

Acesta este pasul unde definim versiunea de Node si mediul de executie gestionat de CloudLinux.

1. Mergi la Software -> Setup Node.js App.
2. Apasa pe Create Application.

1. Node.js version: Selecteaza o versiune stabila (recomandat 18.x sau 20.x).
2. Application root: Folderul unde ai clonat proiectul (ex: cpanel-chat). Calea trebuie sa fie relativa la radacina contului (ex: /home/USER_CPANEL/cpanel-chat/ trebuie introdus doar  cpanel-chat )
3. Application URL: Alege domeniul sau subdomeniul dorit.
4. Application startup file: Introdu index.js.
5. Apasa Create.

4. Instalarea dependintelor (Express si SQLite3)

Dupa crearea aplicatiei, vei vedea butonul Run npm install. Trebuie apasat pentru compilare dependinte si pe urma cand sa finalizat butonul Restart.

5. Configurarea Socket.io pentru Proxy-ul cPanel

Deoarece aplicatia ta Express ruleaza in spatele unui proxy (Passenger), este vital sa asculti pe portul furnizat de sistem:

Sfat: Nu incerca sa folosesti porturi precum 8080 sau 3000 manual, deoarece cPanel le va bloca.

// cPanel aloca portul automat prin variabila de mediu PORT
const port = process.env.PORT || 3000;
server.listen(port, () => {
console.log(`Serverul ruleaza pe portul ${port}`);
});

6. Gestionarea bazei de date SQLite

Un mare avantaj la sqlite3 este ca nu necesita configurarea unei baze de date MySQL. Totusi, retine aceste aspecte:

• Baza de date este un fisier cu extensia .db localizat in folderul aplicatiei. (ex: chat.db)
• Asigura-te ca utilizatorul cPanel are permisiuni de scriere in folderul respectiv.
• Daca muti aplicatia, muti si datele pur si simplu prin copierea fisierului.

7. Finalizarea si Verificarea Aplicatiei

Daca ai urmat toti pasii corect, aplicatia ta este acum activa. Iata cum poti confirma ca totul ruleaza in parametri optimi:

• Accesarea URL-ului: Deschide link-ul setat la Application URL. Ar trebui sa vezi interfata de chat din exemplul de pe GitHub.
• Persistenta SQLite: Trimite cateva mesaje in chat, apoi restarteaza aplicatia din cPanel. Daca mesajele raman acolo, inseamna ca baza de date SQLite a fost creata corect si are drepturi de scriere.