Vytvorte webovú aplikáciu Hapi.js pomocou Node.js na Ubuntu 16.04

Hapi.js je bohatý, robustný a výkonný rámec Node.js určený na vytváranie webových aplikácií v ekosystéme Node.js. Jeho jednoduchý dizajn uľahčuje začiatok. Hapi vo svojom jadre využíva mnohé z najnovších funkcií JavaScript ES6, ako napríklad sľuby ES6. Pre tých z vás, ktorí už Express používali, Hapi umožňuje vyskúšať niečo nové a vyskúšať všetky najnovšie funkcie JavaScriptu.

V tomto návode bude naším cieľom nastaviť základnú webovú stránku Hapi.js, ktorá je hosťovaná z nášho Vultr VPS, na Ubuntu 16.04 LTS. Pre tých, ktorí majú doménu pre svoje stránky, použijeme reverzný proxy na prepojenie našej domény s našou webovou stránkou. Nakoniec sa naučíme, ako to zvládnuť s procesným manažérom. Teraz, keď to už máme z cesty, začnime.

Inštalácia Node.js

Budeme musieť nainštalovať Node.js. Ak tak chcete urobiť na Ubuntu 16.04 LTS, postupujte podľa týchto pokynov.

Pridanie úložiska

Budeme musieť pridať úložisko NodeSource APT, ktoré obsahuje najnovšie vydanie LTS Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs

Sťahujeme skript, ktorý použijeme na pridanie úložiska do nášho zoznamu zdrojov, ako aj inštaláciu Node.js z úložiska NodeSource.

Inštalácia nástrojov na zostavenie

Okrem inštalácie samotného Node.js budeme musieť nainštalovať aj niektoré potrebné nástroje na zostavovanie, ktoré nám pomôžu pri zostavovaní modulov, ktoré možno budeme musieť nainštalovať.

sudo apt-get install -y build-essential

Toto jednoducho stiahne a nainštaluje nástroje na zostavovanie z úložiska.

Nastavenie adresára aplikácie

Je dobrou praxou určiť priečinok, ktorý budeme používať pre našu aplikáciu a ktorý bude obsahovať všetky údaje našej aplikácie, ako sú konfiguračné súbory a spúšťacie skripty. Vytvorte priečinok a pomenujte ho, ako chcete. V záujme tohto tutoriálu predpokladám, že ste to pomenovali site.

mkdir site

Po vytvorení priečinka sa doň môžeme zmeniť. Uistite sa, že ste v adresári, ktorý ste práve vytvorili, a spustite sprievodcu balíkom NPM.

npm init

Požiada vás o zadanie niekoľkých rôznych vecí, ako je názov vašej aplikácie, štartovací súbor, licencia atď. Väčšinu polí môžete ponechať predvolenú, s výnimkou zrejmejších polí, ako je názov vašej aplikácie. Nakoniec to bude vyzerať takto:

{
  "name": "site",
  "version": "1.0.0",
  "description": "Hapi.js site",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "rich",
  "license": "MIT"
}

Keď ste s výsledkom spokojní, kliknutím ENTERsúbor uložte.

Inštalácia Hapi.js

Teraz, keď bol váš adresár úspešne zostavený, môžeme pristúpiť k inštalácii Hapi.js. Ako už bolo spomenuté, na stiahnutie Hapi.js, ako aj jeho závislostí, pre náš projekt použijeme NPM. V adresári projektu spustite nasledovné.

npm install hapi.js

Týmto sa stiahne Hapi.js z NPM a nainštaluje sa do nášho adresára projektu. Zároveň sa pre naše pohodlie stiahnu aj všetky závislosti, na ktoré sa Hapi.js môže spoliehať.

Nastavenie našej vzorovej aplikácie

Teraz je čas nastaviť náš základný súbor aplikácie Hapi.js. Toto bude obsahovať celý náš kód pre aplikáciu. Ďalej na ceste môžeme rozšíriť náš aplikačný kód a pridať doň ďalšie veci, ako uznáme za vhodné.

Ďalej vytvoríme náš štartovací súbor. Vráťte sa späť do mainčasti vášho package.jsonsúboru, kde presne určíte, ako súbor pomenovať. Keďže som použil predvolenú schému pomenovania, náš súbor sa bude volať index.js.

nano index.js

Keď ste v textovom editore nano, vytvorte si kód základnej aplikácie.

const Hapi=require('hapi');
const server=Hapi.server({
    host:'localhost',
    port: 3000
});

server.route({
    method:'GET',
    path:'/',
    handler:((request,h)) => {
        return 'Sample Hapi.js Application';
    }
});
async function start() {

    try {
        await server.start();
    } catch (err) {
        console.log(err);
        process.exit(1);
    }
    console.log(`Our server is running! ${server.info.uri}`);
};

