Com configurar una aplicació de node Koa.js a Ubuntu 16.04 LTS

En aquest tutorial, aprendrem a configurar una aplicació web Koa.js per a la producció, utilitzant Node.js. També enllaçarem un domini de mostra, amb un servidor intermediari invers, utilitzant Apache i aprendrem a gestionar-lo amb un gestor de processos adequat. Sense més preàmbuls, comencem.

Breu descripció de Node.js, Koa.js i Apache

Node.js és un marc de JavaScript ràpid i multiplataforma basat en el motor V8 de Chrome. S'utilitza tant en aplicacions d'escriptori com de servidor i és famós pel seu maneig de bucles d'esdeveniments d'un sol fil. Node.js inclou un registre de paquets anomenat Node Package Manager (NPM), que allotja més de mig milió de paquets. Els paquets (o mòduls) NPM són la columna vertebral principal de Node.js, ja que són codi impulsat per la comunitat que poden ser útils a la vostra aplicació Node.js. A la nostra aplicació Koa.js, Node.js és la part bàsica de la seva funció.

Koa.js és un marc web minimalista, construït a la plataforma Node.js. Fet pel mateix equip que hi ha darrere del popular marc Express.js, el seu objectiu és minimitzar encara més el ja minimalista marc Express.js excloent el middleware del seu nucli. Una característica important de Koa.js és el fet que no hi ha devolucions de trucada. Koa.js es basa en generadors basats en ES6 i funcions ES6, com ara Promises.

Apache és un popular servidor web de codi obert, utilitzat com a punt de partida molt bàsic per als servidors web. En aquest tutorial, utilitzarem Apache com a servidor intermediari invers, que ens permetrà enllaçar la nostra aplicació a un domini de mostra. Si no teniu un domini, aquest tutorial continuarà funcionant per a vosaltres, amb l'única diferència que el lloc web s'executarà a la vostra IP VPS, en lloc d'un domini.

Configuració de Node.js

Com amb qualsevol marc de Node.js, haureu d'instal·lar Node.js al vostre VPS. Pel bé d'aquest tutorial, suposaré que ja teniu Node.js instal·lat al vostre sistema. Si no, només podeu seguir les instruccions aquí .

Configurant el nostre directori d'aplicacions

Haurem de crear una carpeta, que contindrà els fitxers bàsics de la nostra aplicació.

mkdir site

No dubteu a substituir-lo siteper qualsevol altre nom que vulgueu per al directori. A continuació, haurem d'inicialitzar el nostre fitxer de paquet Node.js. Canvieu al directori que acabeu de crear, executeu npm initi completeu les indicacions. Al final, hauria de semblar a això:

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

Instal·lant Koa.js

Ara que tenim el nostre directori configurat, podem procedir a instal·lar Koa.js. Al directori de treball actual, /site, escriviu el següent.

npm install koa

Això baixarà el mòdul Koa.js de NPM i l'instal·larà al directori del nostre projecte per a un ús futur. A continuació, crearem el nostre fitxer d'aplicació de mostra que conté el nostre codi d'aplicació. Per fer-ho, creeu un index.jsfitxer.

nano index.js

Un cop dins del fitxer, creeu una aplicació de mostra.

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

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

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

Desa i tanca el fitxer. CTRL+ X.

Voldrem assegurar-nos que la nostra aplicació funciona correctament. Per iniciar-lo, executeu node index.js, i ho veureu Website is livea la consola.

Instal·lant Apache

Ara que sabem que el nostre lloc web és funcional, podem procedir a instal·lar Apache i les seves dependències.

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

Per utilitzar la funció de proxy invers que es troba a Apache, haurem d'habilitar els mòduls necessaris.

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

És possible que alguns d'aquests mòduls ja estiguin habilitats, però sempre és bo revisar-los.

Ara hem d'editar el fitxer de configuració predeterminat per a Apache.

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

Aquí, haurem d'afegir un bloc per a la nostra aplicació.

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

    ServerName localhost
</VirtualHost>

Desa el fitxer, CTRL+ X.

És possible que noteu que estem utilitzant port 3000com a port per a la nostra ProxyPassi ProxyPassReverseIP. Com que és el mateix port on estem executant la nostra aplicació Koa.js, és imprescindible que introduïm el port correcte.

