Kako postaviti Koa.js Node aplikaciju na Ubuntu 16.04 LTS

U ovom vodiču učit ćemo kako postaviti Koa.js web aplikaciju za proizvodnju, koristeći Node.js. Također ćemo povezati oglednu domenu, s obrnutim proxyjem, koristeći Apache, i naučiti kako upravljati njome s odgovarajućim upraviteljem procesa. Bez daljnjega, krenimo.

Kratki opis Node.js, Koa.js i Apache

Node.js je brzi, višeplatformski JavaScript okvir koji se temelji na Chromeovom V8 motoru. Koristi se u desktop i poslužiteljskim aplikacijama i poznat je po rukovanju petlji s jednim niti. Node.js sadrži registar paketa nazvan Node Package Manager (NPM), koji ugošćuje više od pola milijuna paketa. NPM paketi (ili moduli) osnovna su okosnica Node.js-a, budući da su kod vođen zajednice koji može biti koristan u vašoj Node.js aplikaciji. U našoj aplikaciji Koa.js, Node.js je temeljni dio njezine funkcije.

Koa.js je minimalistički web okvir, izgrađen na platformi Node.js. Napravljen od strane istog tima koji stoji iza popularnog Express.js frameworka, njegov je cilj dodatno minimizirati već minimalistički Express.js okvir isključivanjem međuprograma iz njegove jezgre. Glavna značajka Koa.js-a je činjenica da nema povratnih poziva. Koa.js je izgrađen na ES6 baziranim generatorima i ES6 značajkama, kao što su Promises.

Apache je popularni web poslužitelj otvorenog koda, koji se koristi kao vrlo osnovna polazna točka za web poslužitelje. U ovom vodiču koristit ćemo Apache kao obrnuti proxy, što će nam omogućiti da povežemo našu aplikaciju s uzorkom domene. Ako nemate domenu, ovaj vodič će i dalje raditi za vas, s jedinom razlikom što će web stranica raditi na vašem VPS IP-u, umjesto na domeni.

Postavljanje Node.js

Kao i kod bilo kojeg okvira Node.js, morat ćete instalirati Node.js na svoj VPS. Radi ovog vodiča, pretpostavit ću da već imate instaliran Node.js na vašem sustavu. Ako ne, možete jednostavno slijediti upute ovdje .

Postavljanje našeg imenika aplikacija

Morat ćemo stvoriti mapu koja će sadržavati osnovne datoteke naše aplikacije.

mkdir site

Slobodno zamijenite sitebilo kojim drugim imenom koje želite za imenik. Zatim ćemo morati inicijalizirati našu datoteku paketa Node.js. Prijeđite u direktorij koji ste upravo stvorili, pokrenite npm initi dovršite upite. Na kraju bi to trebalo izgledati otprilike ovako:

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

Instaliranje Koa.js

Sada kada smo postavili naš direktorij, možemo nastaviti s instalacijom Koa.js. U trenutnom radnom direktoriju /site, upišite sljedeće.

npm install koa

Ovo će preuzeti modul Koa.js s NPM-a i instalirati ga u naš projektni direktorij za buduću upotrebu. Zatim ćemo kreirati našu datoteku uzorka aplikacije koja će sadržavati naš kod aplikacije. Da biste to učinili, stvorite index.jsdatoteku.

nano index.js

Kada uđete u datoteku, stvorite primjer aplikacije.

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

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

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

Spremite i zatvorite datoteku. CTRL+ X.

Željet ćemo biti sigurni da naša aplikacija ispravno radi. Da biste ga pokrenuli, pokrenite node index.js, i vidjet ćete Website is livena konzoli.

Instalacija Apachea

Sada kada znamo da je naša web stranica funkcionalna, možemo nastaviti s instaliranjem Apachea i njegovih ovisnosti.

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

Da bismo koristili značajku obrnutog proxyja koja se nalazi u Apacheu, morat ćemo omoguć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

Neki od ovih modula možda su već bili omogućeni, ali ih je uvijek dobro još jednom provjeriti.

Sada moramo urediti zadanu konfiguracijsku datoteku za Apache.

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

Ovdje ćemo morati dodati blok za našu aplikaciju.

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

    ServerName localhost
</VirtualHost>

Spremite datoteku, CTRL+ X.

Možda ćete primijetiti da koristimo port 3000kao port za naš ProxyPassi ProxyPassReverseIP. Budući da je to isti port na kojem pokrećemo našu Koa.js aplikaciju, imperativ je da unesemo ispravan port.

Nakon što promjene budu na mjestu, morat ćemo ponovno pokrenuti Apache i ponovno pokrenuti našu Koa.js aplikaciju.

