ServBay-documentatie: Een specifieke Node.js-versie instellen voor uw projecten, scripts en websites

ServBay is een krachtig lokaal webontwikkelplatform dat verschillende programmeertalen en technologieën ondersteunt, waaronder Node.js. In de praktijk kan het nodig zijn om voor verschillende projecten, losse scripts of zelfs hele websites verschillende Node.js-versies te gebruiken. Zo kan een ouder project afhankelijk zijn van Node.js 14, terwijl een nieuw project juist de nieuwste features van Node.js 20 nodig heeft. ServBay biedt flexibele oplossingen om aan deze eisen te voldoen.

In dit artikel leest u hoe u binnen ServBay eenvoudig een specifieke Node.js-versie voor uw scripts en websites instelt, en hoe u gebruikmaakt van projectspecifieke configuratie.

Een Node.js-versie en configuratie instellen binnen het project met het .servbay.config-bestand

Voor projecten waar het essentieel is om de Node.js-versie en verwante omgevingsvariabelen strikt te controleren, biedt ServBay configuratie op projectniveau via een .servbay.config-bestand in de hoofdmap van uw project. Hiermee kunt u onder meer een specifieke Node.js-versie, pakketrepository-adressen en cachepaden instellen, zodat de omgeving van het project geïsoleerd en consistent blijft.

Een voorbeeld van een .servbay.config-bestand waarmee een specifieke Node.js-versie, npm/yarn-repository en cachemap worden ingesteld:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Voorbeeld: een specifieke mirror gebruiken
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Voorbeeld: een specifieke mirror gebruiken
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Voorbeeld: een specifiek cachepad instellen
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Voorbeeld: een specifiek cachepad instellen

Toelichting:

• NODE_VERSION: Geeft aan welke hoofdversie van Node.js dit project moet gebruiken. ServBay zoekt en gebruikt de geïnstalleerde Node.js-versie die hierbij past.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Stelt het adres van de pakketrepository in voor npm of yarn.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Stelt de cachemap in voor npm of yarn. In het voorbeeld wordt de standaard tijdelijke map van ServBay, /Applications/ServBay/tmp/, gebruikt.

Gewoonlijk plaatst u het .servbay.config-bestand in de hoofdmap van uw project. Een gedetailleerde handleiding over het gebruik vindt u in de officiële ServBay-documentatie onder het gedeelte .servbay.config-bestand.

Scripts draaien met een specifieke Node.js-versie via de opdrachtregel

Wilt u liever geen projectbrede Node.js-versie instellen, maar slechts tijdelijk een bepaalde versie van Node.js gebruiken om een script of opdracht uit te voeren? ServBay biedt hiervoor handige opdrachtregel-aliasen.

In de terminalomgeving van ServBay (te openen via de gebruikersinterface van de ServBay-app) geeft u eenvoudig met het commando node-<versie> aan welke geïnstalleerde Node.js-versie u wilt gebruiken voor een script. ServBay maakt zo’n alias voor elke geïnstalleerde Node.js-versie.

Stel, u wilt het script script.js uitvoeren met Node.js 14:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Voorbeeldoutput, versienummer kan afwijken

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Voorbeeldoutput, versienummer kan afwijken

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Voorbeeldoutput, versienummer kan afwijken

Uitleg bij het voorbeeld

• $ node-14 script.js: Voert het script script.js uit met de in ServBay geïnstalleerde Node.js 14 (welke 14.x.x-versie hangt af van uw installatie).
• $ node-16 script.js: Voert het script uit met de Node.js 16 die in ServBay geïnstalleerd is.
• $ node-20 script.js: Voert het script uit met de Node.js 20 die in ServBay geïnstalleerd is.

Dankzij deze methode kunt u snel scripts en taken testen onder verschillende Node.js-versies, zonder de globale Node.js-versie van uw systeem te hoeven wisselen.

Een standaard Node.js-versie kiezen voor een website via de ServBay-beheerinterface

Met ServBay kunt u binnen de beheerinterface eenvoudig de standaard Node.js-versie instellen voor een gehoste website. Dit is vooral handig voor sites die Node.js als backend gebruiken (bijvoorbeeld Node.js-frameworks achter een Caddy- of Nginx-reverse proxy) of die een specifieke Node.js-omgeving vereisen.

Stappenplan

1. Open de ServBay-beheerinterface:
   Start de ServBay-app en open de beheerinterface in uw browser (standaard via http://localhost:5200 of via de hoofdapplicatiewindow van ServBay).

2. Navigeer naar Websitebeheer:
   Klik in de linker navigatiebalk op Website (of 'Sites').

3. Selecteer en bewerk de website:
   Zoek in de lijst de website die u wilt configureren (bijvoorbeeld een site die staat in /Applications/ServBay/www/servbay.demo). Klik op het bewerkingspictogram (meestal een tandwiel of potloodje) rechts, of open de detailpagina door op de sitenaam te klikken.

4. Stel de Node.js-versie in:
   Zoek op de configuratiepagina van de website naar de instelling voor de Node.js-versie (vaak een dropdown-menu). Kies hier de gewenste versie die als standaard voor deze site moet gelden.

5. Wijzigingen opslaan:
   Na het kiezen van de juiste versie, vergeet niet onderaan op 'Opslaan' of 'Toepassen' te klikken.

6. Herstart de website of ServBay (indien nodig):
   Sommige wijzigingen vereisen mogelijk een herstart van de webserver (zoals Caddy of Nginx), of zelfs van de volledige ServBay-app. ServBay laat meestal zien of dit nodig is.

Let op

• Node.js-versie moet geïnstalleerd en actief zijn: De gekozen Node.js-versie moet al geïnstalleerd en geactiveerd zijn in het gedeelte Pakketten (Packages) van ServBay. Installeer of activeer deze zonodig eerst via die pagina.
• Websitetype: Deze instelling is vooral bedoeld voor websites die op Node.js draaien (zoals backend-applicaties gebouwd met Express.js, Next.js, NestJS enzovoorts). Voor statische sites of sites met volledig andere backends (zoals PHP, Python of Go) is de instelling doorgaans niet van toepassing.
• Compatibiliteitstest: Test uw website grondig nadat u de Node.js-versie heeft gewijzigd, zodat u zeker weet dat alle afhankelijkheden en services correct functioneren in de nieuwe omgeving.
• Relatie met .servbay.config: De omgevinginstelling op websitelaag is standaard. Staat er ook een .servbay.config-bestand in de root van de site met een NODE_VERSION, dan heeft die voorrang. Projectinstellingen zijn dus leidend voor meer gedetailleerde controle.

Samenvatting

ServBay is een compleet lokaal ontwikkelplatform dat krachtige, flexibele functies biedt om eenvoudig uw Node.js-runtime-omgeving te beheren en toe te wijzen. U kunt uw projectomgeving tot in detail instellen via het .servbay.config-bestand in de hoofdmap van uw project, snel verschillende Node.js-versies testen en scripts uitvoeren via het node-<versie>-commando in de terminal, of de standaard Node.js-versie voor uw website bepalen vanuit de gebruiksvriendelijke beheerinterface. Dankzij deze mogelijkheden kunt u soepel schakelen tussen oude en nieuwe projecten, nieuwe features testen, en uw lokale en productieomgeving perfect op elkaar afstemmen. ServBay biedt zo effectieve ondersteuning om uw ontwikkelproces sneller, consistenter en efficiënter te maken.