Installer Mattermost avec PostgreSQL et Nginx sur CentOS 7

Mattermost est une alternative open source et auto-hébergée à Slack. Mattermost est une communication moderne derrière votre pare-feu.

En tant qu’alternative aux messageries SaaS propriétaires, Mattermost regroupe toute la communication de votre équipe en un seul endroit, la rendant recherchable et accessible de n’importe où.

Mattermost est “compatible avec Slack, mais pas limité à Slack”, prenant en charge un sur-ensemble des intégrations de webhook entrantes et sortantes de Slack, y compris la compatibilité avec les intégrations Slack existantes. À partir de vos équipes Slack existantes, vous pouvez importer des utilisateurs, l’historique des canaux publics et même les couleurs de paramètres de thème dans Mattermost.

Noms, Variables et comptes utilisés dans ce HowTo

IP locale du serveur                : 192.168.2.100  
FQDN du serveur                    : mattermost.example.com  
Nom de la base de données mattermost : mattermost  
Utilisateur pour accéder à la base de données mattermost : mmuser  
Mot de passe pour mmuser dans la base de données : DBAss47slX3

Prérequis

Ce Howto explique l’installation de Mattermost sur CentOS7 en utilisant PostgreSQL comme backend de base de données. Pour les besoins de ce guide, nous supposerons que nous installons tout sur un seul serveur, mais pour les utilisateurs expérimentés, il serait facile de démonter les parties et d’installer chaque composant (par exemple, le serveur de base de données) sur une machine différente. L’installation a été effectuée avec l’utilisateur root, mais vous pourriez, bien sûr, utiliser un utilisateur avec sudo également.

Nous supposons également que le serveur a une adresse IP de 192.168.2.100 et que le DNS résout vers mattermost.example.com. Donc, partout dans ce HowTo où vous lisez 192.168.2.100 ou mattermost.example.com, remplacez-le par l’adresse IP de votre serveur.

Avant de commencer, vous avez besoin d’une installation minimale de CentOS7. Après l’installation, assurez-vous de configurer correctement l’e-mail (configuration de postfix), afin que votre système puisse envoyer des e-mails (par exemple, via un hôte intelligent ou une solution similaire).

Veuillez effectuer quelques petites vérifications avant de continuer :

Essayez d’envoyer un mail depuis un terminal sur votre serveur :

[root@mattermost ~]echo -en "Subject: Testmail\n\nCeci est un test\n" | sendmail [email protected]

(remplacez [email protected] par une adresse e-mail à laquelle votre serveur devrait pouvoir envoyer). Assurez-vous d’avoir reçu un e-mail du système !

Vérifiez la résolution de nom pour mattermost.example.com

Depuis un autre ordinateur (pas le serveur que nous essayons de configurer), essayez de pinger mattermost.example.com. Vous devriez obtenir un résultat positif :

C:\>ping mattermost.example.com  
Pinging mattermost.witron.com [192.168.2.100] with 32 bytes of data :  
Reply from 192.168.2.100: bytes=32 time<1ms TTL=64  
Reply from 192.168.2.100: bytes=32 time<1ms TTL=64  
Reply from 192.168.2.100: bytes=32 time<1ms TTL=64  
Reply from 192.168.2.100: bytes=32 time<1ms TTL=64  
  
Ping statistics for 192.168.2.100 :  
Packets : Sent = 4, Received = 4, Lost = 0 (0% loss),  
Approximate round trip times in milli-seconds :  
Minimum = 0ms, Maximum = 0ms, Average = 0ms

Vérifiez la connectivité Internet

Nous allons maintenant installer le paquet wget (dont nous aurons besoin plus tard).

[root@mattermost ~] yum -y install wget

et l’utiliser pour déterminer notre IP publique. Ainsi, nous pouvons vérifier notre connectivité Internet.

[root@mattermost ~] wget http://ipinfo.io/ip -qO -  
46.101.122.124

Le résultat devrait être votre adresse IP publique.

Vérifiez l’état du pare-feu et désactivez-le pour l’instant

