Node.js alkalmazás létrehozása cPanelben (Setup Node.js App)

cPanel 5 perc olvasás

cPanel tárhelyeinken Node.js alkalmazást is futtathatsz. Az alkalmazásokat a CloudLinux Node.js Selector kezeli, amely a cPanelben Setup Node.js App néven érhető el. Itt választhatod ki a Node.js verziót, és itt indíthatod, állíthatod le és indíthatod újra az alkalmazást. Az alkalmazást a Phusion Passenger futtatja, így nem kell külön portot nyitnod vagy folyamatkezelőt (például pm2-t) használnod.

Általános áttekintést a Node.js alkalmazások hosztolásáról szóló blogbejegyzésben találsz.

Az alkalmazás létrehozása

  1. Jelentkezz be a cPanelbe, és a Szoftver csoportban kattints a Setup Node.js App ikonra. A megnyíló Node.js oldal WEB ALKALMAZÁSOK listája mutatja a már létrehozott alkalmazásokat.
  2. Kattints az ALKALMAZÁS LÉTREHOZÁSA gombra.
  3. Töltsd ki a mezőket:
    • Node.js verzió: a használni kívánt Node.js verzió. Válaszd azt, amelyre az alkalmazásodat fejlesztetted.
    • Alkalmazás módja: Production (éles) vagy Development (fejlesztői) mód. Ez a NODE_ENV környezeti változó értéke lesz.
    • Alkalmazás root: az alkalmazás könyvtára a tárhelyen, a saját könyvtáradhoz (/home/felhasznalo) viszonyítva, például nodeapp. Ne a public_html könyvtárat add meg, mert így a forráskód nyilvánosan letölthető lenne.
    • Alkalmazás URL: a domain és az útvonal, ahol az alkalmazás elérhető lesz, például pelda.hu vagy pelda.hu/api.
    • Alkalmazás indító fájl: az alkalmazás belépési fájlja, például app.js.
    • Passenger napló fájl: ha megadsz egy fájlt, például /home/felhasznalo/logs/nodeapp.log, ide kerülnek az alkalmazás kimenetei és hibaüzenetei.
  4. Kattints a jobb felső sarokban a LÉTERHOZÁS gombra (a felület így, elírva mutatja).

Node.js: ALKALMAZÁS LÉTREHOZÁSA űrlap a verzióval, a móddal, az alkalmazás könyvtárával és URL-jével

A cPanel létrehozza a könyvtárat, és ha a belépési fájl még nem létezik, egy egyszerű „It works!” mintaalkalmazást tesz bele. Az Alkalmazás URL címen ellenőrizheted, hogy működik-e.

Az alkalmazás feltöltése

Töltsd fel az alkalmazás fájljait az Alkalmazás root könyvtárba a Fájlkezelővel vagy FTP-n. Egy minimális Express-alkalmazás így néz ki:

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Helló a Node.js alkalmazásból!');
});

app.listen(process.env.PORT || 3000);

A portot nem kell beállítanod: a Passenger átveszi az alkalmazás listen() hívását, és a beérkező kéréseket az alkalmazáshoz irányítja.

Fontos: a Passenger csak CommonJS modulokat (require) tud közvetlenül betölteni. Ha az alkalmazásod ES modulokat (import) használ, hozz létre egy app_wrapper.cjs fájlt az alábbi tartalommal, és ezt add meg belépési fájlként:

(() => import('./app.js'))();

Csomagok telepítése

A függőségeket az alkalmazás könyvtárában lévő package.json fájl alapján telepítheted:

  1. Töltsd fel a package.json fájlt az Alkalmazás root könyvtárba.
  2. A Setup Node.js App felületen kattints az alkalmazás melletti szerkesztés (ceruza) ikonra.
  3. Az Érzékelt konfigurációs fájlok részben megjelenik a package.json. Kattints Az NPM telepítő futtatása gombra.

Node.js alkalmazás szerkesztése: a virtuális környezet parancsa, ALKALMAZÁS LEÁLLÍTÁSA, ÚJRAINDÍTÁS, Az NPM telepítő futtatása és JS script futtatása

Fontos: a Node.js Selector a csomagokat az alkalmazás könyvtárán kívül, egy külön virtuális környezetben tárolja, és az alkalmazás könyvtárában csak egy node_modules nevű hivatkozást (symlinket) helyez el. Ezért ne tölts fel saját node_modules könyvtárat. Ha ilyen könyvtár vagy fájl van az alkalmazás gyökerében, a telepítés hibával leáll. Töröld, és telepítsd a csomagokat a fenti módon.

A JS script futtatása gombbal a package.json fájl scripts részében megadott parancsokat (például build) futtathatod.

Környezeti változók

Az alkalmazás szerkesztőoldalán a VÁLTOZÓ HOZZÁADÁSA gombbal környezeti változókat adhatsz meg, például adatbázis-hozzáférést vagy API-kulcsot. Az alkalmazás ezeket a process.env objektumon keresztül éri el, így a jelszavakat nem kell a forráskódba írnod. Mentés után indítsd újra az alkalmazást.

