Comment installer un discours sur Ubuntu 18.04

Un article de Discours

Introduction

Discourse est une plate-forme de discussion à code source ouvert. Elle peut être utilisée comme une liste de diffusion, un forum de discussion ou un salon de discussion. Dans ce tutoriel, nous allons installer Discourse dans un environnement isolé en utilisant Docker, une application de conteneurisation.

Conditions préalables

Avant de commencer, il y a plusieurs choses que nous devons mettre en place :

• Un serveur Ubuntu 18.04 avec au moins 2 Go de RAM, configuré en suivant ce tutoriel Configuration initiale du serveur sur Ubuntu 18.04, comprenant un utilisateur sudo non root et un pare-feu.
• Docker a été installé sur votre serveur, ce que vous pouvez faire en suivant Étape 1 du tutoriel d’installation du Docker pour Ubuntu 18.04.
• Un nom de domaine qui se résout à votre serveur, que vous pouvez configurer en suivant ce tutoriel sur les noms d’hôtes.
• Un serveur de messagerie SMTP. Si vous ne voulez pas gérer votre propre serveur de messagerie, vous pouvez utiliser un autre service, comme un compte gratuit sur Mailgun.

Étape 1 - Téléchargement du discours

Une fois toutes les conditions préalables remplies, vous pouvez passer directement à l’installation de Discourse.

Vous devrez être en root pour le reste de la configuration et le processus d’amorçage, donc d’abord, passez en root shell.

sudo -s

Ensuite, créez le registre /var/discourse où se trouvent tous les fichiers relatifs à Discourse.

mkdir /var/discourse

Enfin, clonez l’image officielle du Docker de Discourse dans /var/discourse.

git clone https://github.com/discourse/discourse_docker.git /var/discourse

Avec les fichiers dont nous avons besoin en place, nous pouvons passer à la configuration et au bootstrapping.

Étape 2 - Configurer et amorcer Discourse

Aller au registre /var/discourse se trouvent les fichiers Discourse.

cd /var/discourse

D’ici, vous pouvez lancer le script d’installation inclus.

./discourse-setup

Les questions suivantes vous seront posées :

• Hostname (Nom d’hôte) pour votre Discours ?

Entrez le nom d’hôte que vous souhaitez utiliser pour Discourse, par exemple discourse.your_domain.com``en remplacement de your_domain.com avec votre nom de domaine. Vous devez utiliser un nom de domaine, car une adresse IP ne fonctionnera pas lors de l’envoi d’un courrier électronique.

• Adresse électronique pour le compte admin ?

Choisissez l’adresse électronique que vous souhaitez utiliser pour le compte d’administration de Discourse. Il peut être totalement indépendant de votre domaine de discours et peut être n’importe quelle adresse électronique que vous trouvez pratique.

Notez que cette adresse électronique deviendra l’administrateur de Discourse par défaut lorsque le premier utilisateur s’inscrira avec ce courriel. Vous aurez également besoin de cette adresse électronique plus tard, lorsque vous configurerez Discourse à partir de son panneau de contrôle web.

• Adresse du serveur SSMTP ?

• Nom d’utilisateur SSMTP ?

• SSMTP port ?

• Mot de passe SSMTP ?

Entrez les détails de votre serveur SMTP pour ces questions. Si vous utilisez Mailgun, l’adresse du serveur SMTP sera smtp.mailgun.org, le nom d’utilisateur et le mot de passe sont des références SMTP pour votre domaine sous l’onglet domains (domaines).

Enfin, il vous sera demandé de confirmer tous les paramètres que vous venez d’entrer. Après avoir confirmé vos paramètres, le script génère un fichier de configuration appelé app.yml, puis le processus d’amorçage (bootstrap) démarre.

Le bootstrapping prend entre 2 et 8 minutes, après quoi votre instance sera lancée ! Passons maintenant à la création d’un compte d’administrateur.

Étape 3 - Enregistrement d’un compte administratif

Visitez votre domaine de Discours dans votre navigateur web préféré pour voir la page web de Discourse.

Si vous recevez une erreur 502 Bad Gateway, essayez d’attendre une minute ou deux puis rafraîchissez la page ; il se peut que le discours n’ait pas encore fini de commencer.

Lorsque la page se charge, cliquez sur le bouton bleu d’enregistrement. Vous verrez un formulaire intitulé Register Admin Account (Enregistrer le compte administrateur) avec les champs suivants :

• Email (Courriel) : Choisissez l’adresse électronique que vous avez fournie précédemment dans le menu déroulant.
• Username (Nom d’utilisateur): Choisissez un nom d’utilisateur.
• Password (Mot de passe): Choisissez un mot de passe fort.

Cliquez ensuite sur le bouton bleu Register (S’inscrire) sur le formulaire pour le soumettre. Vous verrez un dialogue qui dit Confirm your email (Confirmez votre adresse électronique). Vérifiez votre boîte de réception pour le courriel de confirmation. Si vous ne l’avez pas reçu, essayez de cliquer sur le boutonResend Activation Email (Renvoyer le courriel d’activation). Si vous ne parvenez toujours pas à créer un nouveau compte d’administration, veuillez consulter la liste de contrôle de dépannage des courriels de Discourse.

Après l’enregistrement de votre compte d’administrateur, l’assistant d’installation se lance et vous guide dans la configuration de base de Discourse. Vous pouvez le parcourir maintenant ou cliquer sur Maybe Later (Peut-être plus tard) pour le sauter.

Après avoir terminé ou sauté l’assistant d’installation, vous verrez quelques sujets et le guide de démarrage rapide de l’administrateur (intitulé READ ME FIRST - LISEZ-MOI D’ABORD), qui contient des conseils pour personnaliser davantage votre installation de Discourse.

Vous êtes prêt ! Si vous avez besoin de mettre à jour Discourse à l’avenir, vous pouvez le faire à partir de la ligne de commande en extrayant la dernière version du code du Git repo et en relançant l’application, comme ceci :

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

Vous pouvez également le mettre à jour dans votre navigateur en visitant http://discourse.your_domain.com/admin/upgrade, en cliquant sur Upgrade to the Latest Version(Mettre à jour vers la dernière version), et en suivant les instructions.

Conclusion

Vous pouvez maintenant commencer à gérer votre forum Discourse et laisser les utilisateurs s’y inscrire. Pour en savoir plus sur les fonctionnalités de Discourse, consultez la page À propos de Discourse.