Sådan konfigureres en Koa.js Node-applikation på Ubuntu 16.04 LTS

I denne vejledning lærer vi, hvordan man opsætter en Koa.js-webapplikation til produktion ved hjælp af Node.js. Vi vil også forbinde et eksempeldomæne med en omvendt proxy ved hjælp af Apache og lære, hvordan man administrerer det med en ordentlig procesmanager. Lad os uden videre komme i gang.

Kort beskrivelse af Node.js, Koa.js og Apache

Node.js er en hurtig JavaScript-ramme på tværs af platforme baseret på Chromes V8-motor. Den bruges i både desktop- og serverapplikationer og er berømt for sin enkelttrådede hændelsesløkkehåndtering. Node.js har et pakkeregister kaldet Node Package Manager (NPM), som er vært for over en halv million pakker. NPM-pakker (eller moduler) er kernerygraden i Node.js, da de er fællesskabsdrevet kode, der kan være nyttig i din Node.js-applikation. I vores Koa.js-app er Node.js kernedelen af ​​dens funktion.

Koa.js er en minimalistisk webramme, bygget på Node.js platformen. Lavet af det samme team bag det populære Express.js-framework, dets mål er at minimere den allerede minimalistiske Express.js-ramme yderligere ved at udelukke middleware fra dens kerne. Et vigtigt træk ved Koa.js er, at der ikke er nogen tilbagekald. Koa.js er bygget på ES6-baserede generatorer og ES6-funktioner, såsom Promises.

Apache er en populær open source-webserver, der bruges som et meget grundlæggende udgangspunkt for webservere. I denne vejledning vil vi bruge Apache som en omvendt proxy, som giver os mulighed for at linke vores applikation til et eksempeldomæne. Hvis du ikke har et domæne, vil denne vejledning stadig fungere for dig, med den eneste forskel, at hjemmesiden kører på din VPS IP i stedet for et domæne.

Opsætning af Node.js

Som med enhver Node.js-ramme skal du installere Node.js på din VPS. Af hensyn til denne tutorial vil jeg antage, at du allerede har Node.js installeret på dit system. Hvis ikke, kan du blot følge instruktionerne her .

Opsætning af vores applikationskatalog

Vi bliver nødt til at oprette en mappe, som vil indeholde vores applikations kernefiler.

mkdir site

Du er velkommen til at erstatte sitemed et hvilket som helst andet navn, du ønsker til biblioteket. Dernæst skal vi initialisere vores Node.js-pakkefil. Skift til den mappe, du lige har oprettet, og kør npm init, og udfyld meddelelserne. I sidste ende skulle det se sådan ud:

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

Installerer Koa.js

Nu hvor vi har vores bibliotek sat op, kan vi fortsætte med at installere Koa.js. I den aktuelle arbejdsmappe, /site, skriv følgende.

npm install koa

Dette vil downloade Koa.js-modulet fra NPM og installere det i vores projektmappe til fremtidig brug. Dernæst vil vi oprette vores eksempelapplikationsfil, der vil indeholde vores app-kode. For at gøre det skal du oprette en index.jsfil.

nano index.js

Når du er inde i filen, skal du oprette et eksempelprogram.

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

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

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

Gem og luk filen. CTRL+ X.

Vi vil gerne sikre os, at vores applikation kører korrekt. For at starte den skal du køre node index.js, og du vil se Website is livei konsollen.

Installation af Apache

Nu hvor vi ved, at vores hjemmeside er funktionel, kan vi fortsætte med at installere Apache og dens afhængigheder.

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

For at bruge den omvendte proxy-funktion, der findes i Apache, bliver vi nødt til at aktivere de nødvendige moduler.

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

Nogle af disse moduler er muligvis allerede aktiveret, men det er altid godt at dobbelttjekke dem.

Nu skal vi redigere standardkonfigurationsfilen for Apache.

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

Her skal vi tilføje en blok til vores ansøgning.

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

    ServerName localhost
</VirtualHost>

Gem filen, CTRL+ X.

Du bemærker måske, at vi bruger port 3000som port for vores ProxyPassog ProxyPassReverseIP. Da det er den samme port, som vi kører vores Koa.js-applikation på, er det bydende nødvendigt, at vi indtaster den korrekte port.

