Installer un plugin Discourse

Se connecter au serveur

Utilisez l’application Terminal sur MAC ou le logiciel Putty sur Windows pour vous connecter à votre serveur avec l’adresse IP de celui-ci, votre identifiant root et mot de passe.

• MAC : entrez la commande ssh [email protected] (remplacez 00.00.00.00 par l’ip de votre serveur) puis entrez le mot de passe quand il vous le sera demandé
• PC : exécutez putty.exe, dans Host Name (or IP Address) inscrivez l’ip de votre serveur et dans Connection type : SSH, cliquez ensuite sur Open. Un terminal s’ouvrira, entrez d’abord votre pseudo root puis le mot de passe.

Ajouter son plugin à la configuration de Discourse

Une fois connecté à votre serveur, entrez les commandes suivantes :

cd /var/discourse
nano containers/app.yml

Le fichier de configuration de Discourse s’ouvre alors, il fait généralement une centaine de lignes. autour de la ligne 80 vous aurez le code suivant :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git

Juste après la ligne mentionnant docker_manager.git, ajoutez une ligne similaire puis le lien de votre plugin. Par exemple, pour installer la Discourse Formatting Toolbar il vous faudra ajouter le code :

          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git

Ce qui donne au final :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git

Vous pouvez ajouter plusieurs plugins de cette façon, comme ceci :

## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/iunctis/discourse-formatting-toolbar.git
          - git clone https://github.com/discourse/discourse-spoiler-alert.git
          - git clone https://github.com/iunctis/discourse-affiliate.git

Sauvegardez les modifications en suivant les instructions de nano (sur windows il faut faire CTRL+X puis Y et Entrée). Le plugin est ajouté à la configuration, il reste une étape à franchir : mettre à jour Discourse.

Mettre à jour Discourse

Connectez-vous à votre serveur et entrez les commandes suivantes :

cd /var/discourse
git pull
./launcher rebuild app

Discourse va alors se “reconstruire”, cette étape peut prendre de 5 à 15 minutes, votre forum Discourse sera inaccessible durant cette mise à jour.

Quand vous pouvez à nouveau taper une commande, vous pouvez lancer un petit nettoyage avec la commande :

./launcher cleanup app

Puis quitter le terminal. Votre forum sera à nouveau disponible et le plugin sera ajouté à Discourse !

Vous rencontrez un problème ?

• Sur certaines versions d’Ubuntu fournies avec votre serveur, l’éditeur de texte nano n’est pas installé par défaut, vous pouvez l’installer simplement en vous connectant à votre serveur : sudo apt-get install nano
• Si vous rencontrez une erreur FAILED TO BOOTSTRAP durant la mise à jour de Discourse, Il peut y avoir plusieurs causes :
  • Une erreur de syntaxe dans le fichier de configuration de Discourse, copiez/collez le contenu du fichier app.yml dans ce YALM Validator : http://codebeautify.org/yaml-validator. Ce site vous indiquera si vous avez commis une erreur.
  • Il est aussi possible que le plugin soit en cause. Êtes-vous sûrs qu’il est compatible avec votre version de Discourse ? Demandez conseil à l’auteur du plugin.
• L’installation semble s’être bien déroulée mais votre forum a un comportement anormal ? Essayez le mode sans échec (safe-mode) de Discourse : http://adresse-de-votre-forum/safe-mode (voir guide : Le Safe Mode, pour trouver la source d’un problème)

Besoin d’aide ?

Si vous avez besoin d’une assistance pour l’installation d’un plugin, vous pouvez me contacter par email à [email protected].

(image de présentation : freepik.com – modifiée)