Dokumentacja ServBay: Ustawienie konkretnej wersji Node.js dla Twojego projektu, skryptu i strony internetowej

ServBay to zaawansowane, lokalne środowisko do tworzenia stron WWW, obsługujące wiele języków programowania i stosów technologicznych, w tym Node.js. W praktyce programistycznej możesz potrzebować różnych wersji Node.js dla poszczególnych projektów, pojedynczych skryptów czy całych stron internetowych. Przykładowo, starszy projekt może wymagać Node.js 14, podczas gdy nowy korzysta z funkcji dostępnych tylko w Node.js 20. ServBay zapewnia elastyczne rozwiązania na takie potrzeby.

Ten artykuł szczegółowo opisuje, jak z łatwością przypisywać konkretne wersje środowiska Node.js do skryptów i stron WWW w ServBay, wykorzystując konfigurację na poziomie projektu.

Określenie wersji Node.js i innych ustawień projektowych przez plik .servbay.config

Dla projektów wymagających ścisłej kontroli wersji Node.js i zmiennych środowiskowych, ServBay oferuje konfigurację na poziomie projektu poprzez utworzenie pliku .servbay.config w katalogu głównym projektu. W tym pliku możesz zdefiniować wersję Node.js, adresy repozytoriów menedżerów pakietów oraz ścieżki do katalogów cache, gwarantując izolację i spójność środowiska dla projektu.

Przykładowy plik .servbay.config z określeniem wersji Node.js oraz ustawieniami rejestrów i cache dla npm/yarn może wyglądać następująco:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Przykład: użycie własnego mirroru
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Przykład: użycie własnego mirroru
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Przykład: określona ścieżka do cache
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Przykład: określona ścieżka do cache

Opis:

• NODE_VERSION: Określa wersję główną Node.js, używaną w danym projekcie. ServBay automatycznie odnajdzie i zastosuje zainstalowaną wersję pasującą do tego numeru.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Konfigurują adres rejestru (repozytorium) dla menadżerów pakietów npm lub yarn w tym projekcie.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Ustawiają ścieżkę katalogu cache narzędzi npm lub yarn. W przykładzie wykorzystano domyślny katalog tymczasowy /Applications/ServBay/tmp/ oraz podkatalogi.

Zazwyczaj plik .servbay.config należy umieścić w katalogu głównym projektu. Szczegóły konfiguracji i użytkowania znajdziesz w oficjalnej dokumentacji ServBay w sekcji dotyczącej pliku .servbay.config.

Uruchamianie skryptów Node.js w określonej wersji przez linię poleceń

Jeśli nie chcesz ustawiać stałej wersji Node.js na poziomie projektu, lecz po prostu okazjonalnie uruchomić skrypt w wybranej wersji Node.js, ServBay udostępnia wygodne aliasy w terminalu.

W terminalu ServBay (dostępnym bezpośrednio z interfejsu aplikacji), możesz skorzystać z polecenia node-<wersja>, aby wskazać, w jakiej wersji Node.js ma zostać uruchomiony dany skrypt. ServBay tworzy taki alias dla każdej zainstalowanej wersji Node.js.

Przykładowo, aby uruchomić skrypt script.js w wersji Node.js 14, wpisz:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Przykładowy wynik – numer wersji może się różnić

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Przykładowy wynik – numer wersji może się różnić

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Przykładowy wynik – numer wersji może się różnić

Wyjaśnienie przykładów

• $ node-14 script.js: Uruchamia skrypt script.js w Node.js w wersji 14 zainstalowanej w ServBay (konkretna wersja 14.x.x zależy od stanu instalacji).
• $ node-16 script.js: Uruchamia script.js w Node.js 16.
• $ node-20 script.js: Uruchamia script.js w Node.js 20.

W ten sposób bardzo łatwo testować zgodność kodu z różnymi wersjami Node.js lub szybciej uruchomić zadanie wymagające konkretnej wersji, bez konieczności zmiany wersji Node.js na poziomie globalnym.

