Koa.js sõlmerakenduse seadistamine Ubuntu 16.04 LTS-is

Selles õpetuses õpime, kuidas seadistada Koa.js veebirakendust Node.js-i abil tootmiseks. Samuti linkime näidisdomeeni pöördpuhverserveriga, kasutades Apache'i, ja õpime, kuidas seda korraliku protsessihalduriga hallata. Ilma pikema jututa alustame.

Node.js, Koa.js ja Apache lühikirjeldus

Node.js on kiire, platvormideülene JavaScripti raamistik, mis põhineb Chrome'i V8 mootoril. Seda kasutatakse nii töölaua- kui ka serverirakendustes ning see on kuulus oma ühe lõimega sündmusteahela käsitlemise poolest. Node.js sisaldab pakettide registrit nimega Node Package Manager (NPM), mis majutab üle poole miljoni paketi. NPM-paketid (või moodulid) on Node.js-i põhiline selgroog, kuna need on kogukonna juhitud kood, mis võib teie Node.js-i rakenduses kasulik olla. Meie rakenduses Koa.js on Node.js selle funktsiooni põhiosa.

Koa.js on minimalistlik veebiraamistik, mis on üles ehitatud Node.js platvormile. Populaarse Express.js raamistiku taga oleva sama meeskonna poolt loodud selle eesmärk on niigi minimalistlikku Express.js raamistikku veelgi minimeerida, jättes selle tuumast välja vahevara. Koa.js-i peamine omadus on see, et tagasihelistamisi pole. Koa.js on üles ehitatud ES6-põhistele generaatoritele ja ES6 funktsioonidele, nagu Promises.

Apache on populaarne avatud lähtekoodiga veebiserver, mida kasutatakse veebiserverite jaoks väga lihtsa lähtepunktina. Selles õpetuses kasutame Apache'i pöördpuhverserverina, mis võimaldab meil linkida oma rakenduse näidisdomeeniga. Kui teil pole domeeni, töötab see õpetus endiselt teie jaoks, ainsa erinevusega, et veebisait töötab teie VPS-i IP-aadressil, mitte domeenil.

Node.js seadistamine

Nagu iga Node.js raamistiku puhul, peate installima Node.js'i oma VPS-i. Selle õpetuse huvides eeldan, et teie süsteemis on Node.js juba installitud. Kui ei ole, siis saad lihtsalt järgige siin .

Meie rakenduste kataloogi seadistamine

Peame looma kausta, mis sisaldab meie rakenduse põhifaile.

mkdir site

Asendage julgelt sitemis tahes muu nimega, mida soovite kataloogis kasutada. Järgmiseks peame lähtestama paketifaili Node.js. Minge äsja loodud kataloogi, käivitage npm initja täitke juhised. Lõpuks peaks see välja nägema umbes selline:

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

Koa.js installimine

Nüüd, kui oleme oma kataloogi seadistanud, saame jätkata Koa.js installimist. Tippige praegusesse töökataloogi /sitejärgmine tekst.

npm install koa

See laadib mooduli Koa.js NPM-ist alla ja installib selle edaspidiseks kasutamiseks meie projektikataloogi. Järgmisena loome oma näidisrakenduse faili, mis sisaldab meie rakenduse koodi. Selleks looge index.jsfail.

nano index.js

Kui olete faili sees, looge näidisrakendus.

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

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

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

Salvestage ja sulgege fail. CTRL+ X.

Tahame veenduda, et meie rakendus töötab korralikult. Selle käivitamiseks käivitage node index.jsja näete Website is livekonsoolis.

Apache installimine

Nüüd, kui teame, et meie veebisait töötab, saame jätkata Apache'i ja selle sõltuvuste installimist.

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

Apache'is leiduva pöördpuhverserveri funktsiooni kasutamiseks peame lubama vajalikud moodulid.

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

Mõned neist moodulitest võivad olla juba lubatud, kuid alati on hea neid üle kontrollida.

Nüüd peame muutma Apache'i vaikekonfiguratsioonifaili.

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

Siin peame oma rakenduse jaoks lisama ploki.

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

    ServerName localhost
</VirtualHost>

Salvestage fail, CTRL+ X.

Võite märgata, et kasutame 3000oma ProxyPassja ProxyPassReverseIP pordina porti . Kuna see on sama port, millel meie rakendus Koa.js töötab, on hädavajalik sisestada õige port.

Kui muudatused on paigas, peame taaskäivitama Apache ja taaskäivitama rakenduse Koa.js.

