Cum să configurați o aplicație de nod Koa.js pe Ubuntu 16.04 LTS

• Scurtă descriere a Node.js, Koa.js și Apache
• Configurarea Node.js
• Configurarea directorului aplicațiilor noastre
• Instalarea Koa.js
• Instalarea Apache
• Gestionarea aplicației noastre cu systemd
• Concluzie

În acest tutorial, vom învăța cum să configurați o aplicație web Koa.js pentru producție, folosind Node.js. De asemenea, vom face legătura dintre un domeniu de probă, cu un proxy invers, folosind Apache și vom învăța cum să îl gestionăm cu un manager de proces adecvat. Fără alte detalii, să începem.

Scurtă descriere a Node.js, Koa.js și Apache

Node.js este un cadru JavaScript rapid și multiplă platforme bazat pe motorul V8 Chrome. Este utilizat atât pentru aplicații desktop cât și pentru server și este renumit pentru tratarea buclelor de evenimente cu un singur fir. Node.js prezintă un registru de pachete numit Node Package Manager (NPM), care găzduiește peste jumătate de milion de pachete. Pachetele (sau modulele) NPM sunt coloana vertebrală principală a Node.js, deoarece sunt coduri bazate pe comunitate care pot fi utile în aplicația dvs. Node.js. În aplicația noastră Koa.js, Node.js este partea principală a funcției sale.

Koa.js este un cadru web minimalist, construit pe platforma Node.js. Realizat de aceeași echipă din spatele cadrului popular Express.js, obiectivul său este de a minimaliza în continuare cadrul Express.js deja minimalist, prin excluderea middleware-ului din nucleul său. O caracteristică majoră a Koa.js este faptul că nu există apeluri de apel. Koa.js este construit pe generatoare bazate pe ES6 și funcții ES6, precum Promise.

Apache este un popular server web open-source, folosit ca punct de plecare de bază pentru serverele web. În acest tutorial, vom folosi Apache ca proxy invers, ceea ce ne va permite să conectăm aplicația noastră la un domeniu de probă. Dacă nu aveți un domeniu, acest tutorial va funcționa în continuare pentru dvs., singura diferență fiind că site-ul va rula pe IP-ul dvs. VPS, în loc de un domeniu.

Configurarea Node.js

Ca în orice cadru Node.js, va trebui să instalați Node.js pe VPS. De dragul acestui tutorial, voi presupune că aveți deja Node.js instalat în sistemul dvs. Dacă nu, puteți urma pur și simplu instrucțiunile de aici .

Configurarea directorului aplicațiilor noastre

Va trebui să creăm un folder, care să conțină fișierele principale ale aplicației noastre.

mkdir site

Simțiți-vă liber să înlocuiți sitecu orice alt nume pe care doriți să îl faceți pentru director. În continuare, va trebui să inițializăm fișierul pachetului Node.js. Modificați directorul pe care tocmai l-ați creat și rulați npm initși completați solicitarile. În final, ar trebui să arate așa:

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

Instalarea Koa.js

Acum că avem directorul nostru configurat, putem proceda la instalarea Koa.js. În directorul de lucru curent /site, tastați următoarele.

npm install koa

Acest lucru va descărca modulul Koa.js de la NPM și îl va instala în directorul nostru de proiecte pentru o utilizare viitoare. În continuare, vom crea fișierul nostru de aplicație exemplar care va conține codul aplicației noastre. Pentru aceasta, creați un index.jsfișier.

nano index.js

Odată ajuns în fișier, creați o aplicație de probă.

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

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

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

Salvați și închideți fișierul. CTRL+ X.

Vom dori să ne asigurăm că aplicația noastră rulează corect. Pentru a începe, rulați node index.jsși veți vedea Website is liveîn consolă.

Instalarea Apache

Acum că știm că site-ul nostru web este funcțional, putem proceda la instalarea Apache și a dependențelor sale.

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

Pentru a utiliza funcția de proxy inversă găsită în Apache, va trebui să activăm modulele necesare.

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

Este posibil ca unele dintre aceste module să fi fost deja activate, dar este întotdeauna bine să le verifici dublu.

Acum trebuie să edităm fișierul de configurare implicit pentru Apache.

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

Aici, va trebui să adăugăm un bloc pentru aplicația noastră.

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

    ServerName localhost
</VirtualHost>

Salvați fișierul, CTRL+ X.

Este posibil să observați că folosim portul 3000ca port pentru IP ProxyPassși ProxyPassReverseIP. Deoarece este același port pe care rulăm aplicația noastră Koa.js, este imperativ să introducem portul corect.

