Déployer une application Node.js

En bref

Node.js est un environnement qui exécute du JavaScript côté serveur. Il permet notamment de faire fonctionner une application web ou une API, au-delà des scripts exécutés dans le navigateur.

Node.js est inclus dans tous les plans Option Hébergement : Essentiel, Croissance, Premium et Pro Multi-Sites. Les ressources de votre plan restent applicables : vérifiez les besoins de votre application avant son déploiement.

Préparer votre application

1. Préparez une application fonctionnelle et identifiez la version de Node.js compatible avec ses dépendances.
2. Transférez ses fichiers dans le répertoire prévu sur votre hébergement. Installez les dépendances et effectuez la compilation éventuelle selon la documentation de votre projet.
3. Identifiez la commande qui démarre réellement le serveur. Par exemple, npm start convient si votre fichier package.json définit un script start adapté.
4. Identifiez le port d’écoute de l’application et les paramètres dont elle a besoin. N’inscrivez jamais vos secrets dans des fichiers accessibles publiquement.
5. Si votre préparation nécessite SSH, consultez le guide Demander un accès SSH : son activation suit la procédure de validation prévue.

Ouvrir les réglages Node.js

Dans le panneau de contrôle de votre hébergement, ouvrez Sites web, sélectionnez le site concerné, puis rendez-vous dans Avancé → Node.js. Cliquez sur Déployer l’application pour ouvrir les paramètres.

Les intitulés peuvent varier légèrement selon la langue du panneau. Si l’option n’apparaît pas, contactez le support en indiquant le site concerné.

Choisir le mode et la version

• Automatique (Production) : l’application démarre automatiquement et redémarre si elle se ferme. Utilisez une commande adaptée à la production de votre projet.
• Manuel (Développement) : le serveur web peut transmettre les requêtes à l’application via le proxy, mais celle-ci n’est pas démarrée automatiquement. Suivez les indications du panneau et utilisez la commande d’initialisation qu’il affiche pour votre environnement SSH.

Dans le sélecteur de version, choisissez une version disponible compatible avec votre application. La liste du panneau fait référence ; ce guide ne garantit pas la disponibilité d’une version précise. Vérifiez la compatibilité avant tout changement.

Définir le démarrage et le répertoire

Renseignez la commande de démarrage de votre projet et son répertoire de travail. Ce répertoire doit correspondre à l’emplacement depuis lequel la commande doit être exécutée, généralement celui qui contient le fichier package.json lorsque vous utilisez npm.

La commande npm start affichée en exemple n’est pas universelle : adaptez-la aux instructions de votre application. Vérifiez que les dépendances et les fichiers compilés nécessaires sont présents avant le démarrage.

Configurer le proxy et les WebSockets

Le proxy transmet le trafic web de votre domaine principal à votre application Node.js.

1. Activez le proxy si votre application doit recevoir les requêtes du site par ce mécanisme.
2. Définissez le chemin à transmettre. Le panneau indique de laisser ce champ vide pour couvrir l’ensemble du site. Pour un chemin spécifique, assurez-vous que votre application sait fonctionner sous ce chemin.
3. Renseignez le port réellement utilisé par votre application. Le port 3000 visible dans l’exemple est indicatif : la valeur saisie et le port d’écoute doivent correspondre.
4. Configurez l’application pour écouter sur 0.0.0.0, comme indiqué dans le panneau, et pas uniquement sur localhost.
5. Activez l’option Permettre la mise à jour du proxy web socket uniquement si votre application utilise des WebSockets. Cette option transmet les requêtes WebSocket à votre application ; elle n’ajoute pas cette fonctionnalité à votre code.

Déployer et vérifier

Cliquez sur Déployer. En mode automatique, vérifiez ensuite que l’application répond sur le domaine et le chemin configurés. En mode manuel, démarrez d’abord l’application selon les indications du panneau.

Contrôlez les pages ou endpoints essentiels, les ressources statiques et les connexions WebSocket si vous les utilisez. Vérifiez également que l’ancien contenu reste accessible aux endroits où vous souhaitez le conserver.

Si l’application ne répond pas, contrôlez la version de Node.js, la commande, le répertoire de travail, les dépendances, l’adresse d’écoute et la correspondance du port avec le proxy. Consultez les messages d’erreur disponibles dans votre environnement sans exposer de données confidentielles.

Besoin d’aide ?

Consultez les plans d’hébergement pour comparer les capacités, ou contactez le support avec le domaine concerné, le mode choisi et le message d’erreur observé. Ne transmettez aucun mot de passe, jeton ou clé privée.