Comment installer Discourse sur Ubuntu 16.04

Un article de Discourse

introduction

Discourse est une plate-forme de discussion à code source ouvert. Il peut être utilisé comme une liste de diffusion, un forum de discussion ou un forum de discussion long. Dans ce didacticiel, nous installerons Discourse dans un environnement isolé en utilisant Docker , une application de conteneurisation.

Conditions préalables

Avant de commencer, il y a quelques choses que nous devons d’abord configurer:

Étape 1 - Téléchargement du discours

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

Vous devrez être * root * tout au long du processus de configuration et d’amorçage. Commencez par basculer vers un shell root.

sudo -s

Ensuite, créez le répertoire + / var / discourse +, où tous les fichiers liés à Discourse résideront.

mkdir /var/discourse

Pour finir, clonez le official Discourse Docker Image dans + / var / discourse +.

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

Avec les fichiers dont nous avons besoin, nous pouvons passer à la configuration et à l’amorçage.

Étape 2 - Configuration et démarrage du discours

Déplacez-vous dans le répertoire + / var / discourse +, où se trouvent les fichiers Discourse.

cd /var/discourse

À partir de là, vous pouvez lancer le script de configuration inclus.

./discourse-setup

On vous posera les questions suivantes:

  • * Nom d’hôte pour votre discours? *

Entrez le nom d’hôte que vous souhaitez utiliser pour Discourse, par exemple + discourse. +, en remplaçant ++ par 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 email du compte administrateur? *

Choisissez l’adresse de messagerie que vous souhaitez utiliser pour le compte administrateur Discourse. Cela peut être totalement indépendant de votre domaine Discourse et n’importe quelle adresse e-mail que vous jugez commode.

Notez que cette adresse électronique deviendra l’administrateur Discourse par défaut lorsque le premier utilisateur s’enregistrera avec cet email. Vous aurez également besoin de cette adresse e-mail ultérieurement lorsque vous configurerez Discourse à partir de son panneau de configuration Web.

  • * Adresse du serveur SMTP? *

  • * Nom d’utilisateur SMTP? *

  • * Port SMTP? *

  • * Mot de passe SMTP? *

Entrez les détails de votre serveur SMTP pour ces questions. Si vous utilisez SparkPost, l’adresse du serveur SMTP sera + smtp.sparkpostmail.com +, le nom d’utilisateur sera * SMTP_Injection *, le port sera + 587 + et le mot de passe sera le https: / /support.sparkpost.com/customer/en/portal/articles/1933377-create-api-keys[API key].

Enfin, il vous sera demandé de confirmer tous les paramètres que vous venez de saisir. 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 démarre.

L’amorçage prend entre 2 et 8 minutes, après quoi votre instance sera en cours d’exécution! Passons maintenant à la création d’un compte administrateur.

Étape 3 - Enregistrement d’un compte administrateur

Visitez votre domaine Discourse dans votre navigateur Web préféré pour afficher la page Web Discourse.

image: http: //i.imgur.com/nmRKhNB.png [félicitations]

Si vous recevez une erreur 502 Bad Gateway, attendez une minute ou deux avant d’actualiser. Le discours n’a peut-être pas encore commencé.

Lorsque la page est chargée, cliquez sur le bouton bleu * Enregistrer *. Vous verrez un formulaire intitulé * Enregistrer un compte administrateur * avec les champs suivants:

  • * Email *: Choisissez l’adresse email que vous avez fournie précédemment dans le menu déroulant.

  • * Nom d’utilisateur *: Choisissez un nom d’utilisateur.

  • * Mot de passe *: Choisissez un mot de passe fort.

Cliquez ensuite sur le bouton bleu * Enregistrer * du formulaire pour le soumettre. Vous verrez une boîte de dialogue qui dit * Confirmez votre courriel *. Vérifiez votre boîte de réception pour l’email de confirmation. Si vous ne l’avez pas reçu, essayez de cliquer sur le bouton * Renvoyer l’e-mail d’activation *. Si vous ne parvenez toujours pas à enregistrer un nouveau compte administrateur, veuillez consulter la liste de contrôle de dépannage Discourse email.

Après avoir enregistré votre compte administrateur, l’assistant d’installation s’ouvre et vous guide dans la configuration de base de Discourse. Vous pouvez le parcourir maintenant ou cliquer sur * Peut-être plus tard * pour l’ignorer.

image: http: //i.imgur.com/U8lBkkf.png [assistant]

Après avoir terminé ou ignoré l’assistant d’installation, vous verrez certaines rubriques et le guide de démarrage Admin ( étiqueté * READ ME FIRST *), qui contient des conseils pour personnaliser davantage votre installation Discourse.

image: http: //i.imgur.com/6n8CGqb.png [page d’accueil]

Vous êtes tous ensemble! Si vous avez besoin de mettre à jour Discourse ultérieurement, vous pouvez le faire depuis la ligne de commande en récupérant la dernière version du code dans le dépôt Git et en rebellissant l’application, comme ceci:

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

Vous pouvez également le mettre à jour dans votre navigateur en visitant + http: // discours. / Admin / upgrade +, en cliquant sur * Mettre à niveau vers la dernière version * et en suivant les instructions.

image: http: //i.imgur.com/qX5cnoX.png [mise à niveau]

Conclusion

Vous pouvez maintenant commencer à gérer votre forum Discourse et permettre aux utilisateurs de s’inscrire. En savoir plus sur les fonctionnalités de Discourse à la page the Discourse About.