Installer Discourse sur CentOS 7

• Exigences
• Configurer le fichier d'échange
• Installer Docker
• Installer le discours
• Configurer le discours
• Bootstrap et commencer le discours
• Discours ouvert dans votre navigateur
• Dépannage

Discourse est une nouvelle solution de forum open-source qui est simple, propre et directe. Il est implémenté avec Ruby on Rails, une base de données Postgres et un cache de serveur Redis. Ce tutoriel décrit comment installer Discourse sur un VPS Vultr avec CentOS 7.

Exigences

• Vultr VPS avec 1 Go de RAM minimum.
• CentOS 7 x64 installé sur le VPS.

Configurer le fichier d'échange

Vous devez configurer l'échange pour un VPS RAM de 1 Go. Si votre VPS a plus de 1 Go de RAM, vous pouvez ignorer cette étape. Nous allons créer un fichier d'échange de 2 Go pour 1 Go de RAM VPS.

1. Créez le fichier d'échange.

   dd if=/dev/zero of=/swapfile bs=1M count=2048
   mkswap /swapfile
   chmod 600 /swapfile
   

2. Modifiez fstab pour ajouter le fichier d'échange dans la table des systèmes de fichiers.

   Ouvrez fstab avec vi:

   vi /etc/fstab
   

   Ajoutez la ligne suivante dans le fichier:

   /swapfile       swap    swap    defaults      0       0
   

3. Définissez la politique d'utilisation du swap. N'utilisez le fichier d'échange que lorsque la mémoire système est faible.

   sysctl -w vm.swappiness=10
   echo vm.swappiness = 10 | tee -a /etc/sysctl.conf
   sysctl vm.vfs_cache_pressure=60
   echo vm.vfs_cache_pressure = 60 | tee -a /etc/sysctl.conf
   

4. Activez le fichier d'échange.

   mount -a
   swapon -a
   

5. Vérifiez l'état du fichier d'échange.

   swapon -s
   

   Si le fichier d'échange a été activé, vous verrez les informations suivantes.

   Filename                    Type    Size    Used    Priority
   /swapfile                  file     2097148 0       -1
   

Installer Docker

Exécutez la commande ci-dessous pour installer Docker sur CentOS 7.

yum install docker

Si vous avez désactivé SELinux, vous feriez mieux de le désactiver également dans Docker.

vi /etc/sysconfig/docker

Commentez la ligne 4.

#OPTIONS='--selinux-enabled'

Démarrez le service Docker.

systemctl start docker
systemctl enable docker

Veuillez noter que si vous redémarrez firewalld, vous devrez également redémarrer docker. Parce que firewalld supprimera la chaîne docker d'iptables lors de son redémarrage.

Installer le discours

Créez un dossier nommé discoursesous /varet clonez le référentiel Discourse.

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

Accédez au discoursedossier.

cd /var/discourse

Copiez le fichier de modèle de configuration Discourse dans le dossier conteneurs.

cp samples/standalone.yml containers/app.yml

Configurer le discours

1. Ouvrez le app.ymlavec vi.

    vi containers/app.yml
   

2. Si vous utilisez un 1 Go de VPS, définissez le db tampon partagée 128Mo dans app.yml.

   db_shared_buffers: "128MB"
   

3. Passez UNICORN_WORKERSà 2 pour une instance de 1 Go de RAM.

   ## With 2GB we recommend 3-4 workers, with 1GB only 2
   UNICORN_WORKERS: 2
   

4. Définissez votre adresse e-mail pour le compte administrateur. Vous aurez besoin de cet e-mail pour enregistrer le compte administrateur sur votre forum Discourse.

   DISCOURSE_DEVELOPER_EMAILS: 'you@youremail.com'
   

5. Définissez le nom de domaine pour Discourse. Par exemple, nous le définissons comme discourse.example.com, cela signifie qu'il serait accessible à l'URL http://discourse.example.com/.

   ## TODO: The domain name this Discourse instance will respond to
   DISCOURSE_HOSTNAME: 'discourse.example.com'
   

6. Configurez votre serveur de messagerie pour Discourse.

   Si votre serveur de messagerie est sur le même serveur que Discourse, configurez-le comme suit.

   DISCOURSE_SMTP_ADDRESS: smtp.example.com                               # (mandatory)
   DISCOURSE_SMTP_PORT: 587                                                              # (optional)
   DISCOURSE_SMTP_USER_NAME: YOUR_EMAIL_ACCOUNT                # (optional)
   DISCOURSE_SMTP_PASSWORD: YOURPASSWORD                             # (optional)
   DISCOURSE_SMTP_ENABLE_START_TLS: flase                                    # (optional, default true)
   DISCOURSE_SMTP_OPENSSL_VERIFY_MODE: none
   

   Si vous utilisez un serveur SMTP distant, modifiez-le app.ymlcomme suit.

   DISCOURSE_SMTP_ADDRESS: smtp.example.com                               # (mandatory)
   DISCOURSE_SMTP_PORT: 587                                                              # (optional)
   DISCOURSE_SMTP_USER_NAME: your@example.com                          # (optional)
   DISCOURSE_SMTP_PASSWORD: YOURPASSWORD                             # (optional)
   DISCOURSE_SMTP_ENABLE_START_TLS: true                                     # (optional, default true)
   

7. Enregistrez et quittez app.yml.

Bootstrap et commencer le discours

Exécutez la commande ci-dessous pour démarrer Discourse.

./launcher bootstrap app

Une fois le processus d'amorçage terminé, démarrez Discourse.

./launcher start app

Discours ouvert dans votre navigateur

Sur votre PC client, entrez le nom de domaine que vous avez configuré pour Discourse app.yml. Vous verrez votre propre instance de Discours.

Dépannage

• Par défaut, Docker écoutera sur le port 80. Si le port 80 a déjà été utilisé par Nginx ou Apache, vous devez déplacer ce service vers un autre port; ou remplacez Docker par un autre port. Par exemple, changez "80:80" en "8080: 80" app.ymlpour que Docker écoute sur le port 8080.
• Sur le VPS RAM de 1 Go, il peut ne pas mettre à jour le Discours vers la nouvelle version, et vous verrez une "502 Bad Gateway" lors de l'accès au Discourse. La solution simple à ce problème consiste à exécuter ./launcher rebuild apppour reconstruire votre instance Discourse.