From 1e9eed094c0620062fa70aecf6759c2ea68b39c9 Mon Sep 17 00:00:00 2001 From: lpoujol Date: Mon, 20 Nov 2023 16:00:46 +0100 Subject: [PATCH] =?UTF-8?q?MaJ=20(MySQL8=20en=20d=C3=A9pendance,=20config?= =?UTF-8?q?=20mmctl,=20utilisation=20de=20mmctl=20pour=20reload=20la=20con?= =?UTF-8?q?f)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- HowtoMattermost.md | 37 +++++++++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 10 deletions(-) diff --git a/HowtoMattermost.md b/HowtoMattermost.md index d6612641..64f66c22 100644 --- a/HowtoMattermost.md +++ b/HowtoMattermost.md @@ -6,16 +6,16 @@ title: Howto Mattermost * Documentation : -[Mattermost](https://mattermost.com) est un logiciel libre de discussion instantanées. C'est une alternative open source à Slack. +[Mattermost](https://mattermost.com) est un logiciel libre de discussion instantanées en équipe. C'est une alternative open source à Slack qu'on peut héberger soi-même. ## Installation ### Pré-requis -Une machine avec Debian 11 (Bullseye) avec les logiciels suivants : +Une machine avec Debian 11 (Bullseye) ou plus récent avec les logiciels suivants : * [Nginx](/HowtoNginx) - Servira de reverse proxy web -* [MySQL](/HowtoMySQL) - Base de donnée pour l'application +* [MySQL 8](/HowtoMySQL) - Base de donnée pour l'application -- **Obligatoirement** MySQL 8 car Mattermost n'est plus compatible avec MariaDB ### Mise en place @@ -24,12 +24,12 @@ Tout d'abord, on a besoin : * D'un utilisateur unix : `mattermost` -On récupère donc la dernière version Team LTS (actuellement la 7.8.1) et on déroule : +On récupère donc la dernière version Team LTS (actuellement la 8.1.6) et on déroule : ~~~ # su - mattermost -$ wget https://releases.mattermost.com/7.8.1/mattermost-team-7.8.1-linux-amd64.tar.gz -$ tar mattermost-team-7.8.1-linux-amd64.tar.gz +$ wget https://releases.mattermost.com/7.8.1/mattermost-team-8.1.6-linux-amd64.tar.gz +$ tar mattermost-team-9.1.6-linux-amd64.tar.gz $ cd mattermost $ mkdir data ~~~ @@ -69,7 +69,7 @@ Par défaut, Mattermost écoute sur le port 8065. En s'y connectant, on peut cr On peut aussi configurer nginx comme reverse proxy en s'inspirant de la configuration conseillée dans [la documentation officielle](https://docs.mattermost.com/install/install-debian.html#configuring-nginx-as-a-proxy-for-mattermost-server). -> Note: La configuration proposée par les développeurs s'appuie sur le module de cache de nginx. Ce module permet de décharger de certaines requêtes le service mattermost. Mais il peut compliquer les test lors de soucis sur l'interface web. +> Note: La configuration proposée par les développeurs s'appuie sur le module de cache de Nginx. Ce module permet de décharger de certaines requêtes le service Mattermost. Mais il peut compliquer les tests lors de soucis sur l'interface web. Dans cet exemple de configuration il n'est donc pas activé par défaut. ~~~ upstream backend { @@ -145,12 +145,29 @@ Voir [la documentation officielle](https://docs.mattermost.com/administration/up # Plugins Mattermost est extensible avec de nombreux plugins. -La plupart du temps, il suffit de décompacter une archive dans le répertoire `plugins/` puis de l'activer dans la console système. +La plupart du temps, il suffit de décompacter une archive dans le répertoire `plugins/` puis de l'activer dans la console système. Il est aussi possible d'uploader l'archive du plugin via la console système si cette option à été activée dans le `config.json` # FAQ / Plomberie -## Supprimer une équipe +## Configuration de l'outil CLI `mmctl` + +Certaines opérations de maintenance se réalisent via l'outil en cli `mmctl`. +Celui-ci nécessite de se connecter avec un compte administrateur de l'instance Mattermost ~~~ -$ /home/mattermost/mattermost/bin/mattermost -c /home/mattermost/config/config.json team delete +$ mattermost/bin/mmctl auth login https://mattermost.example.com/ +Connection name: default +Username: USERNAME +Password: PASSWORD + + credentials for "default": "USERNAME@https://mattermost.example.com" stored + ~~~ + +## Recharger la configuration + +Depuis quelques versions, Mattermost ne surveille plus le fichier de configuration pour y détecter les changements. +Il faut donc utiliser l'outil en CLI `mmctl` pour demander à Mattermost. + +On le fait avec la commande `mattermost/bin/mmctl config reload` (après avoir configuré `mmctl`) +