Ustawianie domyślnej wersji Node.js dla strony przez interfejs ServBay

ServBay umożliwia wskazanie domyślnej wersji Node.js dla zarządzanej strony internetowej bezpośrednio z panelu zarządzania. To przydatne rozwiązanie dla stron korzystających z Node.js jako backendu (np. aplikacje oparte na frameworku Node.js, obsługiwane przez Caddy lub Nginx jako proxy) oraz wszędzie tam, gdzie wymagana jest określona wersja środowiska Node.js.

Krok po kroku

1. Otwórz panel zarządzania ServBay: Uruchom aplikację ServBay i przejdź do panelu zarządzania przez przeglądarkę (zazwyczaj http://localhost:5200 lub link z okna głównego aplikacji).
2. Przejdź do zarządzania stronami: W menu po lewej stronie wybierz Strony (Website).
3. Wybierz i edytuj stronę: Odszukaj na liście stronę, dla której chcesz zmienić ustawienia (np. stronę utworzoną w katalogu /Applications/ServBay/www/servbay.demo). Kliknij przycisk edycji (ikona koła zębatego lub ołówka) lub nazwę strony, aby przejść do szczegółów.
4. Wybierz wersję Node.js: W konfiguracji strony odszukaj ustawienie dotyczące wersji Node.js – najczęściej jest to lista rozwijana. Wybierz z niej wersję Node.js, która ma być domyślna dla tej strony.
5. Zapisz zmiany: Po wybraniu wersji kliknij przycisk Zapisz lub Zastosuj, aby potwierdzić i zachować ustawienia.
6. Restart strony lub ServBay (jeśli wymagane): Po niektórych zmianach konieczny może być restart serwera WWW (np. Caddy czy Nginx), bądź całego ServBay. System zazwyczaj sam zaproponuje odpowiednią operację, jeśli to konieczne.

Wskazówki i uwagi

• Upewnij się, że wybrana wersja Node.js jest zainstalowana i aktywna: Edytując ustawienia strony, wybór wersji Node.js jest możliwy tylko spośród wersji zainstalowanych i uruchomionych w zakładce Pakiety (Packages) ServBay. W razie braku wersji zainstaluj lub uruchom ją w tej sekcji.
• Typ strony: To ustawienie jest istotne głównie dla stron/aplikacji zależnych od Node.js (np. projekty w Express.js, Next.js, NestJS itp.). Dla statycznych stron lub backendu realizowanego w PHP/Python/Go to ustawienie może być nieistotne lub wywrze ograniczony wpływ.
• Testy zgodności: Po zmianie wersji Node.js dla strony przetestuj ją dokładnie, aby upewnić się, że wszystkie zależności i usługi działają poprawnie na nowej wersji środowiska.
• Powiązanie z .servbay.config: Ustawienie poziomu strony stanowi wartość domyślną. Jeżeli w katalogu strony znajduje się plik .servbay.config z parametrem NODE_VERSION, jego ustawienie będzie miało priorytet i nadpisze konfigurację ustawioną w panelu.

Podsumowanie

ServBay, jako wszechstronne i nowoczesne lokalne środowisko developerskie, pozwala w elastyczny i wygodny sposób zarządzać wersjami Node.js. Masz do wyboru: precyzyjną konfigurację na poziomie projektu przez plik .servbay.config, natychmiastowe uruchamianie wybranych wersji Node.js za pomocą aliasów w terminalu (node-<wersja>) lub ustawienie domyślnej wersji Node.js dla całej strony przez panel zarządzania. Te funkcje umożliwiają wygodne dostosowanie środowiska do potrzeb konkretnych projektów – zarówno przy pracy nad starszym kodem, testach nowych funkcji, jak i utrzymaniu spójności środowiska deweloperskiego z produkcyjnym. Dzięki temu ServBay znacząco podnosi efektywność pracy i zarządzania środowiskami Node.js.