Aplicații Node.js pe găzduirea cPanel: creare, încărcare și pachete npm
TipărirePe scurt: o aplicație Node.js se pornește din cPanel, cu instrumentul Setup Node.js App. Creați aplicația, încărcați fișierele proiectului, instalați pachetele npm din interfață sau din Terminal și reporniți aplicația. Node.js este inclus în pachetele Web Hosting SSD.
Ce pregătiți înainte
- Proiectul, cu fișierul
package.jsonși fișierul care pornește aplicația (de exempluapp.js,server.jssauindex.js). - Domeniul sau subdomeniul la care va răspunde aplicația, adăugat deja în cPanel.
- Versiunea de Node.js cu care ați testat proiectul pe calculator.
Pasul 1. Creați aplicația în cPanel
- Intrați în cPanel și, în secțiunea Software, deschideți Setup Node.js App. Pagina afișează aplicațiile existente.
- Apăsați Create Application.
- Completați formularul:
| Câmp | Ce introduceți |
|---|---|
| Node.js version | Versiunea potrivită proiectului dvs. |
| Application mode | Production pentru site-ul public, Development doar pentru teste. |
| Application root | Folderul în care stau fișierele aplicației, de exemplu nodeapp. |
| Application URL | Domeniul și, dacă vreți, o cale la care va fi disponibilă aplicația. |
| Application startup file | Fișierul de pornire, de exemplu app.js. |
Apăsați Create. Sistemul pune în folder o aplicație de test. Deschideți adresa aplicației în browser: dacă vedeți pagina de test, mediul funcționează.
Atenție: aplicația preia adresa aleasă. Dacă o puneți direct pe domeniul principal, site-ul care era acolo nu se mai afișează. Pentru teste, folosiți un subdomeniu sau o cale separată.
Pasul 2. Încărcați proiectul
- Ștergeți fișierele de test create automat în folderul aplicației.
- Încărcați fișierele proiectului în același folder, prin File Manager sau prin FTP.
- Dacă fișierul de pornire are alt nume decât cel trecut la creare, apăsați Edit la aplicație și corectați câmpul Application startup file.
- Pe pagina aplicației apare butonul Run NPM Install, dacă în folder există
package.json. Apăsați-l pentru a instala dependențele. - Apăsați Restart și verificați adresa aplicației în browser.
Greșeală frecventă: nu încărcați folderul node_modules de pe calculator. Pachetele se instalează pe server, într-un mediu virtual separat, iar node_modules din folderul aplicației este doar o legătură către el. Un folder node_modules încărcat de dvs. împiedică instalarea.
Pasul 3. Pachetele npm din Terminal
Instalarea din interfață nu reușește mereu, mai ales la proiecte cu multe dependențe. Atunci lucrați din linia de comandă:
- Deschideți Terminal în cPanel sau conectați-vă prin SSH. Accesul SSH pe găzduire se activează la cerere de echipa de suport.
- În partea de sus a paginii aplicației, în Setup Node.js App, este afișată comanda care intră în mediul virtual al aplicației. Copiați-o și rulați-o. Arată astfel:
source /home/UTILIZATOR/nodevenv/nodeapp/VERSIUNE/bin/activate && cd /home/UTILIZATOR/nodeapp
- Rulați
npm install, apoi reporniți aplicația din cPanel.
Comenzi npm utile
| Comanda | Ce face |
|---|---|
npm install | Instalează toate pachetele din package.json |
npm install NUME | Adaugă un pachet anume |
npm uninstall NUME | Elimină un pachet |
npm update NUME | Aduce un pachet la o versiune mai nouă, în limitele din package.json |
npm list --depth=0 | Arată pachetele instalate direct în proiect |
npm outdated | Arată pachetele pentru care există versiuni mai noi |
npm help | Afișează ajutorul și lista de comenzi |
Dacă aplicația nu pornește
- Verificați numele fișierului de pornire și folderul aplicației din formularul Edit.
- Uitați-vă în jurnalul de erori al aplicației: în formular puteți indica un fișier de log, unde apar mesajele de eroare ale Node.js.
- Rețineți că aplicația folosește resursele pachetului (procesor, memorie, procese). Un proces care consumă prea mult este oprit de limitele contului.
Dacă rămâneți blocat, deschideți un tichet și indicați domeniul și folderul aplicației.