Veuillez vérifier si votre installation CentOS7 a firewalld activé. Vous pouvez le vérifier en tapant

[root@mattermost ~] systemctl status firewalld

S’il affiche quelque chose comme

Active: active (running) since …

veuillez l’éteindre et le désactiver avec ces 2 commandes.

[root@mattermost ~] systemctl stop firewalld  
[root@mattermost ~] systemctl disable firewalld

À la fin de ce tutoriel, vous trouverez des instructions sur la façon de réactiver firewalld et comment le configurer correctement pour fonctionner avec Mattermost.

Si vous passez toutes les vérifications ci-dessus ou si vous savez que vous avez un système utilisable pour ce tutoriel, vous pouvez continuer maintenant.

Installer le serveur de base de données PostgreSQL

Nous allons utiliser PostgreSQL comme backend de base de données pour Mattermost. Installez-le avec la commande suivante :

[root@mattermost ~] yum -y install postgresql-server postgresql-contrib

Après l’installation, nous devons initialiser la base de données.

[root@mattermost ~] postgresql-setup initdb  
Initializing database ... OK

Ensuite, démarrez PostgreSQL et activez-le pour un démarrage automatique.

[root@mattermost ~]# systemctl start postgresql  
[root@mattermost ~]# systemctl enable postgresql  
Created symlink from /etc/systemd/system/multi-user.target.wants/postgresql.service to /usr/lib/systemd/system/postgresql.service.

Veuillez vérifier que PostgreSQL fonctionne en exécutant.

[root@mattermost ~]# systemctl status postgresql

Il devrait rapporter quelque chose de similaire à ceci (assurez-vous qu’il y a Active: active (running) quelque part dans le texte).

? postgresql.service - Serveur de base de données PostgreSQL  
Loaded: loaded (/usr/lib/systemd/system/postgresql.service; enabled; vendor preset: disabled)  
Active: active (running) since Fri 2016-03-04 11:37:50 CET; 44s ago  
Main PID: 17660 (postgres)  
CGroup: /system.slice/postgresql.service  
??17660 /usr/bin/postgres -D /var/lib/pgsql/data -p 5432  
??17661 postgres: logger process  
??17663 postgres: checkpointer process  
??17664 postgres: writer process  
??17665 postgres: wal writer process  
??17666 postgres: autovacuum launcher process  
??17667 postgres: stats collector process  
  
Mar 04 11:37:48 mattermost systemd[1]: Starting PostgreSQL database server...  
Mar 04 11:37:50 mattermost systemd[1]: Started PostgreSQL database server.  
Mar 04 11:37:59 mattermost systemd[1]: Started PostgreSQL database server.

Créer la base de données mattermost et l’utilisateur de base de données

PostgreSQL a automatiquement créé un utilisateur et un groupe avec le nom postgres. Nous utilisons l’utilisateur postgres pour nous connecter au moteur de base de données et configurer une base de données et un utilisateur qui peuvent y accéder.

Démarrez un prompt en tant qu’utilisateur postgres :

[root@mattermost ~]# sudo -i -u postgres

Votre prompt changera maintenant en :

-bash-4.2$

Connectons-nous maintenant au serveur de base de données.

-bash-4.2$ psql  
psql (9.2.15)  
Type "help" for help.  
postgres=#

Dans le prompt PostgreSQL, nous créons maintenant une base de données avec le nom ‘mattermost’.

postgres=# CREATE DATABASE mattermost;  
CREATE DATABASE

Maintenant, nous créons un utilisateur ‘ mmuser ‘ avec le mot de passe ‘ DBAss47slX3‘.

postgres=# CREATE USER mmuser WITH PASSWORD '*DBAss47slX3*';  
CREATE ROLE

Accordez à l’utilisateur l’accès à la base de données Mattermost en tapant :

postgres=# GRANT ALL PRIVILEGES ON DATABASE mattermost to mmuser;  
GRANT  
postgres=#

Nous pouvons ensuite quitter le prompt PostgreSQL en tapant :

