Jak skonfigurować aplikację węzła Koa.js na Ubuntu 16.04 LTS

• Krótki opis Node.js, Koa.js i Apache
• Konfigurowanie Node.js
• Konfigurowanie naszego katalogu aplikacji
• Instalowanie Koa.js
• Instalowanie Apache
• Zarządzanie naszą aplikacją za pomocą systemd
• Wniosek

W tym samouczku nauczymy się konfigurować aplikację internetową Koa.js do produkcji przy użyciu Node.js. Będziemy również łączyć przykładową domenę z odwrotnym proxy za pomocą Apache i nauczymy się nią zarządzać za pomocą odpowiedniego menedżera procesów. Bez zbędnych ceregieli, zacznijmy.

Krótki opis Node.js, Koa.js i Apache

Node.js to szybka, wieloplatformowa platforma JavaScript oparta na silniku Chrome V8. Jest używany zarówno w aplikacjach stacjonarnych, jak i serwerowych i słynie z obsługi jednowątkowej pętli zdarzeń. Node.js zawiera rejestr pakietów o nazwie Node Package Manager (NPM), który obsługuje ponad pół miliona pakietów. Pakiety (lub moduły) NPM są rdzeniem sieci Node.js, ponieważ są kodem tworzonym przez społeczność i mogą być przydatne w aplikacji Node.js. W naszej aplikacji Koa.js Node.js jest podstawową częścią jej funkcji.

Koa.js to minimalistyczny framework internetowy, zbudowany na platformie Node.js. Stworzony przez ten sam zespół, który stoi za popularnym frameworkiem Express.js, jego celem jest dalsze zminimalizowanie już minimalistycznego frameworka Express.js poprzez wykluczenie oprogramowania pośredniego z jego rdzenia. Główną cechą Koa.js jest brak wywołań zwrotnych. Koa.js jest oparty na generatorach opartych na ES6 i funkcjach ES6, takich jak Promises.

Apache to popularny serwer WWW typu open source, wykorzystywany jako bardzo podstawowy punkt wyjścia dla serwerów sieciowych. W tym samouczku będziemy używać Apache jako odwrotnego proxy, co pozwoli nam połączyć naszą aplikację z przykładową domeną. Jeśli nie masz domeny, ten samouczek będzie nadal dla Ciebie działał, z tą różnicą, że witryna będzie działała na twoim VPS IP, a nie na domenie.

Konfigurowanie Node.js

Jak w każdym frameworku Node.js, musisz zainstalować Node.js na VPS. Na potrzeby tego samouczka założę, że masz już Node.js zainstalowany w systemie. Jeśli nie, możesz po prostu postępować zgodnie z instrukcjami tutaj .

Konfigurowanie naszego katalogu aplikacji

Będziemy musieli utworzyć folder, który będzie zawierał podstawowe pliki naszej aplikacji.

mkdir site

Zastępuj sitedowolną inną nazwą katalogu. Następnie będziemy musieli zainicjować nasz plik pakietu Node.js. Przejdź do właśnie utworzonego katalogu, uruchom npm initi wypełnij monity. Ostatecznie powinien wyglądać mniej więcej tak:

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

Instalowanie Koa.js

Po skonfigurowaniu naszego katalogu możemy kontynuować instalację Koa.js. W bieżącym katalogu roboczym /sitewpisz następujące polecenie.

npm install koa

Spowoduje to pobranie modułu Koa.js z NPM i zainstalowanie go w naszym katalogu projektu do wykorzystania w przyszłości. Następnie utworzymy nasz przykładowy plik aplikacji, który będzie zawierał nasz kod aplikacji. Aby to zrobić, utwórz index.jsplik.

nano index.js

Po otwarciu pliku utwórz przykładową aplikację.

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

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

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

Zapisz i zamknij plik. CTRL+ X.

Będziemy chcieli upewnić się, że nasza aplikacja działa poprawnie. Aby go uruchomić, uruchom node index.js, a zobaczysz Website is livew konsoli.

Instalowanie Apache

Teraz, gdy wiemy, że nasza strona działa, możemy przystąpić do instalacji Apache i jego zależności.

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

Aby skorzystać z funkcji odwrotnego proxy znajdującej się w Apache, będziemy musieli włączyć niezbędne moduły.

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

Niektóre z tych modułów mogły być już włączone, ale zawsze dobrze jest je dwukrotnie sprawdzić.

Teraz musimy edytować domyślny plik konfiguracyjny dla Apache.

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

Tutaj będziemy musieli dodać blok dla naszej aplikacji.

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

    ServerName localhost
</VirtualHost>

Zapisz plik, CTRL+ X.

Możesz zauważyć, że używamy portu 3000jako portu naszego ProxyPassi ProxyPassReverseadresu IP. Ponieważ jest to ten sam port, na którym uruchamiamy naszą aplikację Koa.js, konieczne jest podanie prawidłowego portu.

