Centrum pomocy

    Jak uruchomić aplikację Node.js na hostingu?

    Czym jest Node.js?

    Node.js - to zyskująca coraz większą popularność platforma umożliwiająca uruchomienie kodu JavaScript po stronie serwera. Dodatkową jej zaletą jest bogata lista rozszerzeń, które można do niej dołączać za pomocą npm.

    Wymagania wstępne

    Poniższy poradnik zakłada, że pliki Twojej aplikacji Node.js zostały już umieszczone na hostingu w odpowiednim folderze, który potem wskażesz w polu "Application root" podczas etapu konfiguracji. Pliki możesz wgrać za pomocą FTP/SSH lub jeżeli umieszczone są w repozytorium ściągnąć za pomocą GIT.

    1. Konfiguracja aplikacji


    Na początek zaloguj się do cPanel i kliknij przycisk "Setup Node.js App".


    Jeżeli nie widzisz przycisku "Setup Node.js App" oznacza to, że używasz hostingu ze starszej oferty. Przejdź na nowy pakiet (najlepiej PRO lub PREMIUM z dostępem SSH) poprzez zakładkę "Moje usługi -> Przejdź na nową ofertę / Zmień pakiet".


    Następnie w celu uruchomienia nowej aplikacji kliknij przycisk "Create application" a pojawi się poniższy formularz.


    Uzupełnij pola formularza zgodnie z opisem:
    • Node.js version - wybór wersji Node.js jaka ma być używana przez aplikację.
    • Application mode - tryb aplikacji (rozwój lub produkcja), można go potem zmienić.
    • Application root - tutaj ustaw względną ścieżkę do plików Twojej aplikacji Node.js, powinna ona być umieszczona poza katalogiem public_html (w naszym przypadku jest to katalog ściągniętego repozytorium z GIT).
    • Application URL - adres URL, pod którym będzie dostępna w internecie Twoja aplikacja (w tym przypadku wskazaliśmy podkatalog ale również dobrze może być to sama domena).
    • Application startup file - skrypt, który ma być uruchomiony na początku po wejściu na URL aplikacji.
    • Passenger log file - ścieżka do pliku logów aplikacji (warto wskazać aby móc sprawdzić jakie błędy pojawiają się podczas działania aplikacji).

    Po wypełnieniu wszystkich danych kliknij przycisk "Create".




    System potwierdzi stworzenie aplikacji poprzez powiadomienie w prawym górnym rogu. W szczegółach aplikacji masz możliwość edycji ustawień, zatrzymywania i restartowania aplikacji oraz jej usunięcia.


    2. Doinstalowanie brakujących pakietów


    Jeżeli Twoja aplikacja wymaga dodatkowych rozszerzeń to koniecznie kliknij przycisk "Run NPM install".


    Wymagany jest do tego plik package.json. Jeżeli jest nieobecny w Twoim projekcie to należy go stworzyć i umieścić w głównym katalogu aplikacji. Do tego czasu będzie pojawiać się takie ostrzeżenie.


    3. Uruchomienie aplikacji


    Wejdź na adres wskazany jako "Application URL" a zostanie uruchomiony skrypt z pola "Application startup file".

    Jeżeli Twoja aplikacja łączy się z bazą MySQL upewnij się, że w polu host (w plikach konfiguracji) masz wpisany adres localhost a w "cPanel -> Zdalna baza danych MySQL" dodany jest host 127.0.0.1.

    4. Zarządzanie poprzez konsolę



    Używając SSH możesz wejść w wirtualne środowisko i zarządzać aplikacją nodejs i pakietami poprzez linię komend. W tym celu skopiuj z ekranu edycji aplikacji całe polecenie podane w takiej ramce jak na poniższym ekranie (dla Twojego konta będą inne ścieżki).


    Zaloguj się na swoje konto poprzez SSH i uruchom skopiowane polecenie.

    Przykładowe dostępne komendy:
    • npm install - aby zainstalować pakiety wynikające z zależności wpisanych w package.json.
    • npm install nazwa_pakietu - aby zainstalować wybrany pakiet.
    • npm search nazwa - aby wyszukać dostępne pakiety o podanej nazwie.
    • node nazwa.js - uruchomienie wskazanego skryptu JS z konsoli (ctrl + C aby przerwać).

    Zobacz również: