bcarlin.net/content/blog/006-discourse-without-docker/index.fr.md at 970f121e119a6a0a09f870e941a3409fb5a83613

bcarlin/bcarlin.net

Fork 0

Bruno Carlin b47b193b20

feat: translate the site in french

2025-06-29 02:56:15 +02:00

10 KiB

Raw Blame History

title

slug

date

Installation

Discourse est une application Rails. Elle peut être installée comme n'importe quelle autre application Rails :

Tout d'abord, Discourse utilise Redis et PostgreSQL (ou du moins, je préfère utiliser Postgres). J'utilise également Nginx comme proxy pour l'application. Installez les dépendances externes :

# Ajoutez le dépôt pour Redis
echo "deb http://packages.dotdeb.org jessie all" > /etc/apt/sources.list.d/dotdeb.list
wget https://www.dotdeb.org/dotdeb.gpg -O - | apt-key add -

# Ajoutez le dépôt pour PostgreSQL :
echo "deb http://apt.postgresql.org/pub/repos/apt/ jessie-pgdg main" > /etc/apt/sources.list.d/postgresql.list
wget -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

apt-get update
apt-get install postgresql-9.5 redis-server nginx

Ensuite, créez une base de données pour l'application. Entrez dans l'interface de commande de postgres :

su - postgres -c psql

et entrez les commandes suivantes :

CREATE DATABASE discourse;
CREATE USER discourse;
ALTER USER discourse WITH ENCRYPTED PASSWORD 'password';
ALTER DATABASE discourse OWNER TO discourse;
\connect discourse
CREATE EXTENSION hstore;
CREATE EXTENSION pg_trgm;

Ensuite, vous pouvez cloner le code de Discourse :

git clone https://github.com/discourse/discourse.git /chemin/vers/discourse
# 
# Optionnellement, basculez sur une étiquette spécifique
cd /chemin/vers/discourse
git checkout v1.5.3

Ensuite, allez dans le répertoire principal de l'application, et configurez-la comme n'importe quelle application Rails :

# Optionnellement, configurez rvm avec ruby 1.9.3 minimum (j'utilise 2.3.0)
rvm install 2.3.0
rvm use 2.3.0

# installez les dépendances
cd /chemin/vers/discourse
RAILS_ENV=production bundle install

Il est temps de configurer l'application.

Ici, Discourse a une petite particularité : la configuration de production se trouve dans le fichier ./config/discourse.conf.

Créez ce fichier :

cp config/discourse_defaults.conf config/discourse.conf

Et modifiez-le avec votre configuration. Les principales zones d'intérêt sont la configuration pour la base de données et pour le serveur de messagerie :

# adresse hôte pour le serveur de base de données
# Ceci est défini à vide pour qu'il essaie d'utiliser les sockets en premier
db_host = localhost

# port du serveur de base de données, pas besoin de le définir
db_port = 5432

# nom de la base de données exécutant discourse
db_name = discourse

# nom d'utilisateur accédant à la base de données
db_username = discourse

# mot de passe utilisé pour accéder à la base de données
db_password = password

et pour le serveur SMTP (dans cet exemple, nous utilisons Gmail) :

# adresse du serveur smtp utilisé pour envoyer des emails
smtp_address = smtp.gmail.com

# port du serveur smtp utilisé pour envoyer des emails
smtp_port = 587

# domaine passé au serveur smtp
smtp_domain = gmail.com

# nom d'utilisateur pour le serveur smtp
smtp_user_name = votre-adresse@gmail.com

# mot de passe pour le serveur smtp
smtp_password = password

# mécanisme d'authentification smtp
smtp_authentication = plain

# activer le chiffrement TLS pour les connexions smtp
smtp_enable_start_tls = true

Maintenant, nous pouvons préparer Discourse pour la production :

RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile

Il est temps de démarrer l'application. J'utilise généralement Puma pour déployer les applications Rails.

