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.

WAŻNE! Włączenie Node.js dla domeny uruchamia dla niej serwer aplikacyjny. Ilość możliwych do uruchomienia serwerów aplikacyjnych uzależniona jest od opcji posiadanego serwera hostingowego. Limit serwerów aplikacyjnych sprawdzić można klikając przycisk PEŁNA SPECYFIKACJA na stronie produktowej nazwa.pl, np. https://www.nazwa.pl/hosting/.

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