postgres=# \q  
-bash-4.2$

Et ensuite quitter le shell que nous avons commencé en tant qu’utilisateur ‘ postgres ‘ avec.

-bash-4.2$ exit  
logout  
[root@mattermost ~]#

Autoriser l’accès à la base de données PostgreSQL depuis localhost via nom d’utilisateur/mot de passe

Plus tard, notre instance mattermost souhaitera communiquer avec la base de données PostgreSQL et s’authentifier avec un nom d’utilisateur et un mot de passe. Pour permettre cela, nous devons légèrement modifier la configuration de PostgreSQL. Ouvrez le fichier :

vi /var/lib/pgsql/data/pg_hba.conf

avec un éditeur comme vi ou nano et changez la ligne :

host    all             all             127.0.0.1/32            ident

en :

host    all             all             127.0.0.1/32            md5

Enregistrez le fichier et redémarrez ensuite PostgreSQL.

[root@mattermost ~]# systemctl restart postgresql

Nous devrions vérifier que nous avons fait cela correctement en nous connectant au serveur de base de données avec notre utilisateur et mot de passe précédemment créés (utilisez votre mot de passe si vous en avez utilisé un différent sur votre serveur) :

[root@mattermost ~]# psql --host=127.0.0.1 --dbname=mattermost --username=mmuser --password  
Password for user mmuser:  
psql (9.2.15)  
Type "help" for help.  
  
mattermost=> \q  
[root@mattermost ~]#

Notre serveur PostgreSQL et notre base de données sont maintenant prêts pour Mattermost !

Télécharger et extraire Mattermost

Téléchargeons une copie du serveur Mattermost directement depuis leur dépôt Github (au moment de la création de ce tutoriel, la version v2.0.0 était la version actuelle) en utilisant wget.

[root@mattermost ~]# cd  
[root@mattermost ~]# wget -q "https://github.com/mattermost/platform/releases/download/v2.0.0/mattermost.tar.gz" -O mattermost.tar.gz

Maintenant, extrayons l’archive et mettons les fichiers extraits à leur emplacement cible (dans ce cas, nous utilisons /opt/mattermost).

[root@mattermost ~]# tar -xvzf mattermost.tar.gz  
[root@mattermost ~]# mv mattermost /opt

Installer Mattermost

Créer un utilisateur qui exécute le démon Mattermost

Nous allons plus tard exécuter Mattermost en tant que démon. Par conséquent, nous configurons un nouvel utilisateur sur notre système avec le nom ‘ mattermost ‘. Il exécutera l’instance mattermost plus tard. Exécutez la commande suivante pour créer un utilisateur et un groupe système ‘ mattermost ‘ :

[root@mattermost ~]# useradd -r mattermost -U -s /sbin/nologin

Créer un dossier de stockage de données pour Mattermost

Mattermost souhaite stocker certaines de ses données, par exemple, des fichiers téléchargés, etc. dans un dossier. Nous devons donc créer ce dossier. Il peut être n’importe où sur le disque dur mais doit être accessible par l’utilisateur ‘ mattermost ‘. J’ai choisi d’utiliser ‘/opt/mattermost/data’. Créez le dossier avec la commande suivante :

[root@mattermost ~]# mkdir -p /opt/mattermost/data

Définir le propriétaire du répertoire mattermost

Maintenant, nous définissons le groupe et le propriétaire du répertoire mattermost à notre utilisateur et groupe précédemment créés :

[root@mattermost ~]# chown -R mattermost:mattermost /opt/mattermost  
[root@mattermost ~]# chmod -R g+w /opt/mattermost**

Configurer la connexion à la base de données pour mattermost

Pour indiquer à Mattermost comment il doit se connecter à notre base de données PostgreSQL, nous devons modifier son fichier de configuration :

*/opt/mattermost/config/config.json*

Veuillez trouver la section ‘ SqlSettings ‘ et la modifier selon nos besoins :

AVANT