Når ændringerne er på plads, bliver vi nødt til at genstarte Apache og genstarte vores Koa.js-applikation.

sudo systemctl restart apache2

Dette vil sikre, at vores konfigurationsfil er aktiv og klar til at fungere, når vi starter vores Koa.js-applikation. Når Apache er genstartet, skal du navigere tilbage til dit webstedsbibliotek og starte Koa.js-applikationen, som vi gjorde tidligere. Fra din webbrowser skal du navigere til http://yourdomain, eller http://yourip:, og du vil se "Hello World".

Håndtering af vores applikation med systemd

Nu hvor vi har dækket det grundlæggende i at skabe et eksempel på en Koa.js-applikation, indser vi, at det i et produktionsmiljø er upraktisk at starte applikationen, som vi er nu. En procesleder er bestemt et krav. Det er her systemd kommer ind i billedet. Enkelt sagt består systemd af software, der giver byggeklodser til et Linux-system. I lighed med "init" giver det et system til at styre brugerprocesser efter systemstart. I tilfælde af vores applikation giver systemd os mulighed for automatisk at starte vores hjemmeside, efter at systemet er blevet genstartet, i tilfælde af at der er en hændelse, der forstyrrer systemets oppetid. Det giver også et sæt værktøjer, der kan være nyttige, når du administrerer vores applikation. Det bedste er, at det er indbygget i Ubuntu 16.04 LTS, så vi behøver ikke at installere yderligere software.

Opret systemd service

Alt hvad vi behøver for at starte vores applikation vil være indeholdt i en fil kaldet service. Den indeholder detaljer om vores app, såsom dens navn, bibliotek, miljø og mere. For at oprette vores systemfil skal du åbne en teksteditor.

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

Rediger og gem filen på denne måde.

[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

Erstat yourusermed brugernavnet på din server. Her er en hurtig gennemgang af de vigtige felter:

• After - Dette informerer systemd om at vente, indtil netværksgrænsefladen er klar, før du starter vores applikation.
• Environment- Her kan vi specificere miljøvariabler til vores applikation. Vores Node.js-port er en af ​​dem.
• Type - Dette informerer systemd om, at vores app bare kan startes op, uden at forkaste brugerrettigheder og sådan.
• User- Dette fortæller systemd, at vi ønsker at køre applikationen under vores brugerkonto, hvilket anbefales. At køre applikationer som root-bruger kan føre til mange sikkerhedskompromitteringer.
• ExecStart - Grundlæggende kommandoen som systemd vil køre for at starte vores applikation, svarende til hvordan vi startede den manuelt før.
• Restart- Fortæller systemd, under hvilke betingelser vi skal genstarte vores applikation. I dette tilfælde ønsker vi at få vores hjemmeside genstartet i tilfælde af en fejl.

Start systemd-tjenesten

Vi er nu klar til at starte vores systemd service.

sudo systemctl daemon-reload

Dette er nødvendigt, når en systemd-tjenestefil ændres, for at systemd kan registrere eventuelle nye ændringer.

Start derefter din ansøgning.

sudo systemctl start site

Naviger til webstedet i din browser igen for at kontrollere, at alt fungerer.

Nøgle systemd administrationsfunktioner

• stop - Stopper applikationen helt.
• restart - Stopper applikationen og starter den igen under en ny proces.
• enable - Beder systemd om at starte programmet, hver gang du starter din computer.
• status - Viser information om den aktuelt kørende applikation, såsom oppetid, applikationstilstand og mere.

For at bruge nogen af ​​disse funktioner skal du køre følgende.

systemctl <function> site

Konklusion

Vi har med succes opsat en Koa.js-applikation og lært, hvordan man omvendt proxy det, samt administrere det med systemd. Du er nu klar til at udvide din applikation og bygge videre på dette eksempel. Hvis du gerne vil lære mere om Koa.js og flere ting, du kan gøre med, kan du besøge deres hjemmeside for mere nyttig information. Ud over det, hvis du gerne vil lære mere om systemds procesmanager, kan du læse dokumentationen til det her . Endelig, hvis du gerne vil lære mere om Apaches omvendte proxy, er du velkommen til at tjekke dem ud her .