start();

Najprv importujeme modul Hapi. Potom inicializujeme náš konštruktor servera, ktorý obsahuje hostiteľa, na ktorom chceme server spustiť, ako aj port, ktorý je 3000pre tento tutoriál. Ďalej nastavíme základný smerovač, ktorý znamená, že vždy, keď niekto navštívi stránku, bude privítaný jednoduchou správou. K tomu všetkému máme asynchrónnu funkciu na spustenie nášho servera, ktorý sa prihlási do konzoly, na ktorej náš server beží. Po dokončení uložte a zatvorte súbor ( CTRL+ X)

Teraz, keď je náš hlavný súbor nastavený, sme pripravení spustiť našu aplikáciu.

node index.js

Ak Our server is running!v konzole vidíte „ “, server sa úspešne spustil.

Nainštalujte Nginx

Keďže Nginx je k dispozícii v predvolených úložiskách Ubuntu, inštalácia je jednoduchá. Jednoducho aktualizujte zoznamy balíkov a nainštalujte ich.

sudo apt update
sudo apt install nginx -y 

Po obnovení zoznamov balíkov sa nainštaluje Nginx a jeho závislosti.

Nakonfigurujte Nginx

Aby Nginx mohol zvrátiť proxy našu aplikáciu, budeme musieť vytvoriť konfiguračný súbor. Tento konfiguračný súbor bude obsahovať informácie o našej aplikácii, ktorú Nginx použije pre reverzný proxy.

Odstráňte predvolenú konfiguráciu, ktorú vytvoril Nginx, pretože ju neskôr nahradíme vlastnou.

sudo rm /etc/nginx/sites-enabled/default

Vytvorte nový súbor v sites-availablepriečinku. Čo sa týka pomenovania site, pre jednoduchosť sa môžeme držať jednoducho .

sudo nano /etc/nginx/sites-available/site

Do súboru prilepte nasledovné a uložte.

server {
    listen 80;
    location / {
          proxy_set_header X-Real-IP 
          $remote_addr;
          proxy_set_header 
          X-Forwarded-For 
          $proxy_add_x_forwarded_for;
          proxy_set_header Host 
          $http_host;
          proxy_set_header 
        X-NginX-Proxy true; proxy_pass 
       http://127.0.0.1:3000/;
    proxy_redirect off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade 
     $http_upgrade;
    proxy_set_header Connection 
    "upgrade";
    proxy_redirect off;
    proxy_set_header 
   X-Forwarded-Proto $scheme;
    }
}

V tomto súbore hovoríme Nginxu, aby počúval na porte 80. Taktiež nastavujeme proxy priechod na localhostadresu a port 3000, čo je rovnaký port ako naša aplikácia Hapi.

Teraz sa môžete vrátiť späť do adresára aplikácie a spustiť stránku. Po spustení stránky jednoducho prejdite na položku http://yourdomain.comalebo http://youripa zobrazí sa text „ Hello World“.

Nainštalujte PM2

PM2 nájdete v úložisku NPM a môžete si ho nainštalovať globálne, aby bol prístupný odkiaľkoľvek.

sudo npm install pm2 -g

-gVlajka na konci znamená, že chceme, aby inštaláciu modulu do zložky globálnych modulov, čo nám umožní používať mimo našu adresári projektu. Používa sa na to, aby sa náš projekt správal ako bežná systémová aplikácia.

Spustenie našej aplikácie s PM2

Po nainštalovaní PM2 prejdite späť do adresára projektu. Syntax na spustenie našej aplikácie bude teraz mierne odlišná. Takto to urobíme s PM2.

pm2 start index.js --name site

Využívame funkciu PM2 start, ktorá v podstate vytvára profil pre našu aplikáciu pod názvom site. Po spustení tohto príkazu sa váš web spustí, ale všimnete si, že protokoly sa nezobrazia. Je to preto, že spôsob, akým teraz prezeráme protokoly, je iný.

pm2 logs site

Pomocou --linesargumentu môžete dokonca určiť, koľko riadkov denníkov chcete vidieť .

Záver

Úspešne ste nastavili webový server Hapi.js, spätne ste ho pripojili pomocou Nginx a naučili ste sa, ako ho lepšie spravovať pomocou PM2. S týmito znalosťami môžete tento návod ďalej rozšíriť a vytvoriť veľmi pokročilú aplikáciu Hapi.js. Ak sa chcete dozvedieť viac o možnostiach Hapi, navštívte ich oficiálnu dokumentáciu . Ak sa chcete dozvedieť viac o možnostiach PM2, pozrite si ich príručku pre rýchly štart .