Node.js: Różnice pomiędzy wersjami

(Node 21)
 
(Nie pokazano 12 wersji utworzonych przez 2 użytkowników)
Linia 16: Linia 16:
  
 
Na serwerach MyDevil udostępniamy następujące wersje Node:
 
Na serwerach MyDevil udostępniamy następujące wersje Node:
* v6.17.1 (domyślna) - binarki <code>node</code> i <code>npm</code>  
+
* v12.22.1 - binarki <code>node12</code> i <code>yarn12</code>
* v8.16.1 - binarki <code>node8</code> i <code>npm8</code>
+
* v14.21.1 - binarki <code>node14</code> i <code>npm14</code>
* v10.16.3 - binarki <code>node10</code> i <code>npm10</code>
+
* v16.20.2 (domyślna) - binarki <code>node16</code> i <code>npm16</code>
* v12.9.1 -  binarki <code>node12</code> i <code>npm12</code>
+
* v18.18.2 - binarki <code>node18</code> i <code>npm18</code>
 +
* v20.10.0 - binarki <code>node20</code> i <code>npm20</code>
 +
* v21.2.0 -  binarki <code>node21</code> i <code>npm21</code>
  
 
+
Zmiana wersji Node.js pod poleceniami node, npm, w przykładzie została ustawiona wersja v18, aby wskazać inną należy odpowiednio zmienić cyfrę przy node oraz npm:
Zmiana wersji Node.js pod poleceniami node, npm, w przykładzie została ustawiona wersja v8, aby wskazać inną należy odpowiednio zmienić cyfrę przy node oraz npm:
 
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
mkdir -p ~/bin && ln -fs /usr/local/bin/node8 ~/bin/node && ln -fs /usr/local/bin/npm8 ~/bin/npm && source $HOME/.bash_profile
+
mkdir -p ~/bin && ln -fs /usr/local/bin/node18 ~/bin/node && ln -fs /usr/local/bin/npm18 ~/bin/npm && source $HOME/.bash_profile
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Aby ponownie zmienić wersję Node.js tym razem na 12 wystarczy wykonać polecenie ze zmianą cyfr:
+
Aby ponownie zmienić wersję Node.js tym razem na 16 wystarczy wykonać polecenie ze zmianą cyfr:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
mkdir -p ~/bin && ln -fs /usr/local/bin/node12 ~/bin/node && ln -fs /usr/local/bin/npm12 ~/bin/npm && source $HOME/.bash_profile
+
mkdir -p ~/bin && ln -fs /usr/local/bin/node16 ~/bin/node && ln -fs /usr/local/bin/npm16 ~/bin/npm && source $HOME/.bash_profile
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Linia 68: Linia 69:
  
 
Restart aplikacji ''Node.js'' można wykonać za pomocą naszego [[DevilWEB|panelu zarządzania usługą]] w zakładce [[WWW]], lub przy użyciu polecenia [[Devil|systemu zarządzania kontem Devil]]: <code>devil www restart ''domena''</code>.
 
Restart aplikacji ''Node.js'' można wykonać za pomocą naszego [[DevilWEB|panelu zarządzania usługą]] w zakładce [[WWW]], lub przy użyciu polecenia [[Devil|systemu zarządzania kontem Devil]]: <code>devil www restart ''domena''</code>.
 +
 +
=== Limit procesów dla Phusion Passenger  ===
 +
Możliwość ustawienia ilości procesów dla stron typu Node.js.
 +
Składnia polecenia:
 +
 +
devil www options DOMENA processes <ILOŚĆ>
 +
 +
Gdzie:
 +
DOMENA oznacza domenę WWW typu Node.js.
 +
ILOŚĆ - ilość procesów w przedziale od 1 do 80% procesów systemowych konta hostingowego.
 +
 +
Opcja dostępna jest również w panelu DevilWEB:
 +
 +
Strony WWW (WWW Websites) ➡ Szczegóły (Details) ➡ Limit procesów (Number of processes) ➡ należy wpisać nową wartość oraz zapisać zmiany przyciskiem Zapisz zmiany (Save changes).
  
 
=== Pliki statyczne ===
 
=== Pliki statyczne ===
Linia 81: Linia 96:
 
=== Logi ===
 
=== Logi ===
  
