Kako nastaviti aplikacijo Koa.js Node na Ubuntu 16.04 LTS

V tej vadnici se bomo naučili, kako nastaviti spletno aplikacijo Koa.js za produkcijo z uporabo Node.js. Povezali bomo tudi vzorčno domeno z povratnim proxyjem z uporabo Apache in se naučili, kako jo upravljati z ustreznim upraviteljem procesov. Brez odlašanja začnimo.

Kratek opis Node.js, Koa.js in Apache

Node.js je hiter, večplatformski okvir JavaScript, ki temelji na Chromovem motorju V8. Uporablja se v namiznih in strežniških aplikacijah in je znan po enonitnem ravnanju z zanko dogodkov. Node.js vsebuje register paketov, imenovan Node Package Manager (NPM), ki gosti več kot pol milijona paketov. Paketi (ali moduli) NPM so temeljna hrbtenica Node.js, saj so koda, ki jo poganja skupnost, ki je lahko uporabna v vaši aplikaciji Node.js. V naši aplikaciji Koa.js je Node.js osrednji del njene funkcije.

Koa.js je minimalističen spletni okvir, zgrajen na platformi Node.js. Izdelana s strani iste ekipe, ki stoji za priljubljenim ogrodjem Express.js, njegov cilj je dodatno minimizirati že tako minimalističen okvir Express.js z izključitvijo vmesne programske opreme iz njegovega jedra. Glavna značilnost Koa.js je dejstvo, da ni povratnih klicev. Koa.js je zgrajen na generatorjih, ki temeljijo na ES6, in funkcijah ES6, kot je Promises.

Apache je priljubljen odprtokodni spletni strežnik, ki se uporablja kot zelo osnovno izhodišče za spletne strežnike. V tej vadnici bomo uporabljali Apache kot povratni proxy, ki nam bo omogočil povezavo naše aplikacije z vzorčno domeno. Če nimate domene, bo ta vadnica še vedno delovala za vas, z edino razliko, da bo spletno mesto delovalo na vašem VPS IP, namesto na domeni.

Nastavitev Node.js

Kot pri vsakem ogrodju Node.js boste morali na svoj VPS namestiti Node.js. Zaradi te vadnice predvidevam, da imate Node.js že nameščen v vašem sistemu. Če ne, lahko preprosto sledite navodilom tukaj .

Nastavitev našega imenika aplikacij

Ustvariti bomo morali mapo, ki bo vsebovala osnovne datoteke naše aplikacije.

mkdir site

Lahko ga zamenjate sites katerim koli drugim imenom, ki ga želite za imenik. Nato bomo morali inicializirati našo datoteko paketa Node.js. Preklopite v imenik, ki ste ga pravkar ustvarili, zaženite npm initin izpolnite pozive. Na koncu naj bi izgledalo nekako takole:

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

Namestitev Koa.js

Zdaj, ko imamo nastavljen imenik, lahko nadaljujemo z namestitvijo Koa.js. V trenutni delovni imenik /sitevnesite naslednje.

npm install koa

S tem boste prenesli modul Koa.js iz NPM in ga namestili v naš projektni imenik za nadaljnjo uporabo. Nato bomo ustvarili vzorčno aplikacijsko datoteko, ki bo vsebovala našo kodo aplikacije. Če želite to narediti, ustvarite index.jsdatoteko.

nano index.js

Ko ste znotraj datoteke, ustvarite vzorčno aplikacijo.

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

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

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

Shranite in zaprite datoteko. CTRL+ X.

Poskrbeli bomo, da bo naša aplikacija pravilno delovala. Če ga želite zagnati, zaženite node index.jsin videli boste Website is livev konzoli.

Namestitev Apache

Zdaj, ko vemo, da je naše spletno mesto funkcionalno, lahko nadaljujemo z namestitvijo Apache in njegovih odvisnosti.

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

Za uporabo funkcije povratnega proxyja, ki jo najdemo v Apache, bomo morali omogočiti potrebne module.

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

Nekateri od teh modulov so morda že omogočeni, vendar jih je vedno dobro preveriti.

Zdaj moramo urediti privzeto konfiguracijsko datoteko za Apache.

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

Tukaj bomo morali dodati blok za našo aplikacijo.

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

    ServerName localhost
</VirtualHost>

Shranite datoteko, CTRL+ X.

Morda boste opazili, da uporabljamo vrata 3000kot vrata za naš ProxyPassin ProxyPassReverseIP. Ker gre za ista vrata, na katerih izvajamo našo aplikacijo Koa.js, je nujno, da vnesemo ustrezna vrata.