Créez le fichier config/puma.rb dans le répertoire de Discourse. Le contenu suivant devrait suffire (pour plus d'informations, voir [la documentation de Puma]) :

#!/usr/bin/env puma

application_path = '/home/discuss.waarp.org/discourse'
directory application_path
environment 'production'
daemonize false
pidfile "#{application_path}/tmp/pids/puma.pid"
state_path "#{application_path}/tmp/pids/puma.state"
bind "unix://#{application_path}/tmp/sockets/puma.socket"

À partir de là, l'application peut être exécutée avec la commande suivante :

bundle exec puma -C config/puma.rb

Enfin, configurez Nginx pour transférer les requêtes à Discourse. Créez le fichier /etc/nginx/conf.d/discourse.conf avec le contenu suivant :

upstream discourse {
    server unix:/chemin/vers/discourse/tmp/sockets/puma.socket;
}

server {
    listen 80;
    server_name example.com;
    
    location / {
        try_files $uri @proxy;
    }
    
    location @proxy {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://discourse;
    }
}

Votre forum avec Discourse est configuré !

Gestion des services

Selon vos habitudes de travail, vous pouvez ajouter des unités systemd pour exécuter Discourse.

Il nécessite au moins deux service :

Sidekiq, qui est utilisé pour traiter les tâches de fond asynchrones
Rails, pour Discourse lui-même.

Avec les services configurés, les services peuvent être démarrés/arrêtés/activés avec les commandes systemctl.

Mais avant cela, si vous utilisez RVM, vous devez créer un wrapper pour l'environnement (ruby local, et gemset optionnel) utilisé par Discourse :

rvm wrapper 2.3.0 systemd bundle

Cela crée un exécutable dans $rvm_bin_path que vous pouvez appeler à la place de bundle, et qui chargera automatiquement le bon environnement.

Sidekiq

Tout d'abord, créez une configuration pour Sidekiq. Créez le fichier config/sidekiq.yml dans votre projet Discourse avec le contenu suivant (pour plus d'informations, voir [la documentation de Sidekiq]) :

---
:concurrency: 5
:pidfile: tmp/pids/sidekiq.pid
staging:
  :concurrency: 10
production:
  :concurrency: 20
:queues:
  - default
  - critical
  - low

Ensuite, créez l'unité de service pour Sidekiq. Créez le fichier /etc/systemd/system/discourse-sidekiq.service avec le contenu suivant :

[Unit]
Description=service sidekiq de discourse
After=multi-user.target

[Service]
WorkingDirectory=/chemin/vers/discourse
Environment=RAILS_ENV=production
ExecStart=/chemin/vers/rvm/.rvm/bin/systemd_bundle exec sidekiq -C config/sidekiq.yml
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Discourse

Pour Discourse, créez simplement l'unité de service pour Puma. Créez le fichier /etc/systemd/system/discourse.service avec le contenu suivant :

[Unit]
Description=service discourse
After=discourse-sidekiq.service
Requires=discourse-sidekiq.service

[Service]
WorkingDirectory=/chemin/vers/discourse
Environment=RAILS_ENV=production
ExecStart=/chemin/vers/rvm/.rvm/bin/systemd_bundle exec puma -C config/puma.rb
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Mises à jour

Les mises à jour sont encore plus faciles :

Lisez d'abord les notes de version. Faites ensuite des sauvegardes du code et de la base de données. Maintenant, vous pouvez basculer vers la nouvelle version :

cd /chemin/vers/discourse
git checkout vX.X.X

Installez les nouvelles dépendances, exécutez les migrations et reconstruisez les assets :

RAILS_ENV=production bundle install
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile

Redémarrez Discourse :

systemctl restart discourse

Que peut-il mal se passer ? Si je ne donne aucune solution ici, c'est toujours récupérable (d'où les sauvegardes !).

La migration de la base de données a échoué (restaurez la base de données avec votre sauvegarde, corrigez le problème et réessayez !)
Les plugins ne sont pas compatibles avec la dernière version (revenez à la solution précédente fonctionnelle et attendez qu'ils soient compatibles)

Plugins

Les plugins Discourse peuvent être gérés de la même manière.

Installation de plugins

Installez le plugin avec l'URL de son dépôt :

cd /chemin/vers/discourse
RAILS_ENV=production bundle exec rake plugin:install[URL]

Installez les nouvelles dépendances, exécutez les migrations et reconstruisez les assets :

RAILS_ENV=production bundle install
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile

Redémarrez Discourse :

systemctl restart discourse

Mise à jour

Pour mettre à jour un plugin spécifique, utilisez la commande suivante :

RAILS_ENV=production bundle exec rake plugin:update[ID]

Vous pouvez également mettre à jour tous les plugins en une seule fois avec la commande :

RAILS_ENV=production bundle exec rake plugin:update_all

Ensuite, installez les nouvelles dépendances, exécutez les migrations et reconstruisez les assets :

RAILS_ENV=production bundle install
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile

et redémarrez Discourse :

systemctl restart discourse

10 KiB Raw Blame History