Mattermost: Administration avancée de Mattermost avec mmctl

Cette documentation fait partie du guide Premiers pas. Consultez le guide complet ici : Comment débuter avec Mattermost.

Bienvenue dans la documentation Stackhero

Stackhero offre un environnement Mattermost cloud prêt pour la production, conçu pour une collaboration sans friction et une protection robuste des données. Les principaux avantages comprennent :

• Utilisateurs et canaux illimités pour permettre la croissance de votre équipe sans restriction.
• Un serveur SMTP email dédié sans aucune limite additionnelle, inclus par défaut.
• Contrôle complet de votre nom de domaine, sécurisé automatiquement avec HTTPS (par exemple https://chat.votre-entreprise.com).
• Mises à jour sans tracas, gérées en un seul clic.
• Performance élevée et sécurité avancée sur une infrastructure privée et dédiée : vos données demeurent isolées et confidentielles.
• Hébergement disponible dans les régions 🇪🇺 Europe et 🇺🇸 USA.

Vous pouvez commencer en quelques minutes seulement. Stackhero s’occupe de l’installation, de la sécurité et de la gestion opérationnelle de votre hébergement Mattermost cloud, vous offrant une plateforme de collaboration sécuritaire et évolutive avec un minimum d’efforts.

Pour ceux qui souhaitent aller plus loin, la CLI mmctl offre des outils puissants pour gérer et configurer votre instance Mattermost. Vous pouvez trouver plus de détails dans la documentation officielle : https://docs.mattermost.com/manage/mmctl-command-line-tool.html.

Utilisation de la CLI mmctl avec Mattermost

Vous avez la possibilité d'installer mmctl sur votre ordinateur ou de l'exécuter via Docker. Nous recommandons l'utilisation de Docker. Pour lancer un conteneur avec un shell bash interactif, vous pouvez exécuter :

docker run -it mattermost/mattermost-team-edition:latest /bin/bash

Pour vous connecter, établissez une connexion avec votre serveur en exécutant :

mmctl auth login -n stackhero https://<XXXXXX>.stackhero-network.com

Vous serez invité à entrer vos identifiants Mattermost. Une fois connecté, vous pouvez effectuer diverses tâches administratives avec la CLI mmctl.

Si vous utilisez l'authentification à deux facteurs et rencontrez l'erreur "could not initiate client: Invalid MFA token", incluez votre jeton MFA (le code à 6 chiffres de votre application MFA) en exécutant :

mmctl auth login -n stackhero --mfa-token <XXXXXX> https://<XXXXXX>.stackhero-network.com

Après authentification réussie, vous pouvez lister tous les utilisateurs Mattermost avec la commande suivante :

mmctl user list

Suppression d'un utilisateur Mattermost avec mmctl

Soyez prudent : cette action supprimera définitivement l'utilisateur et toutes les données associées, et la récupération n'est pas possible.

Bien que vous puissiez désactiver un utilisateur depuis la Console Système de Mattermost, la suppression doit être effectuée via la CLI mmctl. Pour supprimer un utilisateur, exécutez :

mmctl user delete [email protected]

Si vous rencontrez l'erreur "Permanent user deletion feature is not enabled. Please contact your System Administrator", activez la suppression d'utilisateur via le support API avec :

mmctl config set ServiceSettings.EnableAPIUserDeletion true

Suppression d'un canal Mattermost avec mmctl

Vous pouvez supprimer un canal en utilisant la CLI mmctl.

Soyez prudent : cette action supprimera définitivement le canal et toutes ses données, et la récupération n'est pas possible.

Pour supprimer un canal, remplacez <TEAM> et <CHANNEL> par vos valeurs spécifiques et exécutez :

mmctl channel delete <TEAM>:<CHANNEL>

Si vous rencontrez l'erreur Permanent channel deletion feature is not enabled. Please contact your System Administrator., activez cette fonctionnalité en exécutant :

mmctl config set ServiceSettings.EnableAPIChannelDeletion true