Outils pour utilisateurs

Outils du site


software:applications:xbrowsersync:installation-serveur

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
software:applications:xbrowsersync:installation-serveur [2026/10/03 10:45] – yoannsoftware:applications:xbrowsersync:installation-serveur [2026/10/10 10:44] (Version actuelle) – yoann
Ligne 36: Ligne 36:
  
 <code bash> <code bash>
-apt install -y nodejs git npm+apt install -y git
 </code> </code>
  
  
-Créer un utilisateur système ''xbs'' +Créer un utilisateur standard ''xbro'' 
  
 <code bash> <code bash>
-adduser --system --no-create-home --comment "Run xBrowserSync service" xbs+adduser --comment "Run xBrowserSync service" xbro
  
-mkdir /srv/xbrowsersync +install -o xbro -g xbro -m 750 -d /srv/xbrowsersync
-chown xbs: /srv/xbrowsersync/ +
-chmod go-rwx /srv/xbrowsersync/+
  
- +su - xbro
-runuser -u xbs /bin/bash+
 cd /srv/xbrowsersync/ cd /srv/xbrowsersync/
 umask 0077 umask 0077
-export HOME=/srv/xbrowsersync/ 
 git clone https://github.com/xbrowsersync/api.git git clone https://github.com/xbrowsersync/api.git
 +</code>
  
 +La version xBrowserSync 1.1.13 compile correctement avec Node.js 15
  
 +<code bash>
 +# Télécharger et installer nvm :
 +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
 +
 +# au lieu de redémarrer le shell
 +\. "$HOME/.nvm/nvm.sh"
 +
 +# Télécharger et installer Node.js 15 :
 +nvm install 15
 +</code>
 +
 +
 +Pour Vérifiez la version de Node.js :
 +<code bash>
 +node -v # Doit afficher "v15.14.0".
 +
 +npm -v # Doit afficher "7.7.6".
 +</code>
 +
 +Si plusieurs versions de Node.js coexistent dans l'environnement, on définit la v15 par défaut via la commande : 
 +<code bash>
 +nvm install 15
 +nvm alias default v15.14.0
 +</code>
 +
 +
 +<code bash>
 cd api cd api
 npm install npm install
 </code> </code>
  
-Erreur bunyan module absent ;+Les dépendances nécessaire au programme sont installées dans le dossier ''./node_modules''
  
-tester l'exécution du serveur+Vérifier l'installation des dépendances : 
 +<code bash> 
 +npm list 
 +</code>
  
 +Créer le dossier d'enregistrement des logs :
  
-créer un service systemd+<code bash> 
 +# en root 
 +install -o xbro -g root -m 750 -d /var/log/xBrowserSync 
 +</code> 
 + 
 +Pour tester l'application : 
 + 
 +<code bash> 
 +node dist/api.js 
 +</code> 
 + 
 +Arrêter l'exécution avec <key>ctrl</key> + <key>c</key>. Le fichier de trace ''/var/log/xBrowserSync/api.log'' a été créé avec un contenu de la forme : 
 + 
 +<file> 
 +{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"msg":"Service started at http://127.0.0.1:8080/","time":"2026-10-10T08:24:58.553Z","v":0} 
 +{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"req":null,"msg":"Process terminated by SIGINT","time":"2026-10-10T08:25:16.809Z","v":0} 
 +{"name":"xBrowserSync_api","hostname":"xbrowsersync","pid":2052,"level":30,"msg":"Service shutting down","time":"2026-10-10T08:25:16.809Z","v":0} 
 +</file> 
 + 
 +Ici on peut voir que l'application s'exécute par défaut sur la **boucle locale** et utilise le port **8080**. 
 + 
 +A ce stade l'application fonctionne mais pour la rendre accessible il nous faut encore : 
 + 
 +  * Créer un fichier unité systemd de type service pour l'exécuter comme daemon système ; 
 +  * Installer un reverse proxy écoutant sur les ports standards HTTP ou HTTPS et redirigeant le trafic entrant vers l'application. 
 + 
 + 
 + 
 +===== Création du service systemd ===== 
 + 
 +<code bash> 
 +touch /etc/systemd/system/xbrowsersync.service 
 +</code> 
 + 
 +Ci-dessous le contenu du fichier unité ''/etc/systemd/system/xbrowsersync.service'' 
 + 
 +<file txt xbrowsersync.service> 
 +[Unit] 
 +Description=API de synchronisation des favoris xBrowserSync 
 +#Before= 
 +After=mongod.service 
 +ConditionPathExists=/srv/xbrowsersync/api 
 +#ConditionFileIsExecutable= 
 +  
 +[Service] 
 +#Environment= 
 +Type=simple  
 +User=xbro 
 +Group=xbro 
 +WorkingDirectory=/srv/xbrowsersync/api 
 +#ExecStartPre= 
 +ExecStart=node dist/api.js 
 +#ExecStop= 
 +KillSignal=SIGINT 
 +#ExecStopPost= 
 +#RemainAfterExit= 
 +Restart=on-failure 
 +RestartSec=30 
 +  
 +[Install] 
 +WantedBy=multi-user.target 
 +</file> 
 + 
 + 
 +Activer le nouveau service : 
 + 
 +<code bash> 
 +systemctl --system daemon-reload 
 +systemctl enable --now xbrowsersync.service 
 +systemctl status xbrowsersync.service 
 +</code> 
 + 
 + 
 +On peut tester un redémarrage et vérifier que le service s'exécute bien : 
 + 
 +<code bash> 
 +systemclt reboot 
 + 
 +# Après redémarrage et reconnexion en root 
 +systemctl status xbrowsersync.service 
 +</code>
  
 +===== Reverse-proxy via Nginx =====
  
-Activer HTTPS 
  
  
Ligne 79: Ligne 188:
  
   * [[https://github.com/xbrowsersync/api/tree/v1.1.13|GitHub du projet xBrowserSync]]   * [[https://github.com/xbrowsersync/api/tree/v1.1.13|GitHub du projet xBrowserSync]]
 +  * [[https://nodejs.org/fr/download|Installer Node.js (nodejs.org)]]
 +  * [[https://openclassrooms.com/fr/courses/1733551-gerez-votre-serveur-linux-et-ses-services/5236081-mettez-en-place-un-reverse-proxy-avec-nginx|Configurer un reverse-proxy avec Nginx (openclassrooms.com)]]
  
  
  
  
software/applications/xbrowsersync/installation-serveur.1791024319.txt.gz · Dernière modification : 2026/10/03 10:45 de yoann