"SqlSettings": {  
 "DriverName": "mysql",  
 "DataSource": "mmuser:mostest@tcp(dockerhost:3306)/mattermost_test?charset=utf8mb4,utf8",  
 "DataSourceReplicas": [],  
 "MaxIdleConns": 10,  
 "MaxOpenConns": 10,  
 "Trace": false,  
 "AtRestEncryptKey": "7rAh6iwQCkV4cA1Gsg3fgGOXJAQ43QVg"  
 },

APRÈS

"SqlSettings": {  
 "DriverName": "postgres",  
 "DataSource": "postgres://mmuser:[email protected]:5432/mattermost?sslmode=disable&connect_timeout=10",  
 "DataSourceReplicas": [],  
 "MaxIdleConns": 10,  
 "MaxOpenConns": 10,  
 "Trace": false,  
 "AtRestEncryptKey": "7rAh6iwQCkV4cA1Gsg3fgGOXJAQ43QVg"  
 },

Vous pouvez laisser la AtRestEncryptKey telle quelle !

Configurer la connectivité e-mail pour mattermost

Encore une fois, nous devons modifier son fichier de configuration

*/opt/mattermost/config/config.json*

Trouvez la section ‘EmailSettings’ et modifiez-la selon nos besoins :

AVANT

 "EmailSettings": {  
 "EnableSignUpWithEmail": true,  
 "EnableSignInWithEmail": true,  
 "EnableSignInWithUsername": false,  
 "SendEmailNotifications": false,  
 "RequireEmailVerification": false,  
 "FeedbackName": "",  
 "FeedbackEmail": "",  
 "SMTPUsername": "",  
 "SMTPPassword": "",  
 "SMTPServer": "",  
 "SMTPPort": "",  
 "ConnectionSecurity": "",  
 "InviteSalt": "bjlSR4QqkXFBr7TP4oDzlfZmcNuH9YoS",  
 "PasswordResetSalt": "vZ4DcKyVVRlKHHJpexcuXzojkE5PZ5eL",  
 "SendPushNotifications": false,  
 "PushNotificationServer":  
},  

APRÈS

 "EmailSettings": {  
 "EnableSignUpWithEmail": true,  
 "EnableSignInWithEmail": true,  
 "EnableSignInWithUsername": false,  
 "SendEmailNotifications": false,  
 "RequireEmailVerification": false,  
 "FeedbackName": "",  
 "FeedbackEmail": "",  
 "SMTPUsername": "",  
 "SMTPPassword": "",  
 "SMTPServer": "127.0.0.1",  
 "SMTPPort": "25",  
 "ConnectionSecurity": "",  
 "InviteSalt": "bjlSR4QqkXFBr7TP4oDzlfZmcNuH9YoS",  
 "PasswordResetSalt": "vZ4DcKyVVRlKHHJpexcuXzojkE5PZ5eL",  
 "SendPushNotifications": false,  
 "PushNotificationServer": ""  
},

Nous utilisons 127.0.0.1 et le port 25 car nous utilisons notre installation locale de postfix qui est déjà configurée pour pouvoir envoyer des e-mails à l’extérieur. Si votre configuration diffère ici, vous devez définir les valeurs correctes !

Configurer mattermost pour n’écouter que sur l’interface interne (127.0.0.1)

Par défaut, l’instance du serveur mattermost écoutera sur toutes les interfaces sur le port 8065 (:8065). Comme nous voulons mettre un serveur Nginx devant mattermost, nous changeons ce comportement pour qu’il n’écoute que sur localhost (127.0.0.1:8065).

Il suffit de changer la ligne

        "ListenAddress": ":8065",

en

        "ListenAddress": "127.0.0.1:8065",

dans le fichier config.json.

Tester le serveur Mattermost

Nous pouvons maintenant tester si notre serveur mattermost démarrerait en l’exécutant depuis la ligne de commande. Veuillez vous assurer de le faire en tant qu’utilisateur ‘mattermost’. Si vous l’avez accidentellement fait en tant que ‘root’, vous devez à nouveau corriger les permissions pour le dossier mattermost !

