ServBay Dokumentation: So legen Sie eine spezifische Node.js-Version für Ihr Projekt, Skript oder Ihre Website fest

ServBay ist eine leistungsstarke lokale Webentwicklungsumgebung, die zahlreiche Programmiersprachen und Technologiestacks unterstützt – inklusive Node.js. Im Praxisalltag kann es notwendig sein, für verschiedene Projekte, einzelne Skripte oder ganze Websites jeweils eine bestimmte Node.js-Version zu verwenden. Ein älteres Projekt benötigt beispielsweise Node.js 14, während ein neues Projekt bereits die Features von Node.js 20 erfordert. ServBay stellt hierfür flexible Lösungen bereit.

In diesem Beitrag erfahren Sie im Detail, wie Sie in ServBay präzise bestimmen, welche Node.js-Version für Skripte und Websites verwendet wird und wie Sie projektbasierte Konfigurationsdateien einsetzen.

Mit der .servbay.config-Datei Node.js-Version und Konfiguration projektbasiert festlegen

Für Projekte, bei denen Sie Node.js-Version und Umgebungsvariablen genau steuern möchten, bietet ServBay die Möglichkeit einer projektbasierten Konfiguration über die Datei .servbay.config im Projektverzeichnis. In dieser Datei legen Sie beispielsweise fest, welche Node.js-Version verwendet wird, welche Registries für npm/yarn genutzt werden oder wo sich die Cache-Verzeichnisse befinden. Damit ist maximale Isolierung und Konsistenz Ihrer Projektumgebung gewährleistet.

Eine beispielhafte .servbay.config-Datei mit Angabe einer bestimmten Node.js-Version und spezifischer npm/yarn-Einstellungen sieht folgendermaßen aus:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Beispiel: bestimmter Mirror
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Beispiel: bestimmter Mirror
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Beispiel: Cache-Pfad festlegen
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Beispiel: Cache-Pfad festlegen

Erläuterungen:

• NODE_VERSION: Legt die Node.js-Hauptversion für dieses Projekt fest. ServBay sucht und verwendet die installierte Node.js-Version, die dieser Angabe entspricht.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Definiert die Package-Registry für npm bzw. yarn.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Legt das Cache-Verzeichnis für npm bzw. yarn fest. Im Beispiel werden die Standard-Temp-Verzeichnisse von ServBay unterhalb von /Applications/ServBay/tmp/ verwendet.

Im Regelfall legen Sie die .servbay.config-Datei im Hauptverzeichnis Ihres Projekts ab. Details zu weiteren Einstellungen und Nutzung finden Sie im offiziellen ServBay-Handbuch im Abschnitt zur .servbay.config-Datei.

Über die Kommandozeile Skripte mit einer bestimmten Node.js-Version ausführen

Möchten Sie keine projektweite Node.js-Version festlegen, sondern nur temporär ein Skript oder Kommando mit einer bestimmten Version ausführen, nutzen Sie die von ServBay bereitgestellten Kommandozeilen-Aliasnamen.

Im ServBay-Terminal (über die App-Oberfläche erreichbar) können Sie mit dem Befehl node-<version> bequem bestimmen, welche Node.js-Version für Ihr Skript verwendet werden soll. Für jede installierte Node.js-Version erstellt ServBay automatisch einen entsprechenden Alias.

Beispielsweise führen Sie script.js mit Node.js 14 so aus:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Beispielausgabe, Versionsnummer kann variieren

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Beispielausgabe, Versionsnummer kann variieren

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Beispielausgabe, Versionsnummer kann variieren

Erklärung der Beispiele

• $ node-14 script.js: Führt das Skript script.js mit der installierten Node.js-Version 14 (genaue Version je nach Installation) aus.
• $ node-16 script.js: Führt das gleiche Skript mit Node.js 16 aus.
• $ node-20 script.js: Verwendet Node.js 20 für die Ausführung des Skripts.

So können Sie flexibel Kompatibilitätstests durchführen oder schnelle Aufgaben mit einer bestimmten Node.js-Version erledigen – ganz ohne Umstellen der globalen Node.js-Version.

Für Ihre Website im ServBay-Interface die Node.js-Version festlegen

