Déployer une application Express

Vous pouvez trouver le guide de déploiement étape par étape ici.

Compilation de l’application

Hostman utilise l’environnement suivant lors de la compilation d’une application Express :

• Node.js: 16, 18, 20, or 22
• npm
• yarn
• PM2 (dernière version)

L’application est toujours compilée depuis la racine du dépôt, assurez-vous donc d’y placer le fichier package.json. Si le fichier se trouve dans un sous-répertoire (par exemple, landing), vous devez ajuster la commande de build. Par exemple :

npm run --prefix landing build

Hostman exécutera les commandes suivantes pendant la compilation :

apt install -y nodejs --fix-missing
npm install pm2@latest -g
npm install express

Si le projet inclut un fichier package.json et utilise yarn, nous exécuterons également :

apt-get remove -y cmdtest yarn
npm install --global yarn
cd /<DIRECTORY> && yarn install --check-files

Dans tous les autres cas, si un fichier package.json est présent :

cd /<DIRECTORY> && npm install

<DIRECTORY> est le chemin vers le répertoire contenant package.json. Dans la plupart des cas, il s’agit de la racine du projet.

L’application est exécutée à l’aide du gestionnaire de processus PM2. La commande de démarrage par défaut est :

pm2 start --no-daemon app.js

Le fichier d’initialisation de l’application (app.js dans l’exemple ci-dessus) peut s’appeler app.js, server.js, main.js ou index.js.

Dépannage

Échec du déploiement

En cas de problème lors du déploiement, consultez d’abord le journal de déploiement. Vous pourrez déterminer à quel moment une erreur s’est produite.

Souvent, les problèmes sont liés à la commande de démarrage. Vérifiez que tout fonctionne avec pm2 dans votre environnement de développement. Assurez-vous que tous les modules nécessaires à l’exécution de l’application sont présents dans le fichier package.json.

Please add build instructions to your script section in package.json

Le problème est que la commande yarn build accède au fichier package.json, et si la valeur de la directive build n’est pas spécifiée, une erreur se produit.

Pour corriger cela, vous devez ajouter les directives nécessaires à la section scripts du fichier package.json. En savoir plus sur l’utilisation des scripts ici.