sudo systemctl restart apache2

To će osigurati da je naša konfiguracijska datoteka aktivna i spremna za rad kada pokrenemo našu Koa.js aplikaciju. Nakon što se Apache ponovno pokrene, vratite se na direktorij svoje stranice i pokrenite aplikaciju Koa.js kao što smo to učinili prije. U svom web pregledniku idite na http://yourdomain, ili http://yourip:i vidjet ćete "Hello World".

Upravljanje našom aplikacijom pomoću systemd-a

Sada kada smo pokrili osnove izrade primjera Koa.js aplikacije, shvaćamo da je u proizvodnom okruženju pokretanje aplikacije kao što smo sada nepraktično. Voditelj procesa je svakako uvjet. Tu na scenu stupa systemd. Jednostavnim riječima, systemd se sastoji od softvera koji pruža građevne blokove za Linux sustav. Slično kao "init", pruža sustav za upravljanje korisničkim procesima nakon pokretanja sustava. U slučaju naše aplikacije, systemd nam omogućuje da automatski pokrenemo našu web stranicu nakon ponovnog pokretanja sustava, u slučaju da dođe do događaja koji poremeti rad sustava. Također nudi skup alata koji mogu biti korisni pri upravljanju našom aplikacijom. Najbolji dio je činjenica da je ugrađen u Ubuntu 16.04 LTS, tako da ne trebamo instalirati nikakav dodatni softver.

Napravite systemd uslugu

Sve što nam je potrebno za pokretanje naše aplikacije bit će sadržano u datoteci pod nazivom service. Sadrži pojedinosti o našoj aplikaciji, kao što su njezin naziv, imenik, okruženje i još mnogo toga. Da biste stvorili našu sistemsku datoteku, otvorite uređivač teksta.

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

Uredite i spremite datoteku ovako.

[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

Zamijenite youruserkorisničkim imenom vašeg poslužitelja. Evo kratkog pregleda važnih polja:

• After - Ovo informira systemd da pričeka dok mrežno sučelje ne bude spremno prije pokretanja naše aplikacije.
• Environment- Ovdje možemo odrediti varijable okruženja za našu aplikaciju. Naš Node.js port je jedan od njih.
• Type - Ovo informira systemd da se naša aplikacija može samo pokrenuti, bez razdvajanja korisničkih privilegija i slično.
• User- Ovo govori systemd-u da želimo pokrenuti aplikaciju pod našim korisničkim računom, što se preporučuje. Pokretanje aplikacija kao root korisnik može dovesti do mnogih sigurnosnih kompromisa.
• ExecStart - U suštini naredba koju će systemd pokrenuti za pokretanje naše aplikacije, slično kao što smo je ranije pokrenuli ručno.
• Restart- Govori systemd-u pod kojim uvjetima treba ponovno pokrenuti našu aplikaciju. U tom slučaju želimo ponovno pokrenuti našu web stranicu u slučaju pogreške.

Pokrenite uslugu systemd

Sada smo spremni pokrenuti našu systemd uslugu.

sudo systemctl daemon-reload

To je potrebno kad god se sistemska servisna datoteka promijeni kako bi systemd registrirao sve nove promjene.

Zatim pokrenite svoju aplikaciju.

sudo systemctl start site

Idite do web-mjesta u svom pregledniku još jednom da biste provjerili radi li sve.

Ključne funkcije upravljanja sustavom

• stop - Potpuno zaustavlja aplikaciju.
• restart - Zaustavlja aplikaciju i ponovno je pokreće pod novim procesom.
• enable - Govori systemd-u da pokrene aplikaciju svaki put kad pokrenete svoje računalo.
• status - Prikazuje informacije o trenutno pokrenutoj aplikaciji, kao što su vrijeme rada, stanje aplikacije i još mnogo toga.

Da biste koristili bilo koju od ovih funkcija, pokrenite sljedeće.

systemctl <function> site

Zaključak

Uspješno smo postavili Koa.js aplikaciju i naučili kako je obrnuti proxy, kao i upravljati njome pomoću systemd-a. Sada ste spremni proširiti svoju aplikaciju i graditi na ovom primjeru. Ako želite saznati više o Koa.js-u i više stvari s kojima možete učiniti, posjetite njihovu web stranicu za više korisnih informacija. Osim toga, ako želite saznati više o systemd-ovom upravitelju procesa, pročitajte dokumentaciju za njega ovdje . Konačno, ako želite saznati više o Apacheovom obrnutom proxyju, slobodno ih pogledajte ovdje .