ServBay ermöglicht es Ihnen, direkt über das Verwaltungs-Interface für jede verwaltete Website eine Standard-Node.js-Version festzulegen. Das ist besonders für Webanwendungen sinnvoll, die Node.js als Backend-Service (z.B. mit Express.js, Next.js oder NestJS, betrieben hinter Caddy oder Nginx als Reverse Proxy) benötigen oder spezielle Node.js-Umgebungen erfordern.

Anleitung

1. Öffnen Sie die ServBay-Verwaltungsoberfläche:
   Starten Sie die ServBay-App und öffnen Sie das Management-Interface über den Browser (meist http://localhost:5200 oder über den Link im Hauptfenster der Anwendung).

2. Wechseln Sie zur Website-Verwaltung:
   Navigieren Sie im linken Menü zum Punkt Websites.

3. Website auswählen und bearbeiten:
   Suchen Sie in der Website-Liste nach der Seite, die Sie konfigurieren möchten (z.B. unter /Applications/ServBay/www/servbay.demo). Klicken Sie rechts neben dem Eintrag auf das Bearbeitungssymbol (Zahnrad, Bleistift, etc.) oder direkt auf den Websitename für die Detailansicht.

4. Node.js-Version einstellen:
   Suchen Sie in den Seiteneinstellungen den Punkt für die Node.js-Version (meist Dropdown-Menü). Wählen Sie die gewünschte Standardversion für diese Website aus.

5. Änderungen speichern:
   Klicken Sie nach der Auswahl unbedingt auf Speichern oder Übernehmen, um Ihre Auswahl zu sichern.

6. Website oder ServBay neu starten (falls nötig):
   Manche Änderungen werden erst nach Neustart der Webserver-Software (z.B. Caddy oder Nginx) oder von ServBay aktiv. ServBay zeigt in der Regel einen entsprechenden Hinweis an.

Wichtige Hinweise

• Node.js-Version muss installiert/aktiv sein: Die in den Website-Einstellungen gewählte Node.js-Version muss in ServBay unter Pakete installiert und aktiviert worden sein. Installieren oder aktivieren Sie sie bei Bedarf zuerst im Bereich Pakete.
• Art der Website: Diese Einstellung wirkt sich nur auf Websites aus, die Node.js als Umgebung benötigen (z.B. Applikationen auf Basis von Express.js, Next.js, usw.). Für reine statische Websites oder solche, die komplett auf PHP, Python, Go etc. basieren, ist sie nicht relevant oder ohne Auswirkung.
• Kompatibilität prüfen: Nach Umstellung der Node.js-Version sollten Sie die Website ausführlich testen, um sicherzustellen, dass alle Abhängigkeiten und Dienste weiterhin und ohne Probleme funktionieren.
• Zusammenspiel mit .servbay.config: Die Website-Einstellung legt standardmäßig die Node.js-Version fest. Existiert im Websiteverzeichnis jedoch zusätzlich eine .servbay.config mit Angabe eines NODE_VERSION, so hat diese Vorgabe in der Regel Vorrang und überschreibt die Website-Einstellung, da projektbasierte Konfigurationen eine höhere Priorität besitzen.

Fazit

ServBay bietet Ihnen als ganzheitliche Entwicklungsumgebung vielfältige, leistungsstarke Möglichkeiten, Node.js-Versionen gezielt zu verwalten und einzusetzen. Sie profitieren von:

• feiner Kontrolle und Konfiguration über die .servbay.config-Datei im Projektordner
• der bequemen Ausführung beliebiger Node.js-Versionen per node-<version>-Kommandozeilenbefehl
• sowie der Option, für jede Website in der ServBay-Oberfläche die passende Standard-Node.js-Version festzulegen.

Damit meistern Sie mühelos die unterschiedlichen Node.js-Anforderungen Ihrer Projekte und Szenarien – ob zur Kompatibilität mit Legacy-Software, beim Testen neuer Features oder um die Entwicklungsumgebung mit der späteren Produktionsumgebung abzugleichen. ServBay unterstützt Sie effektiv dabei, die Effizienz und das Management Ihrer Entwicklungsumgebung signifikant zu steigern.