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/05 05:28] – 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
Ligne 63: Ligne 88:
 Les dépendances nécessaire au programme sont installées dans le dossier ''./node_modules'' Les dépendances nécessaire au programme sont installées dans le dossier ''./node_modules''
  
-Tester l'application :+Vérifier l'installation des dépendances : 
 +<code bash> 
 +npm list 
 +</code> 
 + 
 +Créer le dossier d'enregistrement des logs : 
 + 
 +<code bash> 
 +# en root 
 +install -o xbro -g root -m 750 -d /var/log/xBrowserSync 
 +</code> 
 + 
 +Pour tester l'application : 
 <code bash> <code bash>
 node dist/api.js node dist/api.js
 </code> </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 =====
  
-Erreur bunyan module absent ; 
 <code bash> <code bash>
-npm install bunyan+touch /etc/systemd/system/xbrowsersync.service
 </code> </code>
  
-Erreur persiste.+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>
  
-tester l'exécution du serveur 
  
 +Activer le nouveau service :
  
-créer un service systemd+<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 93: 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.1791178111.txt.gz · Dernière modification : 2026/10/05 05:28 de yoann