Jak nastavit aplikaci uzlu Koa.js na Ubuntu 16.04 LTS

V tomto tutoriálu se naučíme, jak nastavit webovou aplikaci Koa.js pro produkci s využitím Node.js. Propojíme také ukázkovou doménu s reverzním proxy pomocí Apache a naučíme se, jak ji spravovat pomocí správného správce procesů. Bez dalších řečí můžeme začít.

Stručný popis Node.js, Koa.js a Apache

Node.js je rychlý JavaScriptový framework pro více platforem založený na enginu Chrome V8. Používá se v desktopových i serverových aplikacích a je známý svým zpracováním jednovláknové smyčky událostí. Node.js obsahuje registr balíčků s názvem Node Package Manager (NPM), který hostí více než půl milionu balíčků. Balíčky (nebo moduly) NPM jsou hlavní páteří Node.js, protože jde o kód řízený komunitou, který může být užitečný ve vaší aplikaci Node.js. V naší aplikaci Koa.js je Node.js hlavní součástí její funkce.

Koa.js je minimalistický webový framework, postavený na platformě Node.js. Vytvořeno stejným týmem za populárním frameworkem Express.js a jeho cílem je dále minimalizovat již tak minimalistický rámec Express.js vyloučením middlewaru z jeho jádra. Hlavním rysem Koa.js je skutečnost, že neexistují žádná zpětná volání. Koa.js je postaven na generátorech založených na ES6 a funkcích ES6, jako jsou Promises.

Apache je populární webový server s otevřeným zdrojovým kódem, který se používá jako velmi základní výchozí bod pro webové servery. V tomto tutoriálu budeme používat Apache jako reverzní proxy, což nám umožní propojit naši aplikaci s ukázkovou doménou. Pokud nemáte doménu, tento návod vám bude stále fungovat, jen s tím rozdílem, že web poběží na vaší VPS IP, místo na doméně.

Nastavení Node.js

Stejně jako u jakéhokoli rámce Node.js budete muset do svého VPS nainstalovat Node.js. Pro účely tohoto tutoriálu budu předpokládat, že již máte v systému nainstalovaný Node.js. Pokud ne, můžete jednoduše postupovat podle pokynů zde .

Nastavení našeho adresáře aplikací

Budeme muset vytvořit složku, která bude obsahovat základní soubory naší aplikace.

mkdir site

Neváhejte jej nahradit sitejakýmkoli jiným názvem, který chcete pro adresář. Dále budeme muset inicializovat náš soubor balíčku Node.js. Přejděte do adresáře, který jste právě vytvořili, spusťte npm inita dokončete výzvy. Nakonec by to mělo vypadat nějak takto:

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

Instalace koa.js

Nyní, když máme nastavený adresář, můžeme přistoupit k instalaci Koa.js. V aktuálním pracovním adresáři /sitezadejte následující.

npm install koa

Tím se stáhne modul Koa.js z NPM a nainstaluje se do našeho adresáře projektu pro budoucí použití. Dále vytvoříme soubor ukázkové aplikace, který bude obsahovat náš kód aplikace. Chcete-li tak učinit, vytvořte index.jssoubor.

nano index.js

Jakmile jste uvnitř souboru, vytvořte ukázkovou aplikaci.

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

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

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

Uložte a zavřete soubor. CTRL+ X.

Budeme se chtít ujistit, že naše aplikace běží správně. Chcete-li jej spustit, spusťte node index.jsa Website is livev konzole uvidíte .

Instalace Apache

Nyní, když víme, že je náš web funkční, můžeme přistoupit k instalaci Apache a jeho závislostí.

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

Aby bylo možné použít funkci reverzního proxy, kterou najdete v Apache, budeme muset povolit potřebné moduly.

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

Některé z těchto modulů již mohou být povoleny, ale vždy je dobré je znovu zkontrolovat.

Nyní musíme upravit výchozí konfigurační soubor pro Apache.

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

Zde budeme muset přidat blok pro naši aplikaci.

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

    ServerName localhost
</VirtualHost>

Uložte soubor, CTRL+ X.

Můžete si všimnout, že 3000jako port pro naše ProxyPassa ProxyPassReverseIP používáme port . Protože se jedná o stejný port, na kterém spouštíme naši aplikaci Koa.js, je nutné zadat správný port.

Jakmile budou změny na místě, budeme muset restartovat Apache a znovu spustit naši aplikaci Koa.js.

sudo systemctl restart apache2

To zajistí, že náš konfigurační soubor bude aktivní a připravený k práci, když spustíme naši aplikaci Koa.js. Po restartování Apache přejděte zpět do adresáře webu a spusťte aplikaci Koa.js jako dříve. Ve webovém prohlížeči přejděte na http://yourdomain, nebo http://yourip:a uvidíte „Hello World“.

Správa naší aplikace pomocí systemd

Nyní, když jsme probrali základy vytváření ukázkové aplikace Koa.js, uvědomujeme si, že v produkčním prostředí je spouštění aplikace tak, jak jsme nyní, nepraktické. Procesní manažer je rozhodně podmínkou. Zde vstupuje do hry systemd. Jednoduše řečeno, systemd se skládá ze softwaru, který poskytuje stavební bloky pro systém Linux. Podobně jako „init“ poskytuje systém pro správu uživatelských procesů po spuštění systému. V případě naší aplikace nám systemd umožňuje automaticky spustit naše webové stránky po restartu systému v případě, že dojde k události, která naruší dobu provozu systému. Poskytuje také sadu nástrojů, které se mohou hodit při správě naší aplikace. Nejlepší na tom je fakt, že je zabudován do Ubuntu 16.04 LTS, takže nepotřebujeme instalovat žádný další software.

Vytvořte systemd službu

Vše, co potřebujeme ke spuštění naší aplikace, bude obsaženo v souboru s názvem service. Obsahuje podrobnosti o naší aplikaci, jako je její název, adresář, prostředí a další. Chcete-li vytvořit náš systémový soubor, otevřete textový editor.

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

Upravte a uložte soubor takto.

[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

Nahraďte youruseruživatelským jménem vašeho serveru. Zde je rychlý přehled důležitých polí:

• After - To informuje systemd, aby před spuštěním naší aplikace počkal, dokud nebude síťové rozhraní připraveno.
• Environment- Zde můžeme specifikovat proměnné prostředí pro naši aplikaci. Náš port Node.js je jedním z nich.
• Type - To informuje systemd, že naši aplikaci lze pouze spustit, bez rozvětvení uživatelských oprávnění a podobně.
• User- To říká systemd, že chceme aplikaci spouštět pod svým uživatelským účtem, což je doporučeno. Spouštění aplikací jako uživatel root může vést k mnoha bezpečnostním kompromisům.
• ExecStart - V podstatě příkaz, který systemd bude spuštěn ke spuštění naší aplikace, podobně jako jsme ji dříve spouštěli ručně.
• Restart- Říká systemd, za jakých podmínek restartovat naši aplikaci. V tomto případě chceme naše webové stránky v případě chyby restartovat.

Spusťte službu systemd

Nyní jsme připraveni spustit naši službu systemd.

sudo systemctl daemon-reload

To je nutné vždy, když se změní soubor služby systemd, aby systemd zaregistroval jakékoli nové provedené změny.

Poté spusťte aplikaci.

sudo systemctl start site

Přejděte na web v prohlížeči znovu a ověřte, že vše funguje.

Klíčové systémové řídící funkce

• stop - Úplně zastaví aplikaci.
• restart - Zastaví aplikaci a znovu ji spustí v rámci nového procesu.
• enable - Řekne systemd, aby spustil aplikaci, kdykoli spustíte počítač.
• status - Zobrazuje informace o aktuáln�� spuštěné aplikaci, jako je doba provozu, stav aplikace a další.

Chcete-li použít kteroukoli z těchto funkcí, spusťte následující.

systemctl <function> site

Závěr

Úspěšně jsme nastavili aplikaci Koa.js a naučili jsme se, jak ji zvrátit proxy, a také ji spravovat pomocí systemd. Nyní jste připraveni rozšířit svou aplikaci a stavět na tomto příkladu. Pokud se chcete dozvědět více o Koa.js a dalších věcech, se kterými můžete dělat, navštivte jejich web , kde najdete další užitečné informace. Kromě toho, pokud se chcete dozvědět více o správci procesů systemd, přečtěte si jeho dokumentaci zde . A konečně, pokud se chcete dozvědět více o reverzním proxy serveru Apache, můžete si je prohlédnout zde .