Istnieje możliwość [[Logi#Error_log_Ruby.2C_Python.2C_Nodejs|logowania]] błędów.
+
{{Warning|Nie należy usuwać katalogu logs, może to spowodować brak działania stron Node.js, Ruby, Python.}}
 +
 
 +
Logi błędów zapisują się do pliku error.log w katalogu <code class="directory">/usr/home/''login''/domains/''domena''/logs/</code>.
  
 
=== Czas życia aplikacji ===
 
=== Czas życia aplikacji ===

Aktualna wersja na dzień 00:07, 22 gru 2023

Node.js to otwarte, wieloplatformowe środowisko programistyczne.

Wstępna konfiguracja

Do uruchomienia aplikacji opartej Node.js należy najpierw zadbać o prawidłową konfigurację wstępną pod Node.js. Przed przystąpieniem do dalszych kroków należy upewnić się, że:

  • Domena jest prawidłowo dodana i skonfigurowana w naszym systemie DNS.
  • Została dodana strona WWW ze wskazaniem typu Node.js w wybranej przez siebie wersji.
  • Zostały wykonane polecenia:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global' 
echo 'export PATH=~/.npm-global/bin:~/bin:$PATH ' >> $HOME/.bash_profile && source $HOME/.bash_profile

Wersje Node.js

Na serwerach MyDevil udostępniamy następujące wersje Node:

  • v12.22.1 - binarki node12 i yarn12
  • v14.21.1 - binarki node14 i npm14
  • v16.20.2 (domyślna) - binarki node16 i npm16
  • v18.18.2 - binarki node18 i npm18
  • v20.10.0 - binarki node20 i npm20
  • v21.2.0 - binarki node21 i npm21

Zmiana wersji Node.js pod poleceniami node, npm, w przykładzie została ustawiona wersja v18, aby wskazać inną należy odpowiednio zmienić cyfrę przy node oraz npm:

mkdir -p ~/bin && ln -fs /usr/local/bin/node18 ~/bin/node && ln -fs /usr/local/bin/npm18 ~/bin/npm && source $HOME/.bash_profile

Aby ponownie zmienić wersję Node.js tym razem na 16 wystarczy wykonać polecenie ze zmianą cyfr:

mkdir -p ~/bin && ln -fs /usr/local/bin/node16 ~/bin/node && ln -fs /usr/local/bin/npm16 ~/bin/npm && source $HOME/.bash_profile

Projekt Node.js

Głównym katalogiem projektu Node.js (tj. katalog, w którym znajduje się plik app.js) musi być folder /usr/home/login/domains/domena/public_nodejs. Należy również usunąć plik index.html poleceniem rm /usr/home/login/domains/domena/public_nodejs/public/index.html

Moduły Node.js

Aby zainstalować wybrany moduł Node.js należy skorzystać z polecenia npm install -g nazwa_modułu. Moduły posiadające binarki zaleca się instalować w katalogu domowym. Aby móc z nich skorzystać należy koniecznie włączyć binexec i przelogować się.

Przygotowanie aplikacji Node.js

Nowy projekt Node.js należy utworzyć w katalogu /usr/home/login/domains/domena/public_nodejs - najprostszym sposobem utworzenia odpowiedniego projektu jest stworzenie pliku app.js:

var http = require('http');
var server = http.createServer(function(req, res) {
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end("hello world!\n");
});
server.listen(3000);

Widoczny w ostatniej linii port 3000 nie otworzy socketu na porcie 3000. Phusion Passenger automatycznie wybiera losowy, wolny port, przez który komunikuje się z aplikacją. Rezerwacja portu nie jest potrzebna przy uruchamianiu aplikacji przez typ nodejs.

Istniejący projekt Node.js

Istniejący projekt Node.js należy umieścić jako katalog /usr/home/login/domains/domena/public_nodejs. W przypadku gdy projekt nie nazywa się public_nodejs należy zmienić jego nazwę. Należy również zmodyfikować plik app.js tak, aby wykonywał aplikację. Zwykle poza odpowiednim require i ustawieniem listen() plik app.js nie potrzebuje zawierać więcej elementów. Trzeba również zainstalować brakujące poleceniem npm install.

Restart aplikacji

Restart aplikacji Node.js można wykonać za pomocą naszego panelu zarządzania usługą w zakładce WWW, lub przy użyciu polecenia systemu zarządzania kontem Devil: devil www restart domena.

Limit procesów dla Phusion Passenger

Możliwość ustawienia ilości procesów dla stron typu Node.js. Składnia polecenia:

devil www options DOMENA processes <ILOŚĆ>

Gdzie: DOMENA oznacza domenę WWW typu Node.js. ILOŚĆ - ilość procesów w przedziale od 1 do 80% procesów systemowych konta hostingowego.

Opcja dostępna jest również w panelu DevilWEB:

Strony WWW (WWW Websites) ➡ Szczegóły (Details) ➡ Limit procesów (Number of processes) ➡ należy wpisać nową wartość oraz zapisać zmiany przyciskiem Zapisz zmiany (Save changes).

Pliki statyczne

Wszystkie pliki umieszczone w /usr/home/login/domains/domena/public_nodejs/public są serwowane jak pliki statyczne. W tym katalogu najlepiej umieścić wszystkie obrazki, skrypty, style, itp. Żądania do plików znajdujących się w tym folderze nie będą przetwarzane przez Node.js i nie będą obciążać interpretatora. Na przykład plik /usr/home/login/domains/domena/public_nodejs/public/robots.txt będzie dostępny pod adresem http://domena/robots.txt.

Zmienne

Ustawianie zmiennej z poziomu SSH z widocznością dla aplikacji uruchamianej przez Passengera:

  • Dopisanie zmiennych do ~/.bash_profile (np. export TESTENV=1).
  • Ważne: zmienne nie działają z ~/.bashrc i ~/.shrc

Logi

Logi błędów zapisują się do pliku error.log w katalogu /usr/home/login/domains/domena/logs/.

Czas życia aplikacji

W przypadku braku ruchu na stronie przez 24h aplikacja jest wyłączana automatycznie i ponownie automatycznie uruchamiana przy pierwszym następnym wejściu. W przypadku zmiany w konfiguracji po naszej stronie również aplikacja jest automatycznie wyłączana i uruchamiana przy następnym pierwszym wejściu na stronę.


Odnośniki zewnętrzne