După ce modificările vor fi instalate, va trebui să repornim Apache și să relansăm aplicația Koa.js.

sudo systemctl restart apache2

Acest lucru vă va asigura că fișierul nostru de configurare este activ și gata să funcționeze atunci când pornim aplicația Koa.js. După ce Apache este repornit, navigați înapoi în directorul site-ului dvs. și porniți aplicația Koa.js așa cum am făcut anterior. Din browserul dvs. web, navigați la http://yourdomainsau http://yourip:, și veți vedea „Hello World”.

Gestionarea aplicației noastre cu systemd

Acum că am abordat elementele de bază ale creării unui eșantion de aplicație Koa.js, ne dăm seama că într-un mediu de producție, pornirea aplicației așa cum suntem acum este practic. Un manager de proces este cu siguranță o cerință. Acolo intră în joc sistemd. În termeni simpli, systemd constă dintr-un software care oferă blocuri de construcții pentru un sistem Linux. Similar cu „init”, oferă un sistem pentru a gestiona procesele utilizatorului după pornirea sistemului. În cazul aplicației noastre, systemd ne permite să pornim automat site-ul nostru web după ce sistemul a fost repornit, în cazul în care există un eveniment care perturbe timpul de funcționare al sistemului. De asemenea, oferă un set de instrumente care pot veni la îndemână la gestionarea aplicației noastre. Cea mai bună parte este faptul că este încorporat în Ubuntu 16.04 LTS, deci nu este necesar să instalăm niciun software suplimentar.

Creați un serviciu systemd

Tot ce avem nevoie pentru a începe aplicația noastră va fi conținut într-un fișier numit service. Acesta conține detalii despre aplicația noastră, cum ar fi numele, directorul, mediul și multe altele. Pentru a crea fișierul nostru de sistem, deschideți un editor de text.

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

Editați și salvați fișierul astfel.

[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

Înlocuiți yourusercu numele de utilizator al serverului dvs. Iată o scurtă expunere a câmpurilor importante:

• After - Aceasta informează sistemd să aștepte până când interfața de rețea este gata înainte de a începe aplicația noastră.
• Environment- Aici putem specifica variabile de mediu pentru aplicația noastră. Portul Node.js este unul dintre ele.
• Type - Aceasta informează sistemd că aplicația noastră poate fi pornită, fără a renunța la privilegiile utilizatorului și altele.
• User- Acest lucru spune sistemd că vrem să rulăm aplicația sub contul nostru de utilizator, ceea ce este recomandat. Rularea aplicațiilor ca utilizator root poate duce la multe compromisuri de securitate.
• ExecStart - În esență, comanda care va fi executată de systemd pentru a porni aplicația noastră, similar cu modul în care am început-o manual înainte.
• Restart- Spune sistemd în ce condiții pentru a reporni aplicația noastră. În acest caz, dorim să repornim site-ul nostru web în cazul unei erori.

Porniți serviciul systemd

Acum suntem pregătiți să începem serviciul nostru de sistem.

sudo systemctl daemon-reload

Acest lucru este necesar de fiecare dată când se modifică un fișier service systemd pentru ca systemd să înregistreze orice modificări noi.

Apoi, începeți aplicația.

sudo systemctl start site

Navigați încă o dată pe site-ul browserului dvs. pentru a verifica dacă totul funcționează.

Funcții de gestionare a sistemului cheie

• stop - Oprește complet aplicația.
• restart - Oprește aplicația și o pornește din nou în cadrul unui nou proces.
• enable - Spune sistemd să pornească aplicația ori de câte ori porniți computerul.
• status - Afișează informații despre aplicația în curs de desfășurare, cum ar fi uptime, starea aplicației și multe altele.

Pentru a utiliza oricare dintre aceste funcții, executați următoarele.

systemctl <function> site

Concluzie

Am creat cu succes o aplicație Koa.js și am învățat cum să o inversăm proxy, precum și cum să o gestionăm cu systemd. Acum sunteți gata să vă extindeți aplicația și să vă bazați pe acest exemplu. Dacă doriți să aflați mai multe despre Koa.js și mai multe lucruri cu care puteți face, vizitați site - ul lor web , pentru informații mai utile. În plus, dacă doriți să aflați mai multe despre managerul de proces al sistemului, citiți documentația pentru acesta aici . În cele din urmă, dacă doriți să aflați mai multe despre proxy-ul invers al lui Apache, nu ezitați să le consultați aici .