Tutorial

Comment installer un discours sur Ubuntu 18.04

DockerOpen SourceUbuntu 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 :

Remarque : Discourse nécessite un fichier d'échange si vous utilisez 1 Go de RAM. Bien que le swap soit généralement recommandé pour les systèmes utilisant des disques durs tournants traditionnels, l'utilisation du swap avec des SSD peut causer des problèmes de dégradation du matériel au fil du temps. Pour cette raison, nous ne recommandons pas de permettre l'échange sur DigitalOcean ou tout autre fournisseur qui utilise le stockage SSD. Cela peut avoir un impact sur la fiabilité du matériel sous-jacent pour vous et vos voisins. Par conséquent, nous recommandons un minimum de 2 Go de RAM pour exécuter Discourse sur un droplet DigitalOcean. Reportez-vous à la section Comment ajouter un espace d'échange sur Ubuntu 18.04 pour plus de détails sur l'utilisation de l'échange.

É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.comen 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.

Remarque : Si vous devez modifier ou corriger ces paramètres après le démarrage, modifiez votre fichier /containers/app.yml et lancez l'application de reconstruction ./launcher. Dans le cas contraire, vos modifications ne prendront pas effet. 

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.

congratulations (félicitations)

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.

wizard 

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. 

Page d'accueil

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. 

upgrade (mettre à jour)

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.

Creative Commons License