Technologia Node.js

Czym jest Node.js?

Node.js to środowisko, które umożliwia uruchamianie programów pisanych w języku JavaScript poza przeglądarką internetową, na poziomie serwera. Node.js działa w oparciu o stworzony przez Google silnik V8, oraz korzysta z dużej liczby dodatkowych modułów, które można wykorzystywać jako szkielety tworzonych aplikacji, aby przyspieszyć proces jej tworzenia. Dzięki Node.js nawet bardzo złożone systemy mogą działać szybko i sprawnie, ponieważ aplikacje uruchamiane są na serwerze, a do przeglądarki wysyłany jest tylko wynik ich pracy.

Największą zaletą Node.js jest umożliwienie użytkownikom wygodnego i prostego tworzenia zaawansowanych programów, takich jak gry sieciowe (multiplayer) czy aplikacje giełdowe, które wyświetlają dane i aktualizacje w czasie rzeczywistym. Bardzo ważnym elementem, przyspieszającym pisanie programów w Node.js, są frameworki. Jest to rodzaj często bardzo rozbudowanych szkiców aplikacji, które sprawiają, że nie trzeba pisać całego kodu programu od podstaw, a jedynie wystarczy skorzystać z już gotowych funkcjonalności, które te szkice oferują. Wykorzystywanie ich możliwości pozwala skrócić czas budowania aplikacji, skupiając się tylko na jej układzie, logice i działaniu.

Na hostingu nazwa.pl zostały zainstalowane i automatycznie skonfigurowane frameworki dla front-endu, baz danych i back-endu. Wybierając określoną wersję Node.js automatycznie konfigurowany jest dostęp do odpowiadających jej frameworków.

Jak włączyć Node.js na hostingu?

Dla domen obsługiwanych na serwerach hostingowych w nazwa.pl włączany jest jako domyślny interpreter PHP. Środowisko Node.js włącza się dla wybranej domeny, dokonując zmiany właściwego dla niej interpretera w panelu Active.admin.

UWAGA! Dla domeny będącej jednocześnie identyfikatorem serwera (serverXXXXXX.nazwa.pl) nie ma możliwości zmiany rodzaju interpretera. Identyfikator serwera obsługuje wyłącznie interpreter PHP. Z interpretera Node.js można skorzystać dla subdomeny utworzonej w ramach identyfikatora w postaci jakas-nazwa.serverXXXXXX.nazwa.pl, gdzie "jakas-nazwa", to nazwa tej subdomeny.

WIĘCEJ INFORMACJI: Jak ustalić właściwy panel Active.admin?

Aby zalogować się do panelu Active.admin, wejdź na stronę https://admin.nazwa.pl/ (1), wpisz identyfikator posiadanego serwera w polu Nazwa użytkownika oraz, ustalone przez siebie w Panelu Klienta, hasło do usługi (2). Po uzupełnieniu danych, kliknij przycisk Zaloguj (3).

Jeżeli chcesz zmienić domyślny interpreter dla swojej domeny, po zalogowaniu do panelu Active.admin przejdź do zakładki Domeny → Wykaz domen, znajdź na liście domenę tę, dla której zmiana ma zostać wykonana, i kliknij na jej nazwę.

Po kliknięciu na nazwę wybranej domeny wyświetlony zostanie formularz jej domeny. W sekcji Interpreter należy zaznaczyć checkbox przy opcji Node.js (1), a następnie włączyć lub wyłączyć dodatkowe opcje programistyczne (2). Po wykonaniu zmian, należy kliknąć przycisk Zapisz (3).

Zmiana wersji interpretera, a więc włączenie Node.js, możliwa jest również w chwili dodawania nowej domeny do serwera.

Jak zmienić wersję Node.js?

W celu zmiany wersji Node.js należy przejść, w panelu Active.admin, do zakładki Ustawienia i wybrać opcję Ustawienia serwera (1).

W sekcji Konfiguracja Node.js, znajdującej się poniżej ustawień PHP, należy wybrać z listy rozwijanej właściwą wersję interpretera (1) i zapisać zmianę.

Co istotne, wersja Node.js ustawiania jest globalnie dla całego serwera. Nie ma możliwości ustawienia różnych wersji dla poszczególnych domen, w ramach tego samego serwera. Zmiana wersji Node.js powoduje również zmianę odpowiednich dla danej wersji interpretera dostępnych frameworków.

Jak zrestartować serwer aplikacyjny Node.js?