[root@mattermost ~]# su - mattermost -s /bin/bash  
  
Last login: Fri Mar 4 12:47:52 CET 2016 on pts/0  
su: warning: cannot change directory to /home/mattermost: No such file or directory  
-bash-4.2$

Changez maintenant de répertoire vers le répertoire d’installation de mattermost :

-bash-4.2$ cd /opt/mattermost/bin/

Et exécutez mattermost depuis la ligne de commande :

-bash-4.2$ ./platform

La sortie devrait ressembler à ceci :

[2016/03/04 13:00:10 CET] [INFO] Loaded system translations for 'en' from '/opt/mattermost/i18n/en.json'  
[2016/03/04 13:00:10 CET] [INFO] Current version is 2.0.0 (5950/Sat Feb 13 15:42:01 UTC 2016/c71c5cef632c7dc68072167c6fe091a60835fa02)  
[2016/03/04 13:00:10 CET] [INFO] Enterprise Enabled: false  
[2016/03/04 13:00:10 CET] [INFO] Current working directory is /opt/mattermost/bin  
[2016/03/04 13:00:10 CET] [INFO] Loaded config file from /opt/mattermost/config/config.json  
[2016/03/04 13:00:10 CET] [INFO] Server is initializing...  
[2016/03/04 13:00:10 CET] [INFO] Pinging sql master database  
[2016/03/04 13:00:10 CET] [INFO] Pinging sql replica-0 database  
[2016/03/04 13:00:10 CET] [DEBG] Deleting any unused pre-release features  
[2016/03/04 13:00:10 CET] [INFO] The database schema has been set to version 2.0.0  
[2016/03/04 13:00:10 CET] [DEBG] Initializing user api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing team api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing channel api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing post api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing web socket api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing file api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing command api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing admin api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing oauth api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing webhook api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing preference api routes  
[2016/03/04 13:00:10 CET] [DEBG] Initializing license api routes  
[2016/03/04 13:00:10 CET] [DEBG] Parsing server templates at /opt/mattermost/api/templates/  
[2016/03/04 13:00:10 CET] [DEBG] Initializing web routes  
[2016/03/04 13:00:10 CET] [DEBG] Using static directory at /opt/mattermost/web/static/  
[2016/03/04 13:00:10 CET] [DEBG] Parsing templates at /opt/mattermost/web/templates/  
[2016/03/04 13:00:10 CET] [INFO] Starting Server...  
[2016/03/04 13:00:10 CET] [INFO] Server is listening on 127.0.0.1:8065  
[2016/03/04 13:00:10 CET] [INFO] RateLimiter is enabled  
[2016/03/04 13:00:10 CET] [DEBG] Checking for security update from Mattermost  
[2016/03/04 13:00:10 CET] [EROR] Failed to get security update information from Mattermost.

Arrêtez le serveur mattermost avec Ctrl+C

et ensuite quittez le shell que nous avons commencé en tant qu’utilisateur ‘mattermost’ avec :

-bash-4.2$ exit  
logout  
[root@mattermost ~]#

Si votre instance mattermost ne démarre pas, lisez attentivement la sortie. J’ai moi-même eu beaucoup de problèmes parce que j’ai oublié une simple virgule dans config.json. Assurez-vous également de ne pas utiliser de caractères spéciaux dans le mot de passe de votre utilisateur de base de données, en particulier aucun signe ‘ @ ‘. Cela m’a rendu fou au début !

Si vous avez accidentellement exécuté la commande ci-dessus en tant que ‘ root ‘ et que cela pourrait également fonctionner, vous devez à nouveau corriger les permissions pour le dossier mattermost. Utilisez cette commande si vous êtes tombé sur cette erreur :

[root@mattermost ~]# chown -R mattermost:mattermost /opt/mattermost

Si tout s’est bien passé, nous pouvons maintenant continuer.

Configurer Mattermost en tant que démon

Pour configurer Mattermost en tant que démon, créez un fichier

*/etc/systemd/system/mattermost.service*

