Comment installer Discourse sur Ubuntu 14.04

Un article de Discourse

introduction

Discourse est une plate-forme de discussion en source ouverte conçue pour la prochaine décennie d’Internet. Nous allons suivre toutes les étapes nécessaires pour faire fonctionner Discourse sur votre Droplet DigitalOcean.

Conditions préalables

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

Ubuntu 14.04 Droplet (64 bits) avec au moins 2 Go de RAM. Si vous avez besoin d’aide pour cette partie, cet tutoriel vous aidera à démarrer. + Discourse recommande 1 Go de RAM pour les petites communautés et 2 Go de RAM pour les grandes communautés. Un fichier d’échange est également nécessaire si vous utilisez 1 Go de RAM. Bien que l’échange soit généralement recommandé pour les systèmes utilisant des disques durs traditionnels, son utilisation avec des disques SSD peut entraîner des problèmes de dégradation du matériel au fil du temps. En raison de cette considération, nous déconseillons d’activer l’échange sur DigitalOcean ou tout autre fournisseur utilisant le stockage SSD. Cela pourrait 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 à Comment ajouter un échange sur Ubuntu 14.04 pour plus de détails sur l’utilisation de swap. + Si vous devez améliorer les performances de votre serveur, nous vous recommandons de mettre à jour votre Droplet. Cela aboutira à de meilleurs résultats en général et réduira la probabilité de contribuer à des problèmes matériels pouvant affecter votre service.
Vous pouvez utiliser une adresse IP comme domaine pour les tests, mais pour un serveur de production, vous devez avoir un domaine qui se résout en votre droplet. Ce tutoriel peut vous aider.
Un utilisateur non root avec des privilèges sudo (Initial Initial Server Setup avec Ubuntu 14.04 explique comment configurer cela. )
Compte gratuit sur Mandrill et get Informations d’authentification SMTP. Il n’est pas inutile de tester au préalable la validité de ces informations d’identité, bien que vous puissiez les utiliser pour la première fois avec Discourse.

Toutes les commandes de ce didacticiel doivent être exécutées en tant qu’utilisateur non root. Si un accès root est requis pour la commande, il sera précédé de + sudo +. https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-14-04 La configuration initiale du serveur avec Ubuntu 14.04] explique comment ajouter des utilisateurs et leur donner un accès immédiat.

Étape 1 - Installez Git

Dans cette section, nous installerons Git pour télécharger les fichiers sources Discourse. Git est un système de gestion de code source et de contrôle de version distribué open source.

Avant de commencer, il est vivement recommandé de vous assurer que votre système est à jour. SSH dans votre Droplet en tant qu’utilisateur root:

ssh sammy@

Exécutez les commandes suivantes sur votre Droplet pour mettre à jour le système:

sudo apt-get update
sudo apt-get upgrade

Une fois cette opération terminée, installez Git en exécutant la commande suivante:

sudo apt-get install git

Étape 2 - Installez Docker

Dans cette section, nous installerons Docker afin que Discourse dispose d’un environnement isolé dans lequel s’exécuter. Docker est un projet open source capable d’emballer, d’expédier et d’exécuter toute application dans un conteneur léger. Pour plus d’informations de base sur Docker, veuillez consulter his tutorial.

Docker fournit un script public pour installer Docker:

wget -qO- https://get.docker.io/ | sh

Vous devez ajouter votre utilisateur non root au groupe + docker + pour pouvoir exécuter un conteneur Docker en tant que cet utilisateur:

sudo usermod -aG docker

Vous devez également vous déconnecter et vous reconnecter en tant qu’utilisateur pour activer le changement:

exit
su - sammy

Étape 3 - Discours de téléchargement

Dans cette section, nous allons télécharger Discourse.

Créez un dossier contenant tous les fichiers liés à Discourse:

sudo mkdir /var/discourse

Clonez le official Discourse Docker Image dans ce dossier:

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

Étape 4 - Configurer le discours

Dans cette section, nous allons configurer vos paramètres initiaux Discourse.

Basculer vers le répertoire:

cd /var/discourse

Copiez le fichier dans le dossier + containers + en tant que + app.yml +:

sudo cp samples/standalone.yml containers/app.yml

Editez la configuration Discourse dans le fichier + app.yml +:

sudo nano containers/app.yml

Le fichier de configuration s’ouvrira dans l’éditeur de texte nano.

Recherchez la section et mettez-la à jour avec les informations personnalisées de votre messagerie, de votre domaine et de votre serveur SMTP, comme indiqué ci-dessous. Les lignes individuelles sont expliquées après le bloc exemple:

app.yml

...
env:
 LANG: en_US.UTF-8
 ## TODO: How many concurrent web requests are supported?
 ## With 2GB we recommend 3-4 workers, with 1GB only 2
 #UNICORN_WORKERS: 3
 ##
 ## TODO: List of comma delimited emails that will be made admin and developer
 ## on initial signup example '[email protected],[email protected]'
 DISCOURSE_DEVELOPER_EMAILS: ''
 ##
 ## TODO: The domain name this Discourse instance will respond to
 DISCOURSE_HOSTNAME: ''
 ##
 ## TODO: The mailserver this Discourse instance will use
 DISCOURSE_SMTP_ADDRESS:          # (mandatory)
 DISCOURSE_SMTP_PORT:                         # (optional)
 DISCOURSE_SMTP_USER_NAME:       # (optional)
 DISCOURSE_SMTP_PASSWORD:                # (optional)
 ##
 ## The CDN address for this Discourse instance (configured to pull)
 #DISCOURSE_CDN_URL: //discourse-cdn.example.com
 ...

Voici les différentes lignes à modifier:

1) * Définir l’adresse e-mail de l’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. Définissez cette adresse électronique dans la ligne. Cette adresse électronique sera définie par défaut par l’administrateur Discourse dès qu’un utilisateur s’enregistrera avec cet email. Vous aurez besoin de cette adresse e-mail ultérieurement lorsque vous configurerez Discourse à partir de son panneau de configuration Web.

DISCOURSE_DEVELOPER_EMAILS: ''

Remplacez par votre email.

La configuration du courrier électronique du développeur est requise pour la création et l’activation de votre compte administrateur initial.

{vide} 2) * Définir le domaine *

Mis à . Cela signifie que vous souhaitez que votre forum Discourse soit disponible à l’adresse. À la place, vous pouvez utiliser une adresse IP si vous n’avez pas encore de domaine pointant vers votre serveur. Un seul domaine (ou IP) peut être répertorié ici.

DISCOURSE_HOSTNAME: ''

Remplacez par votre domaine. Un nom d’hôte est requis pour accéder à votre instance Discourse à partir du Web.

3) * Définir les informations d’identification du courrier *

Nous recommandons Mandrill pour votre serveur de messagerie SMTP. Obtenez vos informations d’identification SMTP auprès de Mandrill.

Entrez vos informations d’identification SMTP dans les lignes pour,, et. (Assurez-vous de supprimer le commentaire * # * du début de ces lignes, si nécessaire.)

DISCOURSE_SMTP_ADDRESS:          # (mandatory)
DISCOURSE_SMTP_PORT:                         # (optional)
DISCOURSE_SMTP_USER_NAME:       # (optional)
DISCOURSE_SMTP_PASSWORD:                # (optional)

Les paramètres SMTP sont nécessaires pour envoyer des messages à partir de votre instance Discourse. par exemple, pour envoyer des emails d’inscription, des emails de réinitialisation de mot de passe, des notifications de réponse, etc.

Vous rencontrez des difficultés pour configurer les informations d’identification du courrier? Voir le discours Email Guide de dépannage.

La configuration des informations d’identification du courrier est obligatoire, sinon vous ne pourrez pas initialiser votre instance de Discourse. Les informations d’identification doivent être correctes, sinon vous ne pourrez pas enregistrer d’utilisateurs (y compris l’utilisateur admin) pour le forum.

4) * Facultatif: Réglage des paramètres de la mémoire (recommandé pour les gouttelettes de 1 Go) *

Également dans la section du fichier de configuration, définissez sur * 128 Mo * et sur * 2 * pour disposer de plus d’espace mémoire.

db_shared_buffers: "128MB"

and

UNICORN_WORKERS: 2

Le réglage de ces paramètres de mémoire optimisera les performances Discourse sur une gouttelette de 1 Go.

NOTE: * Les modifications ci-dessus sont obligatoires et ne doivent pas être omises, sinon vous aurez un forum Discourse cassé.

Enregistrez le fichier + app.yml + et quittez l’éditeur de texte.

Étape 5 - Discours Bootstrap

Dans cette section, nous amorcerons Discourse.

Premièrement, nous devons nous assurer que Docker peut accéder à toutes les ressources extérieures dont il a besoin. Ouvrez le fichier de paramètres Docker + / etc / default / docker:

sudo nano /etc/default/docker

Décommentez la ligne afin que Docker utilise le DNS de Google:

/ etc / default / docker

...

# Use DOCKER_OPTS to modify the daemon startup options.
DOCKER_OPTS="--dns 8.8.8.8 --dns 8.8.4.4"

...

Redémarrez Docker pour appliquer les nouveaux paramètres:

sudo service docker restart

Remarque: * Si vous ne modifiez pas les paramètres DNS de Docker avant d’exécuter la commande bootstrap, vous risquez d’obtenir une erreur du type "fatal: impossible d’accéder" https. : //github.com/SamSaffron/pups.git/ ': Impossible de résoudre l’hôte: github.com ”.

Utilisez maintenant le processus d’amorçage pour créer Discourse et l’initialiser avec tous les paramètres que vous avez configurés dans la section précédente. Cela démarre également le conteneur Docker. Vous devez être dans le répertoire:

cd /var/discourse

Discours Bootstrap:

sudo ./launcher bootstrap app

L’exécution de cette commande prend environ 8 minutes lors de la configuration de votre environnement Discourse. (Au début de ce processus, il vous sera demandé de générer une clé SSH; appuyez sur * Y * pour accepter.)

Une fois le processus d’amorçage terminé, démarrez Discourse:

sudo ./launcher start app

Toutes nos félicitations! Vous avez maintenant votre propre instance Discourse!

Étape 6 - Discours d’accès

Visitez le domaine ou l’adresse IP (que vous avez précédemment définis pour le nom d’hôte Discourse) dans votre navigateur Web pour afficher la page Web par défaut de Discourse.

image: https: //assets.digitalocean.com/articles/Install_Discourse/1.png [discours]

Si vous recevez une erreur 502 Bad Gateway, attendez une minute ou deux, puis rafraîchissez-vous pour que Discourse puisse terminer son démarrage.

Étape 7 - Inscrivez-vous et créez un compte administrateur

Utilisez le bouton * Inscription * en haut à droite de la page pour créer un nouveau compte Discourse. Vous devez utiliser l’adresse e-mail que vous avez fournie précédemment. Une fois que vous confirmez votre compte, ce compte se verra automatiquement attribuer des privilèges d’administrateur.

image: https: //assets.digitalocean.com/articles/Install_Discourse/2.png [sign_up]

Une fois que vous vous êtes connecté et connecté, vous devriez voir les rubriques Personnel et le Admin Guide de démarrage rapide. Il contient les étapes suivantes pour la configuration et la personnalisation ultérieures de votre installation Discourse.

Vous pouvez accéder au tableau de bord de l’administrateur en visitant.

image: https: //assets.digitalocean.com/articles/Install_Discourse/3.png [tiret]

Si vous ne recevez pas de courrier électronique lors de votre inscription et que vous ne parvenez pas à vous connecter à un nouveau compte administrateur, veuillez consulter la page Discourse https://meta.discourse.org/t/troubleshooting-email-on-a-new-discourse- install / 16326 [liste de contrôle de dépannage par courrier électronique].

Si vous ne parvenez toujours pas à enregistrer un nouveau compte administrateur par courrier électronique, consultez la procédure pas à pas https://meta.discourse.org/t/create-admin-account-from-console/17274[Create Admin Account depuis la console, mais notez que vous aurez un site endommagé jusqu’à ce que le courrier électronique SMTP fonctionne normalement.

C’est ça! Vous pouvez maintenant laisser les utilisateurs s’inscrire et commencer à gérer votre forum Discourse.

Mise à niveau post-installation

Pour * mettre à niveau Discourse vers la dernière version *, visitez + / admin / upgrade + et suivez les instructions.

image: https: //assets.digitalocean.com/articles/Install_Discourse/4.png [mise à niveau]

TOC