Ce guide explique comment ajuster la configuration d'un site Node.js hébergé sur l'infrastructure Infomaniak afin d’adapter le comportement de votre application en fonction de son évolution, de ses dépendances ou de vos préférences techniques.

Prérequis

• Installer un site Node.js sur votre hébergement.
• Tester vos modifications en local avant de les appliquer en production.
• Vérifier que vos scripts (start, build) sont bien définis dans votre fichier package.json.
• Si vous modifiez la structure de votre projet, penser à ajuster le dossier d’exécution et les commandes associées.
• Le port d’écoute défini dans le Manager doit impérativement correspondre à celui utilisé dans le code de l’application.

Accéder à la configuration

Chaque site dispose d’un tableau de bord dédié pour contrôler l’application (start, stop, restart), consulter la console d’exécution, gérer les versions de Node.js, configurer les domaines et activer les certificats SSL:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Vous pouvez ouvrir la console, stopper le projet (une page de maintenance sera appliquée) ou le redémarrer.
4. Pour accéder aux paramètres avancés, cliquez sur Gérer sous Paramètres avancés:
   
5. Cliquez sur l'onglet Node.js pour accéder aux réglages:
   

Appliquer les changements

Pour cela:

1. Enregistrez les modifications depuis l’interface du Manager.
2. Redémarrez votre application pour que les changements soient pris en compte.

Prenez connaissance de cet autre guide en cas de problème.

Commandes principales

Dossier d’exécution

Le dossier d’exécution indique l’emplacement sur le serveur où seront exécutées les commandes de construction et de lancement. Il doit pointer vers le répertoire racine de votre application, c’est-à-dire là où se trouve votre fichier package.json.

Par exemple, vous pouvez spécifier pour la racine du projet:

./

ou si votre application est dans un sous-dossier nommé app:

./app

ou si elle se trouve dans un dossier backend:

./backend

Commande de construction (facultative)

Si votre application Node.js nécessite une étape de compilation avant d’être exécutée, renseignez une commande de construction dans le champ prévu à cet effet. Cette commande sera exécutée automatiquement avant le démarrage de l’application.

Par exemple, vous pouvez indiquer :

npm install && npm run build

ou, si vous utilisez yarn :

yarn install && yarn build

Si votre projet ne nécessite aucune compilation, ce champ peut être laissé vide.

Commande de lancement

La commande de lancement correspond à l’instruction utilisée pour démarrer votre application. Elle doit être identique à celle que vous utilisez en local pour exécuter le projet.

Par exemple, vous pouvez indiquer :

node index.js

npm start

ou

yarn start

Cette commande doit permettre de lancer directement le serveur ou le point d’entrée de votre application tel qu’il est défini dans votre environnement de développement.

Port d’écoute

Votre application doit écouter sur un port spécifique qui est défini dans le Manager. Ce port est transmis à votre application via une variable d’environnement PORT.
Exemple dans votre code Node.js :

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Application lancée sur le port ${port}`);
});

Assurez-vous que ce port est bien pris en compte dans votre code.

Version de Node.js

Vous pouvez sélectionner la version de Node.js que votre site doit utiliser. Il est conseillé d’utiliser une version stable et toujours supportée pour garantir la sécurité et la compatibilité de votre application.