avec le contenu suivant :

[Unit]  
Description=Mattermost  
After=syslog.target network.target  
  
[Service]  
Type=simple  
WorkingDirectory=/opt/mattermost/bin  
User=mattermost  
ExecStart=/opt/mattermost/bin/platform  
PIDFile=/var/spool/mattermost/pid/master.pid  
  
[Install]  
WantedBy=multi-user.target

Ensuite, rechargez les fichiers de démon avec :

[root@mattermost ~]# systemctl daemon-reload

Nous pouvons maintenant démarrer/arrêter/activer/désactiver ce service comme nous avons l’habitude de le faire.

Alors, démarrons Mattermost, obtenons son statut et activons-le en tant que service (démarrage automatique).

Démarrer le démon mattermost

[root@mattermost ~]# systemctl start mattermost.service

Vérifiez le statut de mattermost

[root@mattermost ~]# systemctl status mattermost.service  
? mattermost.service - Mattermost  
Loaded: loaded (/etc/systemd/system/mattermost.service; disabled; vendor preset: disabled)  
 Active: active (running) since Fri 2016-03-04 14:03:40 CET; 4s ago  
Main PID: 18573 (platform)  
CGroup: /system.slice/mattermost.service  
??18573 /opt/mattermost/bin/platform  
...  
...

Assurez-vous qu’il est actif (en cours d’exécution) !

Activer le démon pour le démarrage automatique

[root@mattermost ~]# systemctl enable mattermost.service  
Created symlink from /etc/systemd/system/multi-user.target.wants/mattermost.service to /etc/systemd/system/mattermost.service.

Juste pour être sûr, faisons un test si Mattermost écoute sur 127.0.0.1:8065 en exécutant la commande suivante :

[root@mattermost config]# curl -s "http://127.0.0.1:8065" | grep -b "2015 Mattermost"

Nous devrions obtenir une seule ligne contenant ‘2015 Mattermost’.

11343:        © 2015 Mattermost, Inc.

Si c’est le cas, nous pouvons être sûrs que l’instance du serveur Mattermost fonctionne et nous pouvons continuer.

Corriger les problèmes de permission liés à SELinux

Sur CentOS7, SELinux est activé par défaut. Nous pourrions le désactiver complètement, mais il est préférable de le reconfigurer et de permettre à notre serveur Mattermost de s’exécuter.

Il suffit d’entrer les 2 commandes suivantes pour corriger les permissions SELinux :

[root@mattermost config]# chcon -Rt httpd_sys_content_t /opt/mattermost/  
[root@mattermost config]# setsebool -P httpd_can_network_connect 1

Configurer le serveur Nginx

Nous allons mettre un serveur Nginx devant notre instance de serveur Mattermost.

Les principaux avantages sont :

• Mappage de port :80 à :8065
• Journaux de requêtes standard
• Plus d’options lors du passage à SSL plus tard

Activer le dépôt epel

Nginx n’est pas dans les dépôts par défaut de CentOS. Nous devons donc d’abord activer le dépôt epel. C’est une tâche facile, il suffit d’entrer :

[root@mattermost config]# yum -y install epel-release && yum update

Installer nginx

Après avoir activé le dépôt epel-release, nous pouvons simplement installer nginx avec la commande suivante :

[root@mattermost config]# yum -y install nginx

Cela installera nginx et toutes ses dépendances.

Configurer nginx

Il existe de nombreuses façons de configurer Nginx. Ce tutoriel montrera simplement comment créer une configuration très simple pour Nginx qui héberge simplement notre serveur Mattermost sur le port 80.

Changer le fichier de configuration par défaut de Nginx

Créez une sauvegarde de l’actuel nginx.conf en exécutant :

[root@mattermost config]# cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak

Ensuite, remplacez /etc/nginx/nginx.conf par ce contenu :

# Pour plus d'informations sur la configuration, voir :  
# * Documentation officielle en anglais : http://nginx.org/en/docs/  
# * Documentation officielle en russe : http://nginx.org/ru/docs/  
  