Ko bodo spremembe na mestu, bomo morali znova zagnati Apache in znova zagnati našo aplikacijo Koa.js.

sudo systemctl restart apache2

To bo zagotovilo, da je naša konfiguracijska datoteka aktivna in pripravljena za delo, ko zaženemo našo aplikacijo Koa.js. Ko se Apache znova zažene, se pomaknite nazaj do imenika vašega spletnega mesta in zaženite aplikacijo Koa.js, kot smo to storili prej. V spletnem brskalniku se pomaknite do http://yourdomain, ali http://yourip:in videli boste »Hello World«.

Upravljanje naše aplikacije s sistemom systemd

Zdaj, ko smo pokrili osnove ustvarjanja vzorčne aplikacije Koa.js, se zavedamo, da je v produkcijskem okolju zagon aplikacije, kot smo zdaj, nepraktičen. Vodja procesov je vsekakor pogoj. Tu pride v poštev systemd. Preprosto povedano, systemd je sestavljen iz programske opreme, ki zagotavlja gradnike za sistem Linux. Podobno kot "init" zagotavlja sistem za upravljanje uporabniških procesov po zagonu sistema. V primeru naše aplikacije nam sistemd omogoča samodejno zagon našega spletnega mesta po ponovnem zagonu sistema, če pride do dogodka, ki moti delovanje sistema. Zagotavlja tudi nabor orodij, ki so lahko priročna pri upravljanju naše aplikacije. Najboljši del je dejstvo, da je vgrajen v Ubuntu 16.04 LTS, tako da nam ni treba namestiti dodatne programske opreme.

Ustvarite storitev systemd

Vse, kar potrebujemo za zagon naše aplikacije, bo v datoteki z imenom service. Vsebuje podrobnosti o naši aplikaciji, kot so njeno ime, imenik, okolje in drugo. Če želite ustvariti našo sistemsko datoteko, odprite urejevalnik besedil.

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

Uredite in shranite datoteko takole.

[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

Zamenjajte youruserz uporabniškim imenom vašega strežnika. Tukaj je kratek pregled pomembnih polj:

• After - To obvesti systemd, naj počaka, da je omrežni vmesnik pripravljen, preden zažene našo aplikacijo.
• Environment- Tukaj lahko določimo spremenljivke okolja za našo aplikacijo. Naša vrata Node.js so eno izmed njih.
• Type - To obvešča systemd, da je našo aplikacijo mogoče samo zagnati, ne da bi razcepili uporabniške privilegije in podobno.
• User- To sistemud pove, da želimo zagnati aplikacijo pod našim uporabniškim računom, kar je priporočljivo. Zagon aplikacij kot root uporabnik lahko povzroči številne varnostne kompromise.
• ExecStart - V bistvu ukaz, ki ga bo sistemd zagnal za zagon naše aplikacije, podobno kot smo jo prej zagnali ročno.
• Restart- Sistemd-u pove, pod katerimi pogoji naj znova zažene našo aplikacijo. V tem primeru želimo, da se naše spletno mesto znova zažene v primeru napake.

Zaženite storitev systemd

Zdaj smo pripravljeni zagnati našo storitev systemd.

sudo systemctl daemon-reload

To je potrebno vsakič, ko se spremeni datoteka storitve systemd, da sistemd registrira vse nove spremembe.

Nato zaženite aplikacijo.

sudo systemctl start site

V brskalniku se še enkrat pomaknite do spletnega mesta, da preverite, ali vse deluje.

Ključne sistemske funkcije upravljanja

• stop - Popolnoma ustavi aplikacijo.
• restart - Ustavi aplikacijo in jo znova zažene z novim postopkom.
• enable - Sistemd-u pove, naj zažene aplikacijo vsakič, ko zaženete računalnik.
• status - Prikaže informacije o trenutno delujoči aplikaciji, kot so čas delovanja, stanje aplikacije in drugo.

Če želite uporabiti katero koli od teh funkcij, zaženite naslednje.

systemctl <function> site

Zaključek

Uspešno smo postavili aplikacijo Koa.js in se naučili, kako jo obrniti proxy ter jo upravljati s sistemom systemd. Zdaj ste pripravljeni razširiti svojo aplikacijo in nadgraditi ta primer. Če želite izvedeti več o Koa.js in več stvari, s katerimi lahko počnete, obiščite njihovo spletno mesto za več koristnih informacij. Poleg tega, če želite izvedeti več o upravitelju procesov systemd, preberite dokumentacijo zanj tukaj . Nazadnje, če želite izvedeti več o Apachejevem povratnem proxyju, si ga lahko ogledate tukaj .