Skapa en Hapi.js-webbapplikation med Node.js på Ubuntu 16.04

Hapi.js är ett rikt, robust och kraftfullt Node.js-ramverk designat för att bygga webbapplikationer i Node.js-ekosystemet. Dess enkla design gör det lätt att komma igång med. Hapi använder många av de senaste JavaScript ES6-funktionerna i sin kärna, som ES6-löften. För er som har använt Express tidigare låter Hapi dig prova något nytt och uppleva alla de senaste JavaScript-funktionerna.

I den här handledningen kommer vårt mål att vara att skapa en grundläggande Hapi.js-webbsida, som är värd från vår Vultr VPS, på Ubuntu 16.04 LTS. För de som har en domän för sin webbplats kommer vi att använda en omvänd proxy för att länka vår domän till vår webbplats. Slutligen kommer vi att lära oss hur man hanterar det med en processledare. Nu när vi har fått det ur vägen, låt oss börja.

Installerar Node.js

Vi kommer att behöva installera Node.js. För att göra det på Ubuntu 16.04 LTS, följ dessa instruktioner.

Lägger till arkivet

Vi kommer att behöva lägga till NodeSource APT-förvaret, som innehåller den senaste LTS-versionen av Node.js.

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

Vi laddar ner ett skript som vi kommer att använda för att lägga till förvaret till vår källlista, samt installera Node.js från NodeSource-förvaret.

Installera byggverktyg

Förutom att installera själva Node.js kommer vi också att behöva installera några nödvändiga byggverktyg, som hjälper till att bygga alla moduler som vi kan behöva installera.

sudo apt-get install -y build-essential

Detta laddar helt enkelt ner och installerar byggverktygen från förvaret.

Konfigurera applikationskatalog

Det är bra att ange en mapp som vi kommer att använda för vår applikation, som kommer att innehålla all vår applikations data, såsom konfigurationsfiler och startskript. Skapa en mapp och döp den till vad du vill. För den här handledningens skull antar jag att du heter den site.

mkdir site

När du har gjort mappen kan vi nu byta till den. Se till att du är i katalogen som du just har skapat, starta NPM-paketguiden.

npm init

Den kommer att be dig att mata in några olika saker, såsom ditt programnamn, startfil, licens och så vidare. De flesta fält kan du lämna som standard, förutom de mer uppenbara fälten, som namnet på din ansökan. I slutändan kommer det se ut så här:

{
  "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"
}

När du är nöjd med resultatet, klicka för ENTERatt spara filen.

Installerar Hapi.js

Nu när din katalog har konstruerats framgångsrikt kan vi nu fortsätta att installera Hapi.js. Som nämnts tidigare kommer vi att använda NPM för att ladda ner Hapi.js, såväl som dess beroenden, för vårt projekt. Kör följande i projektkatalogen.

npm install hapi.js

Detta laddar ner Hapi.js från NPM och installerar det i vår projektkatalog. I samma körning laddas även alla beroenden som Hapi.js kan förlita sig på för vår bekvämlighet.

Konfigurera vår exempelapplikation

Nu är det dags att ställa in vår grundläggande Hapi.js-applikationsfil. Detta kommer att innehålla all vår kod för applikationen. Längre på vägen kan vi utöka vår applikationskod och lägga till fler saker till den, som vi tycker är lämpligt.

Därefter skapar vi vår startfil. Gå tillbaka till mainavsnittet i din package.jsonfil för att bestämma exakt hur filen ska namnges. Eftersom jag använde standardnamnschemat kommer vår fil att heta index.js.

nano index.js

När du är inne i nanotextredigeraren skapar du din basapplikationskod, som så.

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();

Först importerar vi Hapi-modulen. Sedan initierar vi vår serverkonstruktor, som innehåller den värd som vi vill köra servern på, samt porten, som är till 3000för denna handledning. Därefter satte vi upp en grundläggande router, som indikerar att när någon besöker webbplatsen kommer de att hälsas med ett enkelt meddelande. Till råga på allt har vi en asynkronfunktion, för att starta vår server, som loggar till konsolen som vår server kör. När du är klar, spara och stäng filen ( CTRL+ X)

Nu när vår huvudfil är konfigurerad är vi redo att starta vår applikation.

node index.js

Om du ser " Our server is running!" i konsolen, startade servern framgångsrikt.

Installera Nginx

Eftersom Nginx är tillgängligt i Ubuntus standardförråd är installationen enkel. Uppdatera helt enkelt dina paketlistor och installera den.

sudo apt update
sudo apt install nginx -y 

Efter att ha uppdaterat paketlistorna kommer Nginx och dess beroenden att installeras.

Konfigurera Nginx

För att Nginx ska kunna reversera vår applikation med proxy måste vi skapa en konfigurationsfil. Denna konfigurationsfil kommer att innehålla information om vår applikation, som Nginx kommer att använda för den omvända proxyn.

Ta bort standardkonfigurationen som Nginx skapade, eftersom vi kommer att ersätta den med vår egen senare.

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

Skapa en ny fil i sites-availablemappen. När det gäller namngivning kan vi hålla oss till helt enkelt site, för enkelhetens skull.

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

Klistra in följande i filen och spara.

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;
    }
}

I den här filen säger vi åt Nginx att lyssna på port 80. Vi ställer också in proxy-passthrough till localhostadressen och porten 3000, vilket är samma port som vår Hapi-applikation.

Nu kan du navigera tillbaka till din applikationskatalog och starta sajten. När sajten har startat, navigera helt enkelt till http://yourdomain.comeller http://youripså ser du texten " Hello World".

Installera PM2

PM2 kan hittas i NPM-förvaret, och du kan installera det globalt för att vara tillgängligt var som helst, som så.

sudo npm install pm2 -g

Den -gflaggan i slutet tyder på att vi vill installera modulen till mappen globala moduler, vilket gör det möjligt för oss att använda det utanför vår projektkatalog. Detta används för att vårt projekt ska bete sig som en vanlig systemapplikation.

Startar vår app med PM2

När du har installerat PM2, navigera tillbaka till din projektkatalog. Syntaxen för att starta vår applikation kommer att vara något annorlunda nu. Så här kommer vi att göra med PM2.

pm2 start index.js --name site

Vi använder PM2 startfunktionen, som i princip skapar en profil för vår applikation, under namnet site. Efter att ha kört det kommandot kommer din webbplats att starta, men du kommer att märka att loggarna inte visas. Det beror på att sättet vi ser på loggar nu är annorlunda.

pm2 logs site

Du kan till och med ange hur många rader med loggar du vill se, med --linesargumentet.

Slutsats

Du har framgångsrikt konfigurerat en Hapi.js-webbserver, omvänd proxyserver med Nginx och lärt dig hur du hanterar den bättre med PM2. Med denna kunskap kan du utöka den här handledningen ytterligare och skapa en mycket avancerad Hapi.js-applikation. För att lära dig mer om möjligheterna med Hapi, besök deras officiella dokumentation . Om du vill lära dig mer om möjligheterna med PM2, se deras snabbstartsguide .