Deze handleiding legt uit hoe u de configuratie van een Node.js-site kunt aanpassen die is gehost op de infrastructuur van Infomaniak. U leert hoe u het gedrag van uw applicatie kunt aanpassen aan de hand van de ontwikkeling, de afhankelijkheden of uw technische voorkeuren.

Vereisten

• Installeer een Node.js-site op uw hosting.
• Test uw wijzigingen lokaal voordat u ze in productie toepast.
• Controleer of uw scripts (start, build) correct zijn gedefinieerd in uw package.json-bestand.
• Als u de structuur van uw project wijzigt, vergeet dan niet de uitvoermap en de bijbehorende opdrachten aan te passen.
• Belangrijk: de poort waarop wordt geluisterd, die in het Manager is gedefinieerd, moet absoluut overeenkomen met de poort die in de code van de applicatie wordt gebruikt.

Toegang tot de configuratie

Elke site heeft een eigen dashboard voor het beheren van de applicatie (start, stop, restart), het bekijken van de uitvoeringslogboeken, het beheren van de Node.js-versies en het activeren van SSL-certificaten:

1. Klik hier om toegang te krijgen tot het beheer van uw site in het Infomaniak Manager (hulp nodig?).
2. Klik rechtstreeks op de naam van de betreffende site:
   
3. Klik op Geavanceerde instellingen beheren:
   
4. Klik op het tabblad Node.js om toegang te krijgen tot de instellingen:
   

Opdrachten en automatisering

Uitvoermap

De uitvoermap geeft de locatie op de server aan waar de bouw- en startopdrachten worden uitgevoerd. Deze moet verwijzen naar de hoofdmap van uw applicatie, waar uw package.json-bestand zich bevindt.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Bouwopdracht (Build)

Als uw applicatie een voorbereidingsstap vereist (installeren van afhankelijkheden, compileren van TypeScript, minimaliseren), geeft u hier de uit te voeren opdracht op. Dit is de aanbevolen methode om uw updates te implementeren.

In tegenstelling tot een handmatige uitvoering via SSH, gebruikt deze interface een omgeving met verbeterde prestaties om een snelle bouw te garanderen zonder de resources van uw site in productie te beïnvloeden. U kunt er meerdere taken aan elkaar koppelen (zoals een git pull gevolgd door een bouw) en de voortgang en de logboeken van het proces in realtime volgen, rechtstreeks vanuit het Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Let op: Als uw project al is gecompileerd of geen tussenstappen vereist, kan dit veld leeg blijven.

Startopdracht

Deze instructie start uw server. Deze moet identiek zijn aan de opdracht die u in uw lokale ontwikkelomgeving gebruikt om het startpunt van de applicatie te starten.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Luisterpoort

Uw applicatie moet absoluut luisteren op de dynamische poort die door het Manager is toegewezen. Deze poort wordt doorgegeven aan uw code via de omgevingsvariabele PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Node.js-versie

U kunt de gewenste Node.js-versie selecteren in de instellingen. Het is raadzaam om de voorkeur te geven aan een stabiele versie (LTS) om de veiligheid en de duurzaamheid van uw project te waarborgen.

Wijzigingen toepassen en valideren

Nadat u uw wijzigingen in het Manager hebt opgeslagen, moet u uw applicatie opnieuw starten vanuit het dashboard, zodat de nieuwe instellingen (nieuwe Node-versie, nieuwe poort of nieuwe bouwopdracht) worden toegepast.

Als er problemen optreden bij het opstarten, kunt u de uitvoeringsconsole raadplegen of deze andere handleiding raadplegen voor probleemoplossing.