Újraindítás változtatás után

A Passenger a már betöltött alkalmazást futtatja tovább, ezért a fájlok módosítása után az alkalmazást újra kell indítani. Ehhez kattints a szerkesztőoldal tetején az ÚJRAINDÍTÁS gombra, vagy az alkalmazáslista Műveletek oszlopában az újraindítás ikonra. Az ALKALMAZÁS LEÁLLÍTÁSA gombbal leállíthatod, a MEGSEMMISÍT gombbal (vagy a listában a kuka ikonnal) pedig törölheted az alkalmazást.

Parancssori használat (SSH)

SSH-hozzáféréssel rendelkező csomagokban (cP Premium, cP Pro és cP Pro 100) az alkalmazás virtuális környezetébe a terminálból is beléphetsz. A pontos parancsot a Setup Node.js App felület az alkalmazás szerkesztőoldalának tetején mutatja, és így néz ki:

source /home/felhasznalo/nodevenv/nodeapp/20/bin/activate && cd /home/felhasznalo/nodeapp

Ezután a node és az npm parancs a kiválasztott verzióval fut, így például az npm install is használható. Az SSH-belépést az SSH-kulcs cPanelben való beállításáról szóló cikk írja le.

Automatizálás parancssorból (cloudlinux-selector)

SSH-hozzáféréssel rendelkező csomagokban a Setup Node.js App felület lépései a cloudlinux-selector paranccsal is elvégezhetők, így az alkalmazás létrehozása és frissítése szkriptből vagy CI/CD folyamatból is automatizálható. A parancs a saját felhasználóddal fut, root-jogosultság nem kell hozzá. A Node.js Selectorhoz nincs dokumentált webes API, és a cPanel UAPI sem kezeli ezeket az alkalmazásokat, ezért az automatizáláshoz SSH-kapcsolatra van szükség.

Az alkalmazást így hozhatod létre:

A="--json --interpreter nodejs"
R="--app-root nodeapp"

cloudlinux-selector create $A --domain pelda.hu $R --app-uri api --version 22 \
  --app-mode production --startup-file app.js \
  --env-vars '{"KULCS":"ertek"}' \
  --passenger-log-file=/home/felhasznalo/logs/nodeapp.log

Az --interpreter nodejs kapcsolót minden parancsnál meg kell adni, mert az alapértelmezés a PHP. Az --app-root a saját könyvtáradhoz viszonyított útvonal, a --domain és az --app-uri együtt adja az Alkalmazás URL-t (itt pelda.hu/api), az --app-mode értéke production vagy development.

Ezután töltsd fel a fájlokat az Alkalmazás root könyvtárba, például SFTP-n vagy rsync paranccsal, majd telepítsd a csomagokat, futtasd a szükséges szkriptet, és indítsd újra az alkalmazást:

cloudlinux-selector install-modules $A $R
cloudlinux-selector run-script $A $R --script-name build
cloudlinux-selector restart $A $R

A többi művelet ugyanígy érhető el:

cloudlinux-selector get $A                          # alkalmazások és verziók listája
cloudlinux-selector set $A $R --env-vars '{"KULCS":"uj-ertek"}' --new-version 24
cloudlinux-selector set $A $R --app-mode development
cloudlinux-selector stop $A $R
cloudlinux-selector start $A $R
cloudlinux-selector destroy $A $R

Szkriptben az alábbiakra figyelj:

  • Sikeres parancs után a JSON-kimenet result mezőjének értéke success. Ezt a szkriptben ellenőrizd.
  • A run-script a szkript kimenetét és visszatérési kódját base64-kódolva adja vissza a data mezőben. A base64 -d paranccsal olvashatóvá teheted.
  • Ha a set paranccsal Node.js verziót vagy környezeti változót módosítasz, az alkalmazás az újraindítás után még néhány másodpercig a korábbi értékekkel válaszolhat. Verzióváltás után ellenőrizd, hogy az alkalmazás ténylegesen melyik verzióval fut (process.version). A telepített csomagokat a verzióváltás után nem kellett újratelepíteni.
  • A leállított alkalmazás címe 403-as hibát ad.
  • A destroy a virtuális környezetet törli, de a forráskódot nem. Az Alkalmazás root könyvtárat, a naplófájlt és a domain gyökérkönyvtárában az útvonalhoz létrejött mappát (például public_html/api, benne egy üres .htaccess fájllal) kézzel töröld, mert amíg ez a mappa megvan, a cím 403-as hibát ad.

Hibakeresés

  • Ha az alkalmazás nem indul el, nézd meg a Passenger napló fájl mezőben megadott naplófájlt.
  • Fejlesztés közben a Development mód részletesebb hibaüzeneteket jelenít meg. Éles oldalon ne hagyd bekapcsolva.
  • Az alkalmazás a tárhelyfiók erőforrás-limitjein belül fut. Ha memóriahiány miatt leáll, ellenőrizd az erőforrás-használatot.
Vissza: cPanel leírások (48)