Un cop fets els canvis, haurem de reiniciar Apache i rellançar la nostra aplicació Koa.js.

sudo systemctl restart apache2

Això garantirà que el nostre fitxer de configuració estigui actiu i llest per funcionar quan iniciem la nostra aplicació Koa.js. Un cop reiniciat Apache, torneu al directori del vostre lloc i inicieu l'aplicació Koa.js com vam fer anteriorment. Des del navegador web, navegueu a http://yourdomain, o http://yourip:, i veureu "Hola món".

Gestionant la nostra aplicació amb systemd

Ara que hem tractat els conceptes bàsics per crear una aplicació Koa.js de mostra, ens adonem que en un entorn de producció, iniciar l'aplicació tal com som ara és poc pràctic. Un gestor de processos és definitivament un requisit. Aquí és on entra en joc systemd. En termes simples, systemd consisteix en programari que proporciona blocs de construcció per a un sistema Linux. Similar a "init", proporciona un sistema per gestionar els processos dels usuaris després de l'inici del sistema. En el cas de la nostra aplicació, systemd ens permet iniciar automàticament el nostre lloc web després de reiniciar el sistema, en cas que hi hagi un esdeveniment que interrompi el temps d'activitat del sistema. També ofereix un conjunt d'eines que poden ser útils a l'hora de gestionar la nostra aplicació. La millor part és el fet que està integrat a Ubuntu 16.04 LTS, de manera que no necessitem instal·lar cap programari addicional.

Crea un servei de sistema

Tot el que necessitem per iniciar la nostra aplicació estarà contingut en un fitxer anomenat service. Conté detalls sobre la nostra aplicació, com ara el seu nom, directori, entorn i molt més. Per crear el nostre fitxer de sistema, obriu un editor de text.

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

Editeu i deseu el fitxer així.

[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

Substituïu youruser-lo pel nom d'usuari del vostre servidor. Aquí teniu un resum ràpid dels camps importants:

• After - Això informa a systemd d'esperar fins que la interfície de xarxa estigui preparada abans d'iniciar la nostra aplicació.
• Environment- Aquí podem especificar variables d'entorn per a la nostra aplicació. El nostre port Node.js és un d'ells.
• Type - Això informa a systemd que la nostra aplicació només es pot iniciar, sense oblidar els privilegis d'usuari i tal.
• User- Això indica a systemd que volem executar l'aplicació amb el nostre compte d'usuari, cosa que es recomana. L'execució d'aplicacions com a usuari root pot comportar molts compromisos de seguretat.
• ExecStart - Bàsicament, l'ordre que s'executarà systemd per iniciar la nostra aplicació, de manera similar a com la vam iniciar manualment abans.
• Restart- Indica a systemd en quines condicions ha de reiniciar la nostra aplicació. En aquest cas, volem que el nostre lloc web es reiniciï en cas d'error.

Inicieu el servei systemd

Ara estem preparats per iniciar el nostre servei de sistema.

sudo systemctl daemon-reload

Això és necessari cada vegada que canvia un fitxer de servei de systemd per tal que systemd registri els nous canvis fets.

A continuació, inicieu la vostra aplicació.

sudo systemctl start site

Navegueu al lloc al vostre navegador una vegada més per comprovar que tot funciona.

Funcions clau de gestió del sistema

• stop - Atura l'aplicació completament.
• restart - Atura l'aplicació i la torna a iniciar amb un procés nou.
• enable - Indica a systemd que iniciï l'aplicació sempre que engegueu l'ordinador.
• status - Mostra informació sobre l'aplicació en funcionament, com ara el temps d'activitat, l'estat de l'aplicació i molt més.

Per utilitzar qualsevol d'aquestes funcions, executeu el següent.

systemctl <function> site

Conclusió

Hem configurat amb èxit una aplicació Koa.js i hem après a invertir el proxy, així com a gestionar-la amb systemd. Ara esteu preparat per ampliar la vostra aplicació i basar-vos en aquest exemple. Si voleu obtenir més informació sobre Koa.js i més coses amb les quals podeu fer, visiteu el seu lloc web , per obtenir més informació útil. A més d'això, si voleu obtenir més informació sobre el gestor de processos de systemd, llegiu la documentació aquí . Finalment, si voleu obtenir més informació sobre el proxy invers d'Apache, no dubteu a consultar-los aquí .