Come installare unapplicazione del nodo Koa.js su Ubuntu 16.04 LTS

• Breve descrizione di Node.js, Koa.js e Apache
• Impostazione di Node.js
• Impostazione della nostra directory dell'applicazione
• Installazione di Koa.js
• Installazione di Apache
• Gestire la nostra applicazione con systemd
• Conclusione

In questo tutorial impareremo come impostare un'applicazione web Koa.js per la produzione, utilizzando Node.js. Collegheremo anche un dominio di esempio, con un proxy inverso, usando Apache, e impareremo come gestirlo con un adeguato gestore dei processi. Senza ulteriori indugi, iniziamo.

Breve descrizione di Node.js, Koa.js e Apache

Node.js è un framework JavaScript multipiattaforma veloce basato sul motore V8 di Chrome. È utilizzato in entrambe le applicazioni desktop e server ed è famoso per la gestione di loop di eventi a thread singolo. Node.js presenta un registro dei pacchetti chiamato Node Package Manager (NPM), che ospita oltre mezzo milione di pacchetti. I pacchetti (o moduli) NPM sono la spina dorsale principale di Node.js, in quanto sono codici guidati dalla comunità che possono essere utili nell'applicazione Node.js. Nella nostra app Koa.js, Node.js è la parte principale della sua funzione.

Koa.js è un framework web minimalista, costruito sulla piattaforma Node.js. Creato dallo stesso team dietro il famoso framework Express.js, il suo obiettivo è ridurre ulteriormente il già minimalista framework Express.js escludendo il middleware dal suo core. Una caratteristica importante di Koa.js è il fatto che non ci sono callback. Koa.js è basato su generatori basati su ES6 e funzionalità ES6, come Promises.

Apache è un popolare server Web open source, utilizzato come punto di partenza molto semplice per i server Web. In questo tutorial, useremo Apache come proxy inverso, che ci consentirà di collegare la nostra applicazione a un dominio di esempio. Se non disponi di un dominio, questo tutorial funzionerà comunque per te, con l'unica differenza che il sito Web verrà eseguito sul tuo IP VPS, anziché su un dominio.

Impostazione di Node.js

Come con qualsiasi framework Node.js, dovrai installare Node.js sul tuo VPS. Per il bene di questo tutorial, suppongo che tu abbia già installato Node.js sul tuo sistema. In caso contrario, puoi semplicemente seguire le istruzioni qui .

Impostazione della nostra directory dell'applicazione

Dovremo creare una cartella che conterrà i file core della nostra applicazione.

mkdir site

Sentiti libero di sostituire sitecon qualsiasi altro nome che desideri per la directory. Successivamente, dovremo inizializzare il nostro file del pacchetto Node.js. Passa alla directory che hai appena creato, esegui npm inite completa le istruzioni. Alla fine, dovrebbe assomigliare a questo:

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

Installazione di Koa.js

Ora che abbiamo impostato la nostra directory, possiamo procedere con l'installazione di Koa.js. Nella directory di lavoro corrente /site, digitare quanto segue.

npm install koa

Questo scaricherà il modulo Koa.js da NPM e lo installerà nella nostra directory di progetto per un uso futuro. Successivamente, creeremo il nostro file di applicazione di esempio che conterrà il nostro codice dell'app. Per fare ciò, crea un index.jsfile.

nano index.js

Una volta all'interno del file, creare un'applicazione di esempio.

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 e chiudi il file. CTRL+ X.

Vogliamo assicurarci che la nostra applicazione funzioni correttamente. Per avviarlo, esegui node index.jse vedrai Website is livenella console.

Installazione di Apache

Ora che sappiamo che il nostro sito Web è funzionale, possiamo procedere all'installazione di Apache e delle sue dipendenze.

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

Per utilizzare la funzione di proxy inverso che si trova in Apache, dovremo abilitare i moduli necessari.

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

Alcuni di questi moduli potrebbero essere già stati abilitati, ma è sempre bene ricontrollarli.

Ora dobbiamo modificare il file di configurazione predefinito per Apache.

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

Qui, dovremo aggiungere un blocco per la nostra applicazione.

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

    ServerName localhost
</VirtualHost>

Salva il file, CTRL+ X.

Potresti notare che stiamo usando la porta 3000come porta per il nostro ProxyPasse ProxyPassReverseIP. Poiché è la stessa porta su cui stiamo eseguendo la nostra applicazione Koa.js, è indispensabile inserire la porta corretta.

