Hur man ställer in en Koa.js Node-applikation på Ubuntu 16.04 LTS

I den här handledningen kommer vi att lära oss hur man konfigurerar en Koa.js-webbapplikation för produktion med hjälp av Node.js. Vi kommer också att länka en exempeldomän, med en omvänd proxy, med Apache, och lära oss hur man hanterar den med en korrekt processhanterare. Utan vidare, låt oss komma igång.

Kort beskrivning av Node.js, Koa.js och Apache

Node.js är ett snabbt JavaScript-ramverk för flera plattformar baserat på Chromes V8-motor. Den används i både skrivbords- och serverapplikationer och är känd för sin entrådade hantering av händelseslingor. Node.js har ett paketregister som heter Node Package Manager (NPM), som är värd för över en halv miljon paket. NPM-paket (eller moduler) är kärnan i Node.js, eftersom de är community-driven kod som kan vara användbar i din Node.js-applikation. I vår Koa.js-app är Node.js kärnan i dess funktion.

Koa.js är ett minimalistiskt webbramverk, byggt på Node.js-plattformen. Tillverkad av samma team bakom det populära Express.js-ramverket, dess mål är att ytterligare minimera det redan minimalistiska Express.js-ramverket genom att utesluta mellanprogram från dess kärna. En viktig egenskap hos Koa.js är det faktum att det inte finns några återuppringningar. Koa.js är byggt på ES6-baserade generatorer och ES6-funktioner, såsom Promises.

Apache är en populär webbserver med öppen källkod, som används som en mycket grundläggande utgångspunkt för webbservrar. I den här handledningen kommer vi att använda Apache som en omvänd proxy, vilket gör att vi kan länka vår applikation till en exempeldomän. Om du inte har en domän kommer den här handledningen fortfarande att fungera för dig, med den enda skillnaden är att webbplatsen kommer att köras på din VPS IP istället för en domän.

Konfigurera Node.js

Som med alla Node.js ramverk måste du installera Node.js på din VPS. För den här handledningens skull kommer jag att anta att du redan har Node.js installerat på ditt system. Om inte kan du helt enkelt följa instruktionerna här .

Konfigurera vår applikationskatalog

Vi kommer att behöva skapa en mapp som innehåller vår applikations kärnfiler.

mkdir site

Ersätt sitegärna med något annat namn du vill ha för katalogen. Därefter måste vi initiera vår Node.js-paketfil. Byt till katalogen du just har skapat och kör npm init, och slutför uppmaningarna. I slutändan borde det se ut ungefär så här:

{
  "name": "site",
  "version": "1.0.0",
  "description": "Koa.js Site",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "yourname",
  "license": "ISC"
}

Installerar Koa.js

Nu när vi har ställt in vår katalog kan vi fortsätta att installera Koa.js. I den aktuella arbetskatalogen, /site, skriv följande.

npm install koa

Detta kommer att ladda ner Koa.js-modulen från NPM och installera den i vår projektkatalog för framtida användning. Därefter skapar vi vår exempelapplikationsfil som kommer att innehålla vår appkod. Skapa en index.jsfil för att göra det.

nano index.js

När du är inne i filen skapar du en exempelapplikation.

const Koa = require('koa');
const app = new Koa();

app.use(async ctx => {
     ctx.body = 'Hello World';
 });

app.listen(3000);
console.log('Website is live!')

Spara och stäng filen. CTRL+ X.

Vi vill se till att vår applikation fungerar korrekt. För att starta den, kör node index.js, så ser du Website is livei konsolen.

Installerar Apache

Nu när vi vet att vår webbplats är funktionell kan vi fortsätta att installera Apache och dess beroenden.

sudo apt install -y libapache2-mod-proxy-html libxml2-dev

För att kunna använda den omvända proxyfunktionen som finns i Apache måste vi aktivera de nödvändiga modulerna.

a2enmod proxy
a2enmod proxy_http
a2enmod proxy_ajp
a2enmod rewrite
a2enmod deflate
a2enmod headers
a2enmod proxy_balancer
a2enmod proxy_connect
a2enmod proxy_html

Vissa av dessa moduler kan redan ha aktiverats, men det är alltid bra att dubbelkolla dem.

Nu måste vi redigera standardkonfigurationsfilen för Apache.

sudo nano /etc/apache2/sites-enabled/000-default.conf

Här måste vi lägga till ett block för vår ansökan.

<VirtualHost *:*>
    ProxyPreserveHost On
    ProxyPass / http://0.0.0.0:3000/
    ProxyPassReverse / http://0.0.0.0:3000

    ServerName localhost