Po wykonaniu zmian w aplikacji wykorzystującej Node.js i umieszczeniu jej na serwerze, należy wykonać jej restart. Restart taki możliwy jest do wykonania poprzez dodatkową opcję, widoczną przy adresie domeny w panelu Active.admin. W tym celu, przejdź do zakładki Domeny → Wykaz domen, odnajdź na liście domenę, dla której chcesz wykonać restart aplikacji, a następnie kliknij odnośnik zrestartuj serwer (1) widoczny przy opcji interpreter: Node.js.

Restart możliwy będzie również przez CLI (narzędzie Command Line Interface), z użyciem komendy nodecli. Należy zatem wpisać:

nodecli restart

Kolejną możliwością wykonania restartu jest wykonanie, poprzez połączenie SSH, polecenia touch na pliku restart/restart.txt. Katalog restart i pusty plik restart.txt należy wcześniej utworzyć w tym katalogu, na który została przekierowana domena. Restart należy wykonać poleceniem:

touch restart/restart.txt

Efekt polecenia widoczny będzie przy pierwszym wywołaniu aplikacji od chwili zapisu pliku restart.txt.

Lista domyślnie dostępnych frameworków Node.js na serwerach nazwa.pl:

Express.js - najczęściej wybierany przy tworzeniu interfejsów API, swą popularność zawdzięcza doskonałej wydajności, jest skalowalny i w pełni konfigurowalny;
Koa.js - umożliwia projektowanie i tworzenie aplikacji Node.js z większą wydajnością obsługi błędów;
Socket.io - framework używany do tworzenia aplikacji takich jak chatboty lub aplikacje do wideokonferencji;
Nest.js – framework, który pozwala na tworzenie skalowalnych aplikacji serwerowych;
Sails.js - framework bardzo wysokiego poziomu, pozwalający na szybką budowę kompletnego back-endu dla aplikacji webowej, obejmujący takie koncepcje jak np. REST czy HTTP, pozwalający na rozwój interfejsów API;
Total.js - framework podobny do Laravel (PHP) czy Django (Python), wykorzystywany do budowy stron internetowych, aplikacji e-commerce czy aplikacje IoT;
Hapi.js - stanowi doskonałą platformę dla dużych i rozproszonych zespołów zarządzających jednocześnie wieloma zadaniami i świetnie sprawdzi się w pracach projektowych.

a także: Derby.js, LoopBack.io oraz Adonis.js.

Npm – manager pakietów dla środowiska Node.js

Dodatkowe moduły wykorzystywane przez aplikację Node.js można wgrać na 2 sposoby:

ręcznie na serwer przy użyciu protokołu FTP lub SSH;
skorzystać z funkcjonalności npm wykonując przez SSH polecenie:
npmXX install -g nazwa_modułu

gdzie npmXX wpisz nazwę managera pakietów Npm odpowiadającego wykorzystywanej przez Ciebie wersji Node.js, np. npm10, npm12, npm14 czy npm15.

Moduły ściągnięte przez Npm będą domyślnie zapisane w katalogu „.node” a w nim:

- katalog „10” (odpowiadający wersji 10 Node.js, tu będą zapisywały się moduły dla wersji 10)

- katalog „12” (odpowiadający wersji 12 Node.js, tu będą zapisywały się moduły dla wersji 12)

- katalog „14” (odpowiadających wersji 14 Node.js, tu będą zapisywały się moduły dla wersji 14)

- katalog „15” (odpowiadających wersji 15 Node.js, tu będą zapisywały się moduły dla wersji 15)

Projekt Node.js

Katalogiem głównym projektu Node.js jest katalog w którym znajduje się plik wykonywalny, czyli plik app.js. Katalog ten to DocRoot i AppRoot - konfiguracji tej nie można modyfikować. Statyczne pliki powinny być również umieszczone w katalogu głównym aplikacji, nie będzie na nie wydzielonej odrębnej przestrzeni.

Chcąc uruchomić aplikację przez wiersz poleceń, należy to zrobić wywołując właściwą wersję Node.js, np:

node12 app.js
node15 app.js

Przykład:

Domena: node.js1.server000000.nazwa.pl

Katalog główny projektu: /node.js1

Plik wykonywalny w katalogu głównym: app.js

Prosta aplikacja:

var http = require('http');
http.createServer(function (req, res) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello World !');
}).listen(8080);

Logi aplikacji

Logi dla Phusion Passenger są zapisywane w katalogu /tmp i są dostępne przez SSH.

Table of Contents