user nginx;  
worker_processes auto;  
error_log /var/log/nginx/error.log;  
pid /run/nginx.pid;  
  
events {  
 worker_connections 1024;  
}  
  
http {  
 log_format main '$remote_addr - $remote_user [$time_local] "$request" '  
 '$status $body_bytes_sent "$http_referer" '  
 '"$http_user_agent" "$http_x_forwarded_for"';  
  
 access_log /var/log/nginx/access.log main;  
  
 sendfile on;  
 tcp_nopush on;  
 tcp_nodelay on;  
 keepalive_timeout 65;  
 types_hash_max_size 2048;  
  
 include /etc/nginx/mime.types;  
 default_type application/octet-stream;  
  
 # Charger les fichiers de configuration modulaires du répertoire /etc/nginx/conf.d.  
 # Voir http://nginx.org/en/docs/ngx_core_module.html#include  
 # pour plus d'informations.  
 include /etc/nginx/conf.d/*.conf;  
  
 server {  
 server_name mattermost.example.com;  
 location / {  
 client_max_body_size 50M;  
 proxy_set_header Upgrade $http_upgrade;  
 proxy_set_header Connection "upgrade";  
 proxy_set_header Host $http_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_set_header X-Frame-Options SAMEORIGIN;  
 proxy_pass http://127.0.0.1:8065;  
 }  
 }  
}

Veuillez vous assurer d’utiliser le nom d’hôte correct comme indiqué précédemment dans ce document.

Pour vérifier que nous n’avons pas d’erreurs de syntaxe dans nos fichiers de configuration, exécutez la commande suivante pour vérifier la syntaxe :

[root@mattermost config]# nginx -t  
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok  
ginx: configuration file /etc/nginx/nginx.conf test is successful

Démarrer et activer Nginx en tant que démon

Démarrer Nginx

[root@mattermost config]# systemctl start nginx

Vérifier le statut

[root@mattermost config]# systemctl status nginx

Assurez-vous qu’il affiche au moins une ligne indiquant :

...  
Active: active (running)...  
...

Activer en tant que démon

[root@mattermost config]# systemctl enable nginx  
Created symlink from /etc/systemd/system/multi-user.target.wants/nginx.service to /usr/lib/systemd/system/nginx.service.

Si tout s’est bien passé, vous devriez maintenant avoir une installation Mattermost fonctionnelle fonctionnant derrière Nginx. Vérifiez-le en ouvrant l’URL suivante dans votre navigateur :

http://mattermost.example.com

L’écran de connexion Mattermost devrait apparaître !

Maintenant, vous pouvez continuer à configurer votre installation Mattermost en saisissant votre adresse e-mail et en créant un compte.

Firewalld

Plus tôt dans ce tutoriel, nous avons désactivé firewalld. Si vous souhaitez le réactiver mais souhaitez garder le port 80 ouvert (que nous utilisons actuellement pour Mattermost via Nginx), il suffit de faire ce qui suit :

Démarrer et réactiver Firewalld

[root@mattermost config]# systemctl start firewalld  
[root@mattermost config]# systemctl enable firewalld  
Created symlink from /etc/systemd/system/dbus-org.fedoraproject.FirewallD1.service to /usr/lib/systemd/system/firewalld.service.  
Created symlink from /etc/systemd/system/basic.target.wants/firewalld.service to /usr/lib/systemd/system/firewalld.service.

Ouvrir le port 80 dans le pare-feu

[root@mattermost config]# firewall-cmd --zone=public --add-port=80/tcp --permanent  
success  
[root@mattermost config]# firewall-cmd --reload  
success

Maintenant, votre installation Mattermost devrait être accessible, même si Firewalld est en cours d’exécution !

Résumé

J’espère que vous avez trouvé ce tutoriel utile et qu’il a fonctionné. Dans un environnement de production, vous devriez créer/utiliser des certificats pour votre site Web Mattermost et activer https via Nginx. Cela peut être facilement accompli en modifiant légèrement ce Howto.