Una volta apportate le modifiche, dovremo riavviare Apache e riavviare la nostra applicazione Koa.js.

sudo systemctl restart apache2

Questo assicurerà che il nostro file di configurazione sia attivo e pronto per funzionare quando avvieremo la nostra applicazione Koa.js. Una volta riavviato Apache, torna alla directory del tuo sito e avvia l'applicazione Koa.js come abbiamo fatto in precedenza. Dal tuo browser web, vai a http://yourdomaino http://yourip:, e vedrai "Hello World".

Gestire la nostra applicazione con systemd

Ora che abbiamo trattato le basi della creazione di un'applicazione Koa.js di esempio, ci rendiamo conto che in un ambiente di produzione, avviare l'applicazione così come siamo ora non è pratico. Un gestore di processo è sicuramente un requisito. È qui che entra in gioco systemd. In termini semplici, systemd è costituito da un software che fornisce elementi costitutivi per un sistema Linux. Simile a "init", fornisce un sistema per gestire i processi utente dopo l'avvio del sistema. Nel caso della nostra applicazione, systemd ci consente di avviare automaticamente il nostro sito Web dopo il riavvio del sistema, nel caso in cui si verifichi un evento che interrompe il tempo di attività del sistema. Fornisce inoltre una serie di strumenti che possono tornare utili durante la gestione della nostra applicazione. La parte migliore è il fatto che è integrato in Ubuntu 16.04 LTS, quindi non è necessario installare alcun software aggiuntivo.

Crea un servizio di systemd

Tutto ciò di cui abbiamo bisogno per avviare la nostra applicazione sarà contenuto in un file chiamato service. Contiene dettagli sulla nostra app, come il nome, la directory, l'ambiente e altro. Per creare il nostro file di sistema, apri un editor di testo.

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

Modifica e salva il file in questo modo.

[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

Sostituisci yourusercon il nome utente del tuo server. Ecco una rapida carrellata dei campi importanti:

• After - Questo informa systemd di attendere che l'interfaccia di rete sia pronta prima di avviare la nostra applicazione.
• Environment- Qui possiamo specificare le variabili di ambiente per la nostra applicazione. La nostra porta Node.js è una di queste.
• Type - Questo informa systemd che la nostra app può essere appena avviata, senza biforcare i privilegi dell'utente e simili.
• User- Questo dice a systemd che vogliamo eseguire l'applicazione con il nostro account utente, che è raccomandato. L'esecuzione di applicazioni come utente root può comportare numerosi compromessi di sicurezza.
• ExecStart - Essenzialmente il comando che systemd eseguirà per avviare la nostra applicazione, in modo simile a come l'abbiamo avviata manualmente prima.
• Restart- Indica a systemd a quali condizioni riavviare la nostra applicazione. In questo caso, vogliamo che il nostro sito Web venga riavviato in caso di errore.

Avviare il servizio systemd

Ora siamo pronti per iniziare il nostro servizio systemd.

sudo systemctl daemon-reload

Ciò è necessario ogni volta che un file di servizio di systemd cambia per consentire a systemd di registrare tutte le nuove modifiche apportate.

Quindi, avvia l'applicazione.

sudo systemctl start site

Passare nuovamente al sito nel browser per verificare che tutto funzioni.

Principali funzioni di gestione del sistema

• stop - Interrompe completamente l'applicazione.
• restart - Arresta l'applicazione e la riavvia con un nuovo processo.
• enable - Indica a systemd di avviare l'applicazione ogni volta che si avvia il computer.
• status - Mostra informazioni sull'applicazione attualmente in esecuzione, come uptime, stato dell'applicazione e altro.

Per utilizzare una di queste funzioni, eseguire quanto segue.

systemctl <function> site

Conclusione

Abbiamo configurato correttamente un'applicazione Koa.js e abbiamo imparato come invertire il proxy, nonché gestirlo con systemd. Ora sei pronto per espandere la tua applicazione e basarti su questo esempio. Se desideri saperne di più su Koa.js e altre cose che puoi fare, visita il loro sito Web per ulteriori informazioni utili. Inoltre, se desideri saperne di più sul gestore dei processi di systemd, leggi la documentazione qui . Infine, se vuoi saperne di più sul proxy inverso di Apache, sentiti libero di dare un'occhiata qui .