Kuidas luua Node.js rakendust?

Meie veebimajutuse paketid toetavad Node.js rakenduste käivitamist. cPanelisse on integreeritud CloudLinuxi Node.js Selector, mille abil saad hõlpsasti luua uusi rakendusi, valida vajaliku Node.js versiooni ning hallata keskkonnamuutujaid ja mooduleid.

Samm-sammult juhend rakenduse loomiseks:

1. Logi cPanelisse.
2. Keri lehte sektsioonini "Software" ja klõpsa ikoonil Setup Node.js App.
3. Uue rakenduse seadistamiseks klõpsa nupul Create Application.
4. Täida avanenud aknas järgmised väljad:
   • Node.js version: Vali rippmenüüst oma rakendusele sobiv versioon.
   • Application mode: Vali vastavalt vajadusele kas Development (arenduskeskkond) või Production (tootmiskeskkond).
   • Application root: Määra kataloogi nimi, kuhu laadid oma rakenduse failid (näiteks minu_rakendus). Pane tähele: see kataloog luuakse sinu konto kodukataloogi, mitte public_html kausta sisse.
   • Application URL: Vali domeen või alamdomeen, millelt soovid rakenduse kättesaadavaks teha.
   • Application startup file: Sisesta käivitusfaili nimi (näiteks app.js või server.js). Kui jätad selle tühjaks, kasutab süsteem vaikimisi faili nimega app.js.
5. Seadistuste salvestamiseks ja rakenduse loomiseks klõpsa lehe ülaosas nupul Create.

Failide üleslaadimine ja NPM moodulite paigaldamine:

Peale rakenduse loomist on vajalik laadida üles oma kood:

1. Laadi oma rakenduse failid (sealhulgas package.json) cPaneli failihalduri (File Manager), FTP või SSH kaudu varem määratud juurkataloogi (Application root).
2. Kui failid on üles laaditud, pöördu tagasi Setup Node.js App lehele ja muuda oma loodud rakendust pliiatsi ikoonile klõpsates.
3. Leiad sealt nupu Run NPM Install. Sellele klõpsates loeb süsteem sinu package.json faili ja paigaldab automaatselt kõik vajalikud sõltuvused.

Olulised nõuanded ja veaotsing

1. Staatiliste failide teenindamine (Express)

Kuna cPanel kasutab Node.js rakenduste jooksutamiseks Phusion Passengerit, siis ei pruugi rakendus vaikimisi public kaustas asuvaid pilte või CSS-faile kätte saada. Selleks tuleb Express raamistikus kasutada router-it ja määrata staatiliste failide asukoht järgnevalt:

const express = require('express');
const path = require('path');
const app = express();
const router = express.Router();

// Määrab 'public' kausta staatiliste failide asukohaks
router.use(express.static(path.join(__dirname, 'public')));
app.use('/', router);

2. Next.js, React ja mälulimiidid (WASM viga)

Ressursimahukate raamistike (nt Next.js) puhul võib serveris käsu npm run build käivitamine ebaõnnestuda, kuna see ületab jagatud majutuse paketile seatud mälulimiidid (tüüpiline viga on WebAssemblyMemory või Killed).

Lahendus: Loo rakenduse build oma lokaalses arvutis ja laadi serverisse juba valmis ehitatud failid:

• .next kataloog (Next.js)
• package.json
• next.config.js

Seejärel käivita cPanelis ainult Run NPM Install.

Rakenduse haldamine ja taaskäivitamine:

Samas cPaneli menüüs (Setup Node.js App) näed kõiki oma loodud rakendusi. Iga rakenduse real on nupud rakenduse haldamiseks:

• Start – käivitab rakenduse.
• Stop – peatab rakenduse.
• Restart – taaskäivitab rakenduse. Vajalik pärast koodis või keskkonnamuutujates muudatuste tegemist.

Uue versiooni paigaldamine: peata rakendus alati esmalt (Stop), seejärel lae uued failid üles ja käivita uuesti (Start) — nii ei jää vanu protsesse taustale.

Kui rakendus ei käivitu või protsesside arv (Number of Processes) saab täis, vaata: Node.js rakendus ei käivitu või protsesside arv (Number of Processes) saab täis.