Installer Etherpad sur son hébergement Cloud Web
Installez l'éditeur de texte Etherpad sur votre hébergement Cloud Web et rendez-le accessible avec votre nom de domaine
Dernière mise à jour le 04/05/2022
Objective
Etherpad est un éditeur de texte en ligne collaboratif en temps réel. Il permet à plusieurs personnes d'écrire simultanément des fichiers texte via une interface web. Etherpad est écrit en JavaScript et utilise Node.js, une plateforme logicielle permettant de créer vos sites et API en JavaScript côté serveur.
L'hébergement Cloud Web OVHcloud vous permet d'utiliser Node.js comme moteur d'exécution pour vos sites web, et donc d'y installer Etherpad ou toute autre application conçue pour Node.js.
Dans ce tutoriel, nous allons installer un serveur Etherpad sur un hébergement Cloud Web OVHcloud et le mettre à disposition derrière votre nom de domaine.
Prérequis
- Disposer d'un hébergement Cloud Web OVHcloud.
- Avoir activé Node.js comme moteur d'exécution.
- Avoir ajouté le nom de domaine concerné en tant que multisite et avoir défini Node.js comme étant son moteur d'exécution.
- Être connecté à votre espace client OVHcloud, partie
Web Cloud. - Ce que vous devez savoir:
- Les bases de l'écosystème Node.js.
- Se connecter en SSH.
En pratique
Étape 1 : activer Node.js comme moteur d'exécution
Pour accéder aux moteurs d'exécution de votre hébergement Cloud Web, connectez-vous à votre espace client OVHcloud. Cliquez sur Hébergements dans la barre de services à gauche, puis choisissez le nom de l'hébergement Cloud Web concerné. Positionnez-vous enfin sur l'onglet Moteurs d'exécution.
Le tableau qui apparaît affiche les moteurs d’exécution ajoutés actuellement. Assurez-vous alors que le moteur d'exécution Node.js est bien activé. Si tel est le cas, poursuivez vers l'étape 2 « Associer Node.js à un multisite ».
Si ce n'est pas le cas, ajoutez-en un nouveau, si votre offre vous le permet, ou modifiez le moteur d'exécution existant.
- Si vous souhaitez ajouter un moteur : cliquez sur
Actionsau-dessus du tableau, puis surAjouter un moteur d'exécution. - Si vous souhaitez modifier un moteur : cliquez sur le bouton
...à droite du moteur concerné, puis surModifier.
Dans la fenêtre qui s'affiche, complétez les informations demandées avec les valeurs suivantes de notre exemple ou adaptez-les à votre situation personnelle :
| Information | Valeur à renseigner |
|---|---|
| Nom personnalisé | NodeJS 8 |
| Moteur d'exécution | nodejs-8 |
| Chemin d'accès au répertoire public | public |
| Environnement de l'application | production |
| Script de lancement de l'application | server.js |
Une fois les informations complétées, cliquez sur Valider. Si vous souhaitez obtenir plus d'informations sur la gestion des moteurs d'exécution, reportez-vous à notre guide « Gérer les moteurs d’exécution de Cloud Web ».
Étape 2 : associer Node.js à un multisite
Maintenant que Node.js est activé en tant que moteur d'exécution, vous devez l'associer à l'un de vos multisites. Pour cela, positionnez-vous sur l'onglet Multisite. Le tableau qui s’affiche contient tous les noms de domaine qui ont été ajoutés en tant que multisite. Deux colonnes doivent retenir votre attention.
| Colonne | Description |
|---|---|
| Dossier racine | Il s'agit du dossier racine qui devra contenir le code source du domaine concerné et correspond au « DocumentRoot ». Dans notre exemple, nous choisissons de spécifier « etherpad ». Celui-ci devra donc contenir notre code source Node.js. |
| Moteur d'exécution | Il s'agit du moteur d'exécution associé au nom de domaine concerné. Le nom qui s’affiche correspond au « Nom personnalisé » que vous avez défini lors de la création du moteur d'exécution. Dans notre exemple, vous devriez retrouver « NodeJS 8 ». |
Dans le tableau, vérifiez que le moteur d'exécution Node.js est bien lié aux domaines concernés et que le dossier racine est correct. Si tel est le cas, poursuivez vers l'étape 3 « Se connecter à votre Cloud Web via SSH ».
Si ce n'est pas le cas, ajoutez un nouveau multisite ou modifiez celui existant.
- Si vous souhaitez ajouter un multisite : cliquez sur
Ajouter un domaine ou sous-domaineà droite du tableau. - Si vous souhaitez modifier un multisite : cliquez sur le bouton
...à droite du domaine concerné, puis surModifier.
Dans la fenêtre qui s'affiche, complétez les informations demandées selon votre situation personnelle. Voici celles que nous avons utilisées pour ce tutoriel :
| Information | Valeur utilisée en exemple pour ce tutoriel |
|---|---|
| Nom de domaine | etherpad.demo-nodejs.ovh |
| Dossier racine | etherpad |
| Moteur d'exécution | NodeJS 8 |
En ce qui concerne les options supplémentaires, choisissez celles que vous souhaitez activer. Une fois les informations complétées, cliquez sur Suivant, puis finalisez la manipulation. Cet ajout peut prendre jusqu’à une heure. Cependant, la modification de la configuration DNS peut prendre jusqu'à 24 heures avant d’être pleinement effective. Si vous souhaitez obtenir plus d'informations sur la gestion des multisites, reportez-vous à notre guide « Partager son hébergement entre plusieurs sites ».
Étape 3 : se connecter à votre Cloud Web via SSH
Commencez en récupérant les informations vous permettant de vous connecter. Pour cela, positionnez-vous sur l'onglet FTP - SSH. Si celui-ci n'apparaît pas dans la liste, appuyez au préalable sur le bouton représentant trois barres. Les informations liées à votre espace de stockage apparaissent alors. Repérez celles mentionnées à côté des éléments suivants :
| Éléments | Description |
|---|---|
| Accès SSH au cluster | L'élément qui apparaît vous permet de récupérer deux informations : - l'adresse de serveur : elle débute après « ssh:// » et se termine avant les « : » ; - le port de connexion : le numéro est mentionné après les « : ». On pourrait par exemple retrouver : ssh:// sshcloud.cluster024.hosting.ovh.net:12345/, donc « sshcloud.cluster024.hosting.ovh.net » en adresse de serveur et « 12345 » en port de connexion. |
| Login SSH principal | Il s'agit de l'identifiant SSH principal créé sur votre hébergement. |
Si vous ne connaissez plus le mot de passe de l'utilisateur SSH, cliquez sur le bouton ... à droite de l'utilisateur concerné dans le tableau, puis sur Changer le mot de passe.
À présent, pour vous connecter en SSH, vous devez utiliser un terminal. Cet outil est installé par défaut sur macOS ou Linux. Un environnement Windows nécessitera l’installation d’un logiciel comme PuTTY ou l’ajout de la fonctionnalité « OpenSSH ». Cette démarche étant spécifique au système d’exploitation que vous utilisez, nous ne pouvons pas la détailler dans cette documentation.
Voici l'exemple d'une ligne de commande que vous pouvez utiliser. Remplacez les éléments « sshlogin », « sshserver » et « connectionport » par ceux adaptés à votre situation personnelle. Une fois la commande envoyée, vous serez invité à renseigner le mot de passe de l’utilisateur SSH.
ssh sshlogin@sshserver -p connectionport
Étape 4 : installer Etherpad
Commencez en vous plaçant dans le dossier racine que vous avez spécifié lors de l'étape 2. Dans notre tutoriel, il s'agit du répertoire « etherpad ». Vous pourrez alors y récupérer le code de l'application.
demonon@cloudweb-ssh:~ $ cd etherpad/
demonon@cloudweb-ssh:~/etherpad $ git init
demonon@cloudweb-ssh:~/etherpad $ git remote add origin https://github.com/ether/etherpad-lite.git
demonon@cloudweb-ssh:~/etherpad $ git pull origin master
remote: Enumerating objects: 29763, done.
remote: Total 29763 (delta 0), reused 0 (delta 0), pack-reused 29763
Receiving objects: 100% (29763/29763), 9.80 MiB | 6.34 MiB/s, done.
Resolving deltas: 100% (21100/21100), done.
From https://github.com/ether/etherpad-lite
* branch master -> FETCH_HEAD
* [new branch] master -> origin/master
Installez alors les dépendances d'Etherpad :
demonon@cloudweb-ssh:~/etherpad [master]$ export PATH=$PATH:/usr/local/nodejs8/bin
demonon@cloudweb-ssh:~/etherpad [master]$ bash bin/installDeps.sh
Copy the settings template to settings.json...
Ensure that all dependencies are up to date... If this is the first time you have run Etherpad please be patient.
...
> wd@1.10.3 install /home/demonon/etherpad/src/node_modules/wd
> node scripts/build-browser-scripts
added 1094 packages in 34.97s
Ensure jQuery is downloaded and up to date...
Clearing minified cache...
Ensure custom css/js files are created...
Pour Etherpad, l'installation des dépendances est effectuée par un script Bash. De manière générale, pour les applications Node.js, l'installation de ces dépendances se fera via la commande « npm-node8 install ».
La configuration réalisée en Node.js s'attend à trouver un fichier « server.js » dans le dossier racine de votre multisite (que vous avez paramétré lors de l'étape 1). Nous allons alors créer un lien symbolique permettant de faire pointer « server.js » vers le fichier du même nom d'Eteherpad.
demonon@cloudweb-ssh:~/etherpad [master]$ ln -fs node_modules/ep_etherpad-lite/node/server.js server.js
Étape 5 : redémarrer le daemon Node.js
Pour redémarrer le daemon Node.js, retournez sur votre espace client OVHcloud. Positionnez-vous sur l'onglet Multisite, cliquez à droite du nom de domaine concerné sur le bouton ... à droite, puis sur Redémarrer
Une fois ceci fait, l'application sera accessible via le nom de domaine choisi dans la configuration de votre multisite.
Conclusion
Nous avons vu comment installer une application Node.js sur un hébergement Cloud Web en respectant les différentes étapes. Il ne vous reste plus qu'à utiliser Etherpad et à collaborer tous ensemble !
Aller plus loin
Installer son site avec les modules en 1 clic
Partager son hébergement entre plusieurs sites
Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com
Cette documentation vous a-t-elle été utile ?
N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..