</VirtualHost>

Spara filen, CTRL+ X.

Du kanske märker att vi använder port 3000som port för vår ProxyPassoch ProxyPassReverseIP. Eftersom det är samma port som vi kör vår Koa.js-applikation på, är det absolut nödvändigt att vi matar in rätt port.

När ändringarna är på plats måste vi starta om Apache och starta om vår Koa.js-applikation.

sudo systemctl restart apache2

Detta kommer att säkerställa att vår konfigurationsfil är aktiv och redo att fungera när vi startar vår Koa.js-applikation. När Apache har startat om, navigera tillbaka till din webbplatskatalog och starta Koa.js-applikationen som vi gjorde tidigare. Från din webbläsare, navigera till http://yourdomain, eller http://yourip:, och du kommer att se "Hello World".

Hantera vår applikation med systemd

Nu när vi har täckt grunderna för att skapa ett exempel på en Koa.js-applikation inser vi att det i en produktionsmiljö är opraktiskt att starta applikationen som vi är nu. En processledare är definitivt ett krav. Det är där systemd kommer in i bilden. Enkelt uttryckt består systemd av programvara som tillhandahåller byggstenar för ett Linux-system. I likhet med "init" tillhandahåller det ett system för att hantera användarprocesser efter systemstart. När det gäller vår applikation tillåter systemd oss ​​att automatiskt starta vår webbplats efter att systemet har startat om, om det skulle inträffa en händelse som stör systemets drifttid. Den tillhandahåller också en uppsättning verktyg som kan komma väl till pass när du hanterar vår applikation. Det bästa är det faktum att det är inbyggt i Ubuntu 16.04 LTS, så vi behöver inte installera någon ytterligare programvara.

Skapa systemd tjänst

Allt vi behöver för att starta vår applikation kommer att finnas i en fil som heter service. Den innehåller detaljer om vår app, som dess namn, katalog, miljö och mer. För att skapa vår systemfil, öppna en textredigerare.

sudo nano /lib/systemd/system/site.service

Redigera och spara filen så här.

[Unit]
Description=desc here
Documentation=https://example.com
After=network.target

[Service]
Environment=NODE_PORT=3000
Type=simple
User=youruser
ExecStart=/usr/bin/node /home/[youruser]/site/index.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Ersätt yourusermed användarnamnet på din server. Här är en snabb sammanfattning av de viktiga fälten:

• After - Detta informerar systemd om att vänta tills nätverksgränssnittet är klart innan vi startar vår applikation.
• Environment– Här kan vi specificera miljövariabler för vår applikation. Vår Node.js-port är en av dem.
• Type – Det här informerar systemd om att vår app bara kan startas upp, utan att förkasta användarrättigheter och så.
• User– Detta talar om för systemd att vi vill köra applikationen under vårt användarkonto, vilket rekommenderas. Att köra applikationer som rotanvändare kan leda till många säkerhetskomprometteringar.
• ExecStart - I huvudsak kommandot som systemd kommer att köra för att starta vår applikation, liknande hur vi startade det manuellt tidigare.
• Restart- Talar om för systemd under vilka förutsättningar vi ska starta om vår applikation. I det här fallet vill vi att vår webbplats ska startas om i händelse av ett fel.

Starta systemd-tjänsten

Vi är nu redo att starta vår systemd-tjänst.

sudo systemctl daemon-reload

Detta är nödvändigt närhelst en systemd-tjänstfil ändras för att systemd ska kunna registrera eventuella nya ändringar som görs.

Starta sedan din ansökan.

sudo systemctl start site

Navigera till webbplatsen i din webbläsare igen för att kontrollera att allt fungerar.

Viktiga systemhanteringsfunktioner

• stop - Stoppar applikationen helt.
• restart - Stoppar applikationen och startar den igen under en ny process.
• enable - Beordrar systemd att starta programmet när du startar din dator.
• status - Visar information om den applikation som körs för närvarande, såsom drifttid, applikationsstatus och mer.

För att använda någon av dessa funktioner, kör följande.

systemctl <function> site

Slutsats

Vi har framgångsrikt konfigurerat en Koa.js-applikation och lärt oss hur man omvänder proxy den, samt hanterar den med systemd. Du är nu redo att utöka din applikation och bygga vidare på detta exempel. Om du vill lära dig mer om Koa.js och fler saker du kan göra med, besök deras webbplats för mer användbar information. Utöver det, om du vill lära dig mer om systemds processhanterare, läs dokumentationen för det här . Slutligen, om du vill lära dig mer om Apaches omvända proxy, kolla gärna in dem här .