sudo systemctl restart apache2

See tagab, et meie konfiguratsioonifail on rakenduse Koa.js käivitamisel aktiivne ja töövalmis. Kui Apache on taaskäivitatud, liikuge tagasi oma saidi kataloogi ja käivitage rakendus Koa.js nagu varem. Liikuge oma veebibrauseris aadressile http://yourdomainvõi http://yourip:ja näete "Tere maailm".

Meie rakenduse haldamine süsteemiga

Nüüd, kui oleme käsitlenud Koa.js-i näidisrakenduse loomise põhitõdesid, mõistame, et tootmiskeskkonnas on rakenduse käivitamine praegusel kujul ebapraktiline. Protsessijuht on kindlasti nõutav. Siin tulebki mängu systemd. Lihtsamalt öeldes koosneb systemd tarkvarast, mis pakub Linuxi süsteemi ehitusplokke. Sarnaselt "initiga" pakub see süsteemi kasutajaprotsesside haldamiseks pärast süsteemi käivitamist. Meie rakenduse puhul võimaldab systemd meil oma veebisaiti automaatselt käivitada pärast süsteemi taaskäivitamist, kui peaks juhtuma sündmus, mis häirib süsteemi tööaega. See pakub ka tööriistade komplekti, mis võivad meie rakenduse haldamisel abiks olla. Parim osa on asjaolu, et see on sisse ehitatud Ubuntu 16.04 LTS-i, nii et me ei pea installima täiendavat tarkvara.

Looge süsteemne teenus

Kõik, mida vajame rakenduse käivitamiseks, sisaldub failis nimega service. See sisaldab üksikasju meie rakenduse kohta, nagu selle nimi, kataloog, keskkond ja palju muud. Süsteemifaili loomiseks avage tekstiredaktor.

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

Muutke ja salvestage fail nii.

[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

Asenda youruseroma serveri kasutajanimega. Siin on lühike ülevaade olulistest väljadest:

• After - See teavitab süsteemi enne rakenduse käivitamist ootama, kuni võrguliides on valmis.
• Environment- Siin saame oma rakenduse jaoks määrata keskkonnamuutujad. Meie Node.js-port on üks neist.
• Type - See annab süsteemile teada, et meie rakendust saab lihtsalt käivitada, ilma kasutajaõigusi ja muud sellist kasutamata.
• User- See annab süsteemile teada, et soovime rakendust käitada oma kasutajakonto all, mis on soovitatav. Rakenduste käivitamine juurkasutajana võib viia paljude turvaprobleemideni.
• ExecStart - Põhimõtteliselt käsk, mida systemd käivitab meie rakenduse käivitamiseks, sarnaselt sellele, kuidas me seda varem käsitsi käivitasime.
• Restart- Teatab süsteemile, millistel tingimustel meie rakendus taaskäivitada. Sel juhul soovime, et meie veebisait tõrke korral taaskäivitaks.

Käivitage süsteemne teenus

Oleme nüüd valmis oma süsteemset teenust käivitama.

sudo systemctl daemon-reload

See on vajalik iga kord, kui süsteemi teenusefail muutub, et systemd registreeriks kõik uued tehtud muudatused.

Seejärel käivitage rakendus.

sudo systemctl start site

Liikuge oma brauseris uuesti saidile, et kontrollida, kas kõik töötab.

Põhilised süsteemihaldusfunktsioonid

• stop - Peatab rakenduse täielikult.
• restart - Peatab rakenduse ja käivitab selle uuesti uue protsessi käigus.
• enable - käsib süsteemil käivitada rakenduse alati, kui arvuti käivitate.
• status - Näitab teavet praegu töötava rakenduse kohta, nagu tööaeg, rakenduse olek ja palju muud.

Nende funktsioonide kasutamiseks käivitage järgmine.

systemctl <function> site

Järeldus

Oleme edukalt seadistanud rakenduse Koa.js ja õppinud, kuidas seda puhverserverit tagasi pöörata, samuti hallata seda süsteemiga. Nüüd olete valmis oma rakendust laiendama ja sellele näitele tuginema. Kui soovite saada lisateavet Koa.js-i ja muude asjade kohta, mida saate teha, külastage abistava teabe saamiseks nende veebisaiti . Lisaks sellele, kui soovite systemd protsessihalduri kohta rohkem teada saada, lugege selle dokumentatsiooni siit . Lõpuks, kui soovite Apache'i pöördpuhverserveri kohta lisateavet, vaadake neid siin .