Po wprowadzeniu zmian będziemy musieli zrestartować Apache i ponownie uruchomić naszą aplikację Koa.js.

sudo systemctl restart apache2

Zapewni to, że nasz plik konfiguracyjny będzie aktywny i gotowy do pracy, gdy uruchomimy naszą aplikację Koa.js. Po ponownym uruchomieniu Apache przejdź do katalogu witryny i uruchom aplikację Koa.js, tak jak poprzednio. W przeglądarce internetowej przejdź do http://yourdomainlub http://yourip:, a zobaczysz „Hello World”.

Zarządzanie naszą aplikacją za pomocą systemd

Teraz, gdy omówiliśmy podstawy tworzenia przykładowej aplikacji Koa.js, zdajemy sobie sprawę, że w środowisku produkcyjnym uruchomienie aplikacji w obecnej postaci jest niepraktyczne. Kierownik procesu jest zdecydowanie wymogiem. Tam właśnie wchodzi systemd. Mówiąc najprościej, systemd składa się z oprogramowania, które zapewnia elementy składowe systemu Linux. Podobnie jak „init”, zapewnia system do zarządzania procesami użytkownika po uruchomieniu systemu. W przypadku naszej aplikacji systemd pozwala nam automatycznie uruchomić naszą stronę internetową po ponownym uruchomieniu systemu, w przypadku wystąpienia zdarzenia zakłócającego czas pracy systemu. Zapewnia również zestaw narzędzi, które mogą się przydać podczas zarządzania naszą aplikacją. Najlepsze jest to, że jest on wbudowany w Ubuntu 16.04 LTS, więc nie musimy instalować żadnego dodatkowego oprogramowania.

Utwórz usługę systemową

Wszystko, czego potrzebujemy do uruchomienia naszej aplikacji, będzie zawarte w pliku o nazwie service. Zawiera szczegółowe informacje o naszej aplikacji, takie jak nazwa, katalog, środowisko i wiele innych. Aby utworzyć nasz plik systemowy, otwórz edytor tekstu.

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

Edytuj i zapisz plik w ten sposób.

[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

Zamień youruserna nazwę użytkownika swojego serwera. Oto krótki przegląd najważniejszych pól:

• After - Informuje to systemd, aby poczekał, aż interfejs sieciowy będzie gotowy przed uruchomieniem naszej aplikacji.
• Environment- Tutaj możemy określić zmienne środowiskowe dla naszej aplikacji. Nasz port Node.js jest jednym z nich.
• Type - Informuje to systemd, że nasza aplikacja może zostać właśnie uruchomiona, bez utraty uprawnień użytkownika i tym podobnych.
• User- Mówi to systemd, że chcemy uruchomić aplikację na naszym koncie użytkownika, co jest zalecane. Uruchamianie aplikacji jako użytkownik root może prowadzić do wielu zagrożeń bezpieczeństwa.
• ExecStart - Zasadniczo polecenie uruchomione przez systemd, aby uruchomić naszą aplikację, podobnie jak wcześniej ręcznie.
• Restart- Informuje systemd, w jakich warunkach należy ponownie uruchomić naszą aplikację. W takim przypadku chcemy zrestartować naszą stronę internetową w przypadku błędu.

Uruchom usługę systemową

Jesteśmy teraz gotowi do uruchomienia naszej usługi systemowej.

sudo systemctl daemon-reload

Jest to konieczne za każdym razem, gdy zmienia się plik usługi systemowej, aby systemd mógł zarejestrować wszelkie wprowadzone zmiany.

Następnie uruchom aplikację.

sudo systemctl start site

Przejdź ponownie do witryny w przeglądarce, aby sprawdzić, czy wszystko działa.

Kluczowe funkcje zarządzania systemowego

• stop - Całkowicie zatrzymuje aplikację.
• restart - Zatrzymuje aplikację i uruchamia ją ponownie w ramach nowego procesu.
• enable - Mówi systemd, aby uruchamiał aplikację przy każdym uruchomieniu komputera.
• status - Pokazuje informacje o aktualnie uruchomionej aplikacji, takie jak czas działania, stan aplikacji i inne.

Aby użyć dowolnej z tych funkcji, uruchom następujące polecenie.

systemctl <function> site

Wniosek

Pomyślnie skonfigurowaliśmy aplikację Koa.js i nauczyliśmy się, jak odwrócić proxy, a także zarządzać nią za pomocą systemd. Możesz teraz rozszerzyć swoją aplikację i skorzystać z tego przykładu. Jeśli chcesz dowiedzieć się więcej na temat Koa.js i więcej rzeczy, które możesz zrobić, odwiedź ich stronę internetową , aby uzyskać więcej przydatnych informacji. Ponadto, jeśli chcesz dowiedzieć się więcej o menedżerze procesów systemd, przeczytaj dokumentację na ten temat tutaj . Na koniec, jeśli chcesz dowiedzieć się więcej o zwrotnym serwerze proxy Apache, możesz je sprawdzić tutaj .