Aller au contenu principal

Module Mattermost GKE — Guide de configuration

Module Mattermost GKE — Guide de configuration

Ce guide décrit chaque variable de configuration disponible dans le module Mattermost_GKE. Mattermost_GKE est un module wrapper qui combine le module d'infrastructure générique App_GKE avec la configuration d'application partagée Mattermost_Common pour déployer Mattermost — une plateforme de messagerie et de collaboration d'équipe open source et auto-hébergeable — sur Google Kubernetes Engine (GKE) Autopilot.

La plupart des options de configuration de Mattermost GKE correspondent directement aux mêmes options de App GKE. Lorsqu'une variable a un comportement identique, ce guide fait référence au guide App GKE plutôt que de répéter la même documentation. Seules les variables et les valeurs par défaut spécifiques à Mattermost sont décrites en détail ici.

Note : Les variables marquées comme gérées par la plateforme sont définies et maintenues par la plateforme. Vous n'avez normalement pas besoin de les modifier.

GKE vs Cloud Run : Mattermost maintient des connexions WebSocket persistantes pour la livraison de messages en temps réel. GKE Autopilot est mieux adapté aux déploiements Mattermost en production que Cloud Run car il prend en charge les connexions de longue durée sans les contraintes de délai d'attente par requête de Cloud Run. Utilisez Mattermost GKE pour tout déploiement de taille d'équipe où la fiabilité en temps réel est importante.


Ce que coûte Mattermost sur RAD, et comment cela se compare​

Mattermost sur le module GKE Autopilot de RAD coûte environ 150 $ US par mois dans votre propre projet, quel que soit le nombre d'utilisateurs. RAD facture 110 crédits une fois par déploiement dans votre propre projet (99 crédits, soit 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. La même application se déploie également sur Cloud Run pour environ 170 $ US par mois — voir le guide Cloud Run pour l'option moins chère. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ce chiffre mensuel devient quelques dollars au lieu de cela — voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11,00 $ US au prix de la recharge)99 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 150 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 141 crédits par jour, environ 4 230 par mois (environ 423 $ US au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins pour un forfait mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (valeur par défaut du module)Par mois
Pod GKE Autopilot, 2 vCPU / 4 Gio79 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 $ US
Serveur de fichiers NFS/cache (petite VM)13 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ US si c'est votre seul cluster, sinon ~73 $ US
Totalenviron 150 $ US

Comment cela se compare​

  • Slack, tarifé par utilisateur, coûte 7 £ par utilisateur et par mois sur son plan Pro (70 £ par mois pour une équipe de dix) ou 14,40 £ par utilisateur et par mois sur Business+ (144 £ par mois pour dix), facturé mensuellement ; la facturation annuelle est moins chère. Les prix ont été lus sur slack.com depuis le Royaume-Uni.
  • Le module Mattermost de RAD coûte environ 150 $ US par mois dans votre propre projet quel que soit le nombre d'employés — pour une équipe de dix, c'est proche de Slack Pro, mais une équipe de cinquante paie à Slack cinquante fois les frais par siège tandis que le coût d'infrastructure de RAD bouge à peine, et chaque message, fichier et exportation reste dans votre propre projet plutôt que dans une plateforme multi-locataire d'un fournisseur.
  • Comparaison auto-gérée : l'empreinte de 2 vCPU de Mattermost est proche d'un GCP Compute Engine e2-standard-2 (~49 $ US/mois) pour la configuration plus petite, mais ensuite vous exécutez PostgreSQL, le stockage de fichiers, les correctifs de sécurité et la disponibilité vous-même.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin​

Si Mattermost fonctionne dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Mattermost dont vous n'avez besoin qu'occasionnellement — évaluation, environnement de démonstration, charge de travail saisonnière ou intermittente — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne détruit pas la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Parce que rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà là — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 423 $ US par mois pour le maintenir en fonctionnement. Déployez Mattermost, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et le temps qu'il a réellement été en ligne.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'évaluation conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes et autres fichiers générés sont écrits dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Mattermost et souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) — 110 crédits (11,00 $ US) au total. La suppression permet d'économiser de l'argent seulement une fois que Mattermost resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 3 jours ou plus, à la fois dans votre propre projet (environ 4,99 $ US par jour) et dans un projet géré par RAD (141 crédits par jour).
  • La majeure partie du coût d'exécution est généralement partagée. Pour Mattermost, il s'agit de la base de données et de la VM de fichier/cache partagée. Elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
  • Conservez vos données d'abord. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle ; Slack. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

Référence de configuration standard​

Les zones de configuration suivantes sont fournies par le module sous-jacent App_GKE. Consultez les sections liées du Guide de configuration App_GKE pour une documentation complète.

Zone de configurationSection App GKE.mdNotes spécifiques à Mattermost
Projet et identité§2 IAM et contrôle d'accèsIdentique.
Identité de l'application§3.A Calcul (GKE Autopilot)Valeurs par défaut spécifiques à Mattermost ; voir Groupe 2 : Identité de l'application.
Exécution et mise à l'échelle§3.A Calcul (GKE Autopilot)Valeurs par défaut spécifiques à Mattermost pour container_port, container_resources et min_instance_count ; voir Groupe 3 : Exécution et mise à l'échelle.
Variables d'environnement et secrets§3 Configuration du service principalPas de variables d'environnement pré-remplies — Mattermost est configuré via site_url et edition ; voir Groupe 5 : Variables d'environnement et secrets.
Réseau et politiques réseau§3.D Réseau et politiques réseauIdentique.
Jobs d'initialisation et CronJobs§3.E Jobs d'initialisation et CronJobsJob PostgreSQL db-init fourni automatiquement par Mattermost Common ; voir Groupe 8 : Jobs et tâches planifiées.
Services supplémentaires§3.F Services supplémentairesIdentique.
Stockage — NFS§3.C Stockage (NFS / GCS / GCS Fuse)enable_nfs par défaut à true (les téléchargements résident sur le partage NFS) ; voir Groupe 9 : Stockage et système de fichiers — NFS.
Stockage — GCS§3.C Stockage (NFS / GCS / GCS Fuse)Alternative facultative à NFS pour /mattermost/data ; voir Groupe 10 : Stockage et système de fichiers — GCS.
Configuration de la base de données§3.B Base de données (Cloud SQL)PostgreSQL 15 requis ; voir Groupe 11 : Configuration de la base de données.
Planification et rétention des sauvegardes§3.B Base de données (Cloud SQL)Identique.
Scripts SQL personnalisés§3.E Jobs d'initialisation et CronJobsIdentique.
Observabilité et vérifications de santé§3.A Calcul (GKE Autopilot)Mattermost expose /api/v4/system/ping ; voir Groupe 13 : Observabilité et santé.
Cloud Armor WAF§4.A Cloud Armor WAFIdentique.
Proxy conscient de l'identité§4.B Proxy conscient de l'identité (IAP)Identique.
Autorisation binaire§4.C Autorisation binaireIdentique.
Contrôles de service VPC§4.D Contrôles de service VPCIdentique.
Pilote CSI du magasin de secrets§4.E Pilote CSI du magasin de secretsToujours activé — aucune configuration requise.
Trafic et Ingress§5 Trafic et IngressIdentique.
CDN§5.B CDNIdentique.
Domaine personnalisé et IP statique§5.C Réservation d'IP statiqueMattermost site_url doit correspondre ; voir Groupe 16 : Domaine personnalisé et IP statique.
Déclencheurs Cloud Build§6.A Déclencheurs Cloud BuildIdentique.
Pipeline Cloud Deploy§6.B Pipeline Cloud DeployIdentique.
Mise en miroir d'images§6.C Mise en miroir d'imagesIdentique.
Budgets d'interruption de pod§7.A Budgets d'interruption de podIdentique.
Contraintes de répartition topologique§7.B Contraintes de répartition topologiqueIdentique.
Quotas de ressources§7.C Quotas de ressourcesIdentique.
Rotation automatique des mots de passe§7.D Rotation automatique des mots de passeVoir Groupe 11 : Configuration de la base de données.
Cache Redis§8.A Redis / Memorystoreenable_redis par défaut à false ; voir Groupe 15 : Cache Redis.
Importation de sauvegarde§8.B Importation de sauvegardeExpose à la fois backup_uri (URI GCS complet ou ID Drive) et backup_file (nom de fichier dans le bucket de sauvegarde du module) ; voir Groupe 6 : Sauvegarde et maintenance.
Maillage de services (ASM)§8.C Maillage de services (ASM via Fleet)Identique.
Services multi-clusters§8.D Services multi-clusters (MCS)Identique.

Comment Mattermost GKE est lié à App GKE​

Mattermost GKE transmet toutes les variables à App GKE et ajoute un sous-module Mattermost Common qui fournit des valeurs par défaut et une configuration d'application spécifiques à Mattermost. Les principaux effets sont :

  1. PostgreSQL 15 est requis. Mattermost nécessite PostgreSQL 13 ou une version ultérieure. La valeur par défaut de database_type est définie sur "POSTGRES_15".
  2. Un job db-init s'exécute lors du premier déploiement. Mattermost Common fournit un Job Kubernetes db-init par défaut qui crée la base de données et l'utilisateur PostgreSQL de Mattermost. Mattermost exécute ensuite ses propres migrations de schéma au premier démarrage — aucune configuration manuelle du schéma n'est nécessaire.
  3. Pas de variables d'environnement pré-remplies. Contrairement à Ghost, Mattermost ne nécessite pas de valeurs par défaut SMTP injectées par le module. Les paramètres clés — URL du site, édition, Redis — sont contrôlés par des variables de niveau supérieur dédiées (site_url, edition, enable_redis).
  4. La sélection de l'édition contrôle l'image du conteneur. La définition de edition = "enterprise" bascule automatiquement l'image du conteneur vers mattermost/mattermost-enterprise-edition. La valeur par défaut ("team") utilise mattermost/mattermost-team-edition. L'édition Enterprise nécessite une clé de licence payante fournie via environment_variables.
  5. Les téléchargements résident sur le partage NFS. enable_nfs par défaut à true. Mattermost stocke les téléchargements de fichiers et les pièces jointes sur le disque local (MM_FILESETTINGS_DRIVERTYPE = local) sous /mattermost/data, où le volume NFS est monté, de sorte que les téléchargements survivent aux redémarrages des pods. Désactivez NFS uniquement si vous pointez MM_FILESETTINGS_* vers un stockage compatible S3.
  6. Les valeurs par défaut des ressources sont dimensionnées pour Mattermost. Les valeurs par défaut de cpu_limit (2 vCPU) et memory_limit (4 Gio) prennent en charge la gestion concurrente des WebSockets, la mise en cache des canaux et l'indexation des messages de Mattermost.
  7. Redis est facultatif. enable_redis par défaut à false. Cela ne rend pas à lui seul plus d'un réplica sûr : l'édition Team n'a pas de clustering HA, donc max_instance_count par défaut à 1 ; plusieurs réplicas nécessitent l'édition Enterprise avec une licence.
  8. Les sondes de santé utilisent le point de terminaison de ping dédié de Mattermost. startup_probe et liveness_probe par défaut à path = "/api/v4/system/ping" — le point de terminaison de santé intégré de Mattermost qui renvoie HTTP 200 lorsque le serveur est prêt à accepter les connexions.
  9. SiteURL n'est jamais vide. Mattermost utilise MM_SERVICESETTINGS_SITEURL pour les e-mails de notification, la génération de liens dans l'application et les redirections OAuth. site_url le définit explicitement ; laissé vide, le point d'entrée le dérive au démarrage de l'URL de l'équilibreur de charge (GKE_SERVICE_URL).

Groupe 1 : Projet et identité​

Identique à App_GKE. Voir App_GKE.

Ajouts spécifiques à Mattermost GKE dans ce groupe :

VariableValeur par défautDescription
region"us-central1"Région GCP pour le déploiement des ressources. Utilisée comme solution de repli lorsque la découverte de sous-réseau VPC ne peut pas déterminer la région. Également utilisée comme emplacement par défaut pour les buckets GCS provisionnés pour le stockage de fichiers Mattermost.
site_url""L'URL publique où Mattermost est accessible (par exemple, "https://chat.example.com"). Définit MM_SERVICESETTINGS_SITEURL. Laissé vide, il est dérivé au démarrage de l'URL de l'équilibreur de charge ; définissez-le lorsque vous utilisez un domaine personnalisé.
edition"team"Édition Mattermost. "team" déploie l'édition Team gratuite. "enterprise" déploie l'édition Enterprise et nécessite une clé de licence fournie via environment_variables. La modification de cette valeur après le déploiement initial remplace l'image du conteneur lors du prochain apply.

Groupe 2 : Identité de l'application​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE pour les descriptions.

Valeurs par défaut spécifiques à Mattermost :

VariableValeur par défaut Mattermost GKEValeur par défaut App GKENotes
application_name"mattermost""gkeapp"Utilisé comme nom de base pour toutes les ressources GCP et Kubernetes. Ne pas modifier après le déploiement.
application_display_name"Mattermost""App GKE Application"Affiché dans l'interface utilisateur et les tableaux de bord de la plateforme. Peut être modifié librement.
application_description"Mattermost - Open-source team messaging on GKE Autopilot""App GKE Custom Application…"Libellé descriptif. Peut être modifié librement.
application_version"9.11.2""1.0.0"La version de Mattermost à construire et à déployer. L'incrémentation de cette valeur déclenche une nouvelle exécution de Cloud Build.

Groupe 3 : Exécution et mise à l'échelle​

La plupart des variables se comportent de manière identique à App_GKE. Voir App_GKE Groupe 4.

Valeurs par défaut et comportement spécifiques à Mattermost :

VariableValeur par défaut Mattermost GKEValeur par défaut App GKENotes
container_port80658080Port HTTP natif de Mattermost. Ne pas modifier sauf si votre Dockerfile personnalisé lie Mattermost à un port différent.
container_resources{ cpu_limit = "2000m", memory_limit = "4Gi" }{ cpu_limit = "1000m", memory_limit = "512Mi" }Mattermost gère les connexions WebSocket concurrentes, la mise en cache des canaux et l'indexation des messages. 2 vCPU et 4 Gio sont les minimums de production recommandés.
min_instance_count10Mattermost maintient des connexions WebSocket persistantes. La mise à l'échelle à zéro interrompt les sessions utilisateur actives. Maintenez à 1 ou plus pour tout déploiement avec des utilisateurs actifs.
max_instance_count13L'édition Team n'a pas de clustering HA, donc un deuxième réplica ne partagerait pas l'état WebSocket. Augmentez-le uniquement avec l'édition Enterprise et une licence.
container_image_source"custom""custom"Mattermost Common fournit une build basée sur Dockerfile par défaut. Définissez sur "prebuilt" pour déployer directement une URI d'image pré-construite.
enable_cloudsql_volumefalsetrueMattermost GKE se connecte à Cloud SQL via une connexion TCP privée plutôt que via un sidecar de socket Unix par défaut. Définissez sur true pour injecter le sidecar Cloud SQL Auth Proxy.
timeout_seconds300300Pour les déploiements à forte utilisation de WebSocket, augmentez à 3600 pour éviter que les connexions WebSocket actives ne soient interrompues par le délai d'expiration du backend.
container_protocol"http1""http1"Mattermost utilise HTTP/1.1 pour son chemin de mise à niveau WebSocket. Ne pas passer à "h2c" sauf si votre configuration Mattermost prend explicitement en charge HTTP/2.

Les variables d'exécution restantes (deploy_application, container_image, container_build_config, enable_image_mirroring, enable_vertical_pod_autoscaling, service_annotations, service_labels, cloudsql_volume_mount_path) se comportent comme décrit dans App_GKE Groupe 4.


Groupe 4 : Accès et réseau​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE, App_GKE, et App_GKE.

Note : Les variables ingress_settings et vpc_egress_setting apparaissent dans les définitions de variables de Mattermost GKE mais ne sont pas transmises à App GKE. La définition de ces variables n'a aucun effet sur l'infrastructure déployée dans l'implémentation actuelle.

Les variables réseau suivantes sont disponibles dans Mattermost GKE :

VariableValeur par défautDescription
enable_iapfalseActive l'authentification Identity-Aware Proxy sur l'équilibreur de charge.
iap_authorized_users[]Utilisateurs individuels ou comptes de service ayant accès à IAP.
iap_authorized_groups[]Groupes Google ayant accès à IAP.
iap_oauth_client_id""ID client OAuth pour la configuration IAP.
iap_oauth_client_secret""Secret client OAuth pour la configuration IAP.
iap_support_email""E-mail d'assistance affiché sur l'écran de consentement Google OAuth.
enable_custom_domaintrueConfigure Ingress/Gateway pour le routage de domaine personnalisé avec des certificats SSL gérés.
application_domains[]Noms de domaine personnalisés (par exemple ["chat.example.com"]).
reserve_static_iptrueRéserve une IP statique globale pour l'équilibreur de charge.
static_ip_name""Nom de l'IP réservée ; auto-généré si vide.
network_tags["nfsserver"]Tags de pare-feu appliqués aux nœuds du cluster GKE.
enable_cloud_armorfalseActive une politique de sécurité Cloud Armor WAF.
admin_ip_ranges[]Plages CIDR d'administration autorisées via Cloud Armor.
cloud_armor_policy_name"default-waf-policy"Nom de la politique de sécurité Cloud Armor à attacher.
enable_vpc_scfalseActive l'application du périmètre des contrôles de service VPC.

Groupe 5 : Variables d'environnement et secrets​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Comportement spécifique à Mattermost :

Mattermost GKE ne pré-remplit pas environment_variables avec les paramètres Mattermost. La configuration de Mattermost est contrôlée via trois mécanismes :

  1. site_url définit MM_SERVICESETTINGS_SITEURL automatiquement via Mattermost Common.
  2. edition sélectionne l'image du conteneur (team ou enterprise) automatiquement.
  3. environment_variables accepte toutes les variables d'environnement Mattermost supplémentaires (en utilisant la convention de préfixe MM_).

Clé de licence Enterprise Edition :

Lorsque edition = "enterprise", fournissez la clé de licence via environment_variables :

environment_variables = {
MM_LICENSE = "your-mattermost-enterprise-licence-key"
}

Substitutions courantes des variables d'environnement Mattermost :

VariableObjectif
MM_EMAILSETTINGS_SMTPSERVERServeur SMTP pour les notifications par e-mail.
MM_EMAILSETTINGS_SMTPPORTPort SMTP (par exemple, "587").
MM_EMAILSETTINGS_SMTPUSERNAMENom d'utilisateur d'authentification SMTP.
MM_EMAILSETTINGS_SMTPPASSWORDMot de passe d'authentification SMTP.
MM_EMAILSETTINGS_ENABLESMTPAUTH"true" pour activer l'authentification SMTP.
MM_EMAILSETTINGS_FEEDBACKEMAILAdresse d'expéditeur pour les e-mails de notification.
MM_SERVICESETTINGS_ENABLEDEVELOPER"false" pour la production (désactive le mode développeur).

Les variables de secrets restantes (secret_environment_variables, secret_rotation_period, secret_propagation_delay, manage_storage_kms_iam) se comportent comme décrit dans App_GKE.


Groupe 6 : Sauvegarde et maintenance​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Valeurs par défaut spécifiques à Mattermost :

VariableValeur par défautNotes
backup_schedule"0 2 * * *"Quotidiennement à 02:00 UTC. Ajustez pour correspondre à votre objectif de point de récupération et aux modèles de trafic.
backup_retention_days7Rétention de 7 jours. Augmentez pour les déploiements de production (30 à 90 jours recommandés).

Importation de sauvegarde — Mattermost GKE prend en charge l'importation d'une sauvegarde existante lors du premier déploiement :

VariableValeur par défautDescription
enable_backup_importfalseLorsque true, exécute un job d'importation unique pendant le déploiement pour restaurer la sauvegarde spécifiée par backup_uri. Configurez backup_source, backup_uri et backup_format avant d'activer.
backup_source"gcs"Système source pour le fichier de sauvegarde. "gcs" importe depuis une URI Cloud Storage ; "gdrive" importe depuis un ID de fichier Google Drive.
backup_uri""URI GCS complet ("gs://my-bucket/backups/mattermost.sql") ou ID de fichier Google Drive.
backup_file"backup.sql"Nom de fichier d'une sauvegarde stockée dans le bucket GCS de sauvegardes créé automatiquement par le module. Une alternative à backup_uri pour les sauvegardes déjà placées dans le bucket géré par le module.
backup_format"sql"Format du fichier de sauvegarde. Valeurs prises en charge : sql, tar, gz, tgz, tar.gz, zip, auto.

Groupe 7 : CI/CD et intégration GitHub​

Identique à App_GKE. Voir App_GKE.

Les variables CI/CD suivantes sont disponibles : enable_cicd_trigger, github_repository_url, github_token, github_app_installation_id, cicd_trigger_config, enable_cloud_deploy, cloud_deploy_stages, enable_binary_authorization, binauthz_evaluation_mode (valeur par défaut "ALWAYS_ALLOW" ; options : ALWAYS_ALLOW, REQUIRE_ATTESTATION, ALWAYS_DENY).


Groupe 8 : Jobs et tâches planifiées​

Ces variables se comportent comme décrit dans App_GKE, avec un comportement important spécifique à Mattermost.

Job db-init par défaut de Mattermost :

Lorsque initialization_jobs est laissé comme valeur par défaut (liste vide []), Mattermost Common fournit automatiquement un job db-init :

ChampValeur
Nom du jobdb-init
ImageImage client PostgreSQL
ObjectifCrée la base de données et l'utilisateur PostgreSQL de Mattermost ; Mattermost exécute ensuite ses propres migrations de schéma au premier démarrage
CPU / Mémoire1000m / 512Mi

Remplacez initialization_jobs par une liste non vide pour remplacer cette valeur par défaut par vos propres jobs. Chaque job personnalisé doit spécifier au moins l'un des éléments suivants : command, args ou script_path.

CronJobs et services supplémentaires :

Les variables cron_jobs et additional_services sont disponibles et se comportent de manière identique à App_GKE. Voir App_GKE pour une documentation complète.

Note : Le schéma cron_jobs dans Mattermost GKE utilise les champs CronJob de Kubernetes — restart_policy, concurrency_policy, failed_jobs_history_limit, successful_jobs_history_limit, starting_deadline_seconds, suspend — plutôt que les champs de style Cloud Run utilisés dans Mattermost CloudRun. Le champ secret_env_vars n'est pas disponible dans les cron jobs GKE ; les secrets sont gérés via secret_environment_variables au niveau du module.


Groupe 9 : Stockage et système de fichiers — NFS​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Valeurs par défaut spécifiques à Mattermost :

VariableValeur par défautNotes
enable_nfstrueNFS est activé par défaut pour Mattermost : les téléchargements sont écrits sur le disque local à /mattermost/data, et sans ce montage, ils sont perdus lorsque le pod est remplacé. Définissez false uniquement si vous pointez MM_FILESETTINGS_* vers un stockage compatible S3.
nfs_mount_path"/mattermost/data"Le chemin où le volume NFS est monté à l'intérieur du conteneur Mattermost. Correspond au répertoire de données par défaut de Mattermost.

Groupe 10 : Stockage et système de fichiers — GCS​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE Groupe 14.

Comportement spécifique à Mattermost :

Mattermost stocke les téléchargements d'équipe, les pièces jointes et les données de plugin sous /mattermost/data. Le montage NFS par défaut rend déjà ce chemin durable ; comme alternative, vous pouvez provisionner un bucket GCS et le monter via le pilote CSI GCS Fuse :

create_cloud_storage = true

storage_buckets = [
{
name_suffix = "mattermost-data"
storage_class = "STANDARD"
force_destroy = false
versioning_enabled = true
}
]

gcs_volumes = [
{
name = "mattermost-data"
mount_path = "/mattermost/data"
readonly = false
mount_options = ["implicit-dirs", "stat-cache-ttl=60s", "type-cache-ttl=60s"]
}
]

Contrairement à Ghost GKE, Mattermost Common ne provisionne pas automatiquement un bucket GCS. Vous devez définir storage_buckets et gcs_volumes explicitement si vous souhaitez un stockage de fichiers basé sur GCS.

Les variables create_cloud_storage, storage_buckets et gcs_volumes se comportent comme décrit dans App_GKE Groupe 14.


Groupe 11 : Configuration de la base de données​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Valeurs par défaut et restrictions spécifiques à Mattermost :

VariableValeur par défaut de Mattermost GKEValeur par défaut d'App GKENotes
database_type"POSTGRES_15""POSTGRES"Mattermost nécessite PostgreSQL 13 ou une version ultérieure. Ne pas changer pour MySQL ou SQL Server — Mattermost ne démarrera pas.
application_database_name"mattermost""gkeappdb"Nom de la base de données PostgreSQL pour Mattermost. Ne pas modifier après le déploiement — ceci est transmis directement à Mattermost Common comme db_name.
application_database_user"mattermost""gkeappuser"Utilisateur PostgreSQL pour Mattermost. Ne pas modifier après le déploiement — transmis à Mattermost Common comme db_user.

Important : application_database_name et application_database_user sont transmis à Mattermost Common comme db_name et db_user. Contrairement à Ghost GKE, il n'y a pas de variables abrégées db_name/db_user séparées dans Mattermost GKE — application_database_name et application_database_user servent aux deux usages.

Découverte d'instances Cloud SQL :

VariableValeur par défautDescription
sql_instance_name""Nom d'une instance Cloud SQL existante à utiliser. Laisser vide pour découvrir automatiquement une instance gérée par Services GCP ou créer une instance intégrée (inline).
sql_instance_base_name"app-sql"Nom de base pour l'instance Cloud SQL intégrée (inline) lorsqu'aucune instance existante n'est trouvée. L'ID de déploiement est ajouté.

Extensions PostgreSQL :

Mattermost ne nécessite pas d'extensions PostgreSQL personnalisées par défaut, mais le module expose des variables de gestion d'extensions pour les déploiements avancés :

VariableValeur par défautDescription
enable_postgres_extensionsfalseActive l'installation d'extensions PostgreSQL après le provisionnement.
postgres_extensions[]Liste des extensions PostgreSQL à installer (par exemple, ["pg_trgm", "btree_gin"]).

La rotation automatique des mots de passe est également prise en charge :

VariableValeur par défautDescription
enable_auto_password_rotationfalseDéploie un job de rotation automatique du mot de passe de la base de données. Lorsque true, le mot de passe de la base de données est renouvelé selon le calendrier défini par secret_rotation_period et les pods GKE sont redémarrés pour prendre en compte la nouvelle information d'identification.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer les pods, pour permettre la réplication de Secret Manager.

Groupe 12 : Scripts SQL personnalisés​

Identique à App_GKE. Voir App_GKE.


Groupe 13 : Observabilité et santé​

Ces variables se comportent de manière identique à App_GKE. Voir App_GKE.

Valeurs par défaut spécifiques à Mattermost :

Mattermost expose un point de terminaison de santé dédié à /api/v4/system/ping qui renvoie HTTP 200 et un corps de statut JSON lorsque le serveur est entièrement initialisé et prêt à accepter les connexions. startup_probe/liveness_probe utilisent ce chemin par défaut.

Routage des sondes de santé​

Mattermost GKE déclare deux ensembles de variables de sonde, mais un seul d'entre eux est réellement important :

Ensemble de variablesTransmis àConfigure
startup_probe, liveness_probeSous-module Mattermost CommonLa spécification réelle de la sonde Kubernetes du conteneur d'application — c'est ce qu'App_GKE connecte au déploiement/StatefulSet déployé (local.selected_module.startup_probe/.liveness_probe)
startup_probe_config, health_check_configApp GKE directementInerte pour Mattermost. App_GKE ne les connecte qu'à son propre préréglage interne, inutilisé gkeapp échantillon/de secours (gkeapp.tf) — elles n'atteignent jamais le conteneur Mattermost déployé

Ce ne sont pas des alias. Changer startup_probe affecte la sonde réelle déployée ; changer startup_probe_config/health_check_config n'a aucun effet sur Mattermost — laissez-les à leurs valeurs par défaut et configurez la vérification de la santé exclusivement via startup_probe/liveness_probe.

Sonde de démarrage (startup_probe → Mattermost Common) :

ChampValeur par défaut de MattermostValeur par défaut d'App GKENotes
path"/api/v4/system/ping""/healthz"Point de terminaison de disponibilité intégré de Mattermost.
initial_delay_seconds6010Mattermost exécute des migrations PostgreSQL au premier démarrage, ce qui peut prendre 30 à 60 secondes pour les grandes bases de données.
failure_threshold303Permet jusqu'à 7,5 minutes de temps de démarrage (30 × 15s). Suffisant pour les nouveaux déploiements avec migration de schéma.
period_seconds1510—

Sonde de vivacité (liveness_probe → Mattermost Common) :

ChampValeur par défaut de MattermostValeur par défaut d'App GKENotes
path"/api/v4/system/ping""/healthz"Identique à la sonde de démarrage.
initial_delay_seconds6015Donne à Mattermost un temps supplémentaire pour se stabiliser après le passage de la sonde de démarrage.
period_seconds3030—
failure_threshold33—

Variables de sonde inertes (startup_probe_config, health_check_config → App GKE) :

VariableValeur par défaut de MattermostNotes
startup_probe_config{ enabled = true, path = "/", initial_delay_seconds = 120, failure_threshold = 15 }Consommé uniquement par le préréglage de secours interne inutilisé gkeapp de App_GKE — n'a aucun effet sur le conteneur Mattermost déployé. Ne vous embêtez pas à remplacer path ; utilisez startup_probe à la place.
health_check_config{ enabled = true, path = "/" }Identique à ci-dessus — inerte pour Mattermost. Utilisez liveness_probe à la place.

uptime_check_config : Par défaut { enabled = false, path = "/" } — les tests de disponibilité sont désactivés par défaut. Activez et définissez path = "/api/v4/system/ping" pour la surveillance en production.

Métriques Prometheus : Mattermost expose les métriques Prometheus sur le port 8067. Celles-ci ne sont pas collectées automatiquement par ce module mais peuvent être consommées par Cloud Monitoring à l'aide d'un exportateur de métriques personnalisé ou d'une intégration Prometheus-vers-Cloud-Monitoring.


Groupe 14 : Politiques de fiabilité​

Identique à App_GKE. Voir App_GKE.

Variables disponibles : enable_pod_disruption_budget, pdb_min_available, enable_topology_spread, topology_spread_strict.

Note : enable_pod_disruption_budget est par défaut false dans Mattermost GKE. Activez-le pour les déploiements en production où les mises à niveau de nœuds glissantes ne doivent pas mettre tous les pods Mattermost hors ligne simultanément.


Groupe 15 : Cache Redis​

Ces variables configurent l'intégration optionnelle de Redis à Mattermost. Le support de l'infrastructure Redis sous-jacente est fourni par App_GKE (voir App_GKE) ; les variables ci-dessous sont spécifiques à Mattermost. Mattermost utilise Redis comme cache distribué et backend de session — requis pour un comportement correct sur plus d'un réplica de pod.

Note : enable_redis est par défaut false dans Mattermost GKE. Ceci est sûr pour les déploiements à réplica unique. Pour tout déploiement avec min_instance_count > 1 ou une mise à l'échelle horizontale, Redis doit être activé.

VariableValeur par défautOptions / FormatDescription et implications
enable_redisfalsetrue / falseActive Redis comme cache distribué et backend de session de Mattermost. Lorsque false, Mattermost utilise un cache intégré au processus — les requêtes acheminées vers différents réplicas de pod ne partageront pas l'état de session, ce qui entraînera des échecs d'authentification intermittents sous charge. Requis pour les déploiements multi-réplicas.
redis_host""Nom d'hôte ou adresse IPLe nom d'hôte ou l'adresse IP du serveur Redis. Laisser vide pour utiliser l'adresse IP du serveur NFS découverte automatiquement (le Redis co-hébergé par défaut de la plateforme). Remplacer par une adresse IP ou un nom d'hôte explicite lors de l'utilisation d'une instance Redis dédiée telle que Google Cloud Memorystore. Exemple : "10.128.0.10".
redis_port"6379"Chaîne de numéro de portPort TCP pour le serveur Redis. Le port standard de Redis est 6379. Ne modifier que si votre instance Redis est configurée pour écouter sur un port non standard.
redis_auth""Chaîne (sensible)Mot de passe d'authentification pour le serveur Redis. Laisser vide si l'instance Redis ne nécessite pas d'authentification. Pour les instances Memorystore avec AUTH activé, définissez-le sur la chaîne AUTH de l'instance. Traité comme sensible — non stocké en texte clair dans l'état Terraform.

Validation des paramètres du groupe 15​

Console Google Cloud :

  • Instance Memorystore (si utilisée) : Accédez à Memorystore → Redis pour confirmer que l'instance existe, son adresse IP, son port et son statut AUTH.
  • Statut Redis de Mattermost : Une fois déployé, accédez à la console système de Mattermost (Environnement → Cache) ou examinez les journaux du conteneur pour les messages d'initialisation du cache.

CLI gcloud / kubectl :

# List Memorystore Redis instances in the project (if using Memorystore)
gcloud redis instances list \
--region=REGION \
--project=PROJECT_ID \
--format="table(name,host,port,state,memorySizeGb,authEnabled)"

# Confirm Redis environment variables are set in the Mattermost pod
kubectl exec -n NAMESPACE POD_NAME -- env | grep -i redis

# Test Redis connectivity from inside the Mattermost pod
kubectl exec -n NAMESPACE POD_NAME -- \
nc -zv REDIS_HOST 6379

Groupe 16 : Domaine personnalisé et IP statique​

Identique à App_GKE. Voir App_GKE.

Configuration site_url de Mattermost : Mattermost doit connaître son URL publique au démarrage. Lorsque vous utilisez un domaine personnalisé, définissez site_url pour qu'il corresponde au domaine dans application_domains (par exemple, site_url = "https://chat.example.com"). Mattermost utilise cette URL pour les e-mails de notification, les redirections de fournisseurs OAuth et la génération de liens dans l'application — un site_url incorrect entraîne des liens de notification brisés, des échecs de connexion OAuth et des liens profonds d'application mobile incorrects.


Groupe 17 : Configuration du backend GKE​

Identique à App_GKE. Voir App_GKE.

Variables disponibles : gke_cluster_name, namespace_name, workload_type, service_type, session_affinity, enable_multi_cluster_service, configure_service_mesh, enable_network_segmentation, termination_grace_period_seconds, deployment_timeout, gke_cluster_selection_mode (valeur par défaut "primary"), network_name (valeur par défaut "" ; découverte automatique si vide), prereq_gke_subnet_cidr (valeur par défaut "10.201.0.0/24").

Note sur l'affinité de session : session_affinity est par défaut "ClientIP". Mattermost utilise des jetons de session côté serveur. Sans affinité de session, les utilisateurs peuvent rencontrer des erreurs d'authentification intermittentes lorsque les requêtes sont acheminées vers différents réplicas de pod qui ne partagent pas un cache de session en mémoire. Gardez "ClientIP" à moins que Redis ne soit activé avec un backend de session partagé.

Type de service : service_type est par défaut "LoadBalancer". Ceci provisionne un équilibreur de charge externe. Pour les déploiements Mattermost uniquement internes, changez pour "ClusterIP" et configurez un Ingress séparément.


Groupe 18 : Charges de travail avec état​

Identique à App_GKE. Voir la configuration StatefulSet décrite dans App_GKE.

La définition de stateful_pvc_enabled = true résout automatiquement workload_type en "StatefulSet". Cela fournit à chaque pod Mattermost son propre PVC dédié pour le stockage local, comme alternative au volume NFS par défaut.

Variables disponibles : stateful_pvc_enabled, stateful_pvc_size (valeur par défaut "10Gi"), stateful_pvc_mount_path (valeur par défaut "/mattermost/data"), stateful_pvc_storage_class (valeur par défaut "standard-rwo"), stateful_headless_service, stateful_pod_management_policy, stateful_update_strategy, stateful_fs_group.


Groupe 19 : Quota de ressources​

Identique à App_GKE. Voir App_GKE.

Variables disponibles : enable_resource_quota, quota_cpu_requests, quota_cpu_limits, quota_memory_requests, quota_memory_limits, quota_max_pods, quota_max_services, quota_max_pvcs.

Exigence de suffixe de quota de mémoire : quota_memory_requests et quota_memory_limits doivent utiliser des suffixes d'unité binaire (par exemple, "8Gi", "4096Mi"). Les entiers nus sont traités comme des octets par Kubernetes et bloqueront toute planification de pod.


Exploration du déploiement​

Console Google Cloud​

Charges de travail : Accédez à Kubernetes Engine → Charges de travail et filtrez par espace de noms (le nom de l'espace de noms est dérivé de application_name et tenant_id). Le déploiement ou le StatefulSet Mattermost, le job db-init et tous les CronJobs configurés apparaissent ici.

Services et Ingress : Accédez à Kubernetes Engine → Services et Ingress pour trouver le service Mattermost, son adresse IP externe et toutes les ressources Ingress configurées. Si reserve_static_ip = true, l'IP réservée apparaît sous Réseau VPC → Adresses IP.

Stockage : Accédez à Cloud Storage → Buckets et recherchez les buckets préfixés par app et votre application_name pour trouver le bucket de données Mattermost et le bucket de sauvegarde automatisée.

Base de données : Accédez à SQL pour trouver l'instance Cloud SQL PostgreSQL 15. Le nom de l'instance suit le modèle app<name><tenant><id>-sql. Cliquez sur l'instance pour afficher les connexions, les informations sur les requêtes et l'historique des sauvegardes.

Secrets : Accédez à Sécurité → Secret Manager pour afficher le DB_PASSWORD et les autres secrets provisionnés par le module. Les noms de secrets suivent le modèle app<name><tenant><id>-*.

Surveillance : Accédez à Surveillance → Tableaux de bord et Surveillance → Alertes pour afficher les tests de disponibilité (si uptime_check_config.enabled = true) et toutes les politiques d'alerte configurées via alert_policies.

CLI gcloud et kubectl​

# Get the GKE cluster credentials
gcloud container clusters get-credentials CLUSTER_NAME \
--region=REGION \
--project=PROJECT_ID

# List pods in the Mattermost namespace
kubectl get pods -n NAMESPACE

# Tail Mattermost application logs
kubectl logs -n NAMESPACE -l app=mattermost -f

# Check the db-init job status
kubectl get jobs -n NAMESPACE

# Describe the Mattermost Deployment (or StatefulSet)
kubectl describe deployment mattermost -n NAMESPACE

# Check the external IP assigned to the Service
kubectl get service -n NAMESPACE

# View environment variables injected into the Mattermost pod
kubectl exec -n NAMESPACE POD_NAME -- env | grep MM_

# Check Mattermost health endpoint directly from inside the pod
kubectl exec -n NAMESPACE POD_NAME -- \
curl -s http://localhost:8065/api/v4/system/ping

# View Cloud SQL instance details
gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID \
--format="table(name,databaseVersion,state,ipAddresses)"

# List GCS buckets for this deployment
gcloud storage buckets list \
--project=PROJECT_ID \
--filter="name~mattermost"

# View Secret Manager secrets for this deployment
gcloud secrets list \
--project=PROJECT_ID \
--filter="name~mattermost"

Sorties du module​

Mattermost GKE expose les sorties Terraform suivantes :

SortieDescription
service_nameNom du service Kubernetes
service_urlURL du service
service_external_ipAdresse IP externe de l'équilibreur de charge
project_idID du projet GCP
deployment_idSuffixe de l'ID de déploiement
namespaceEspace de noms Kubernetes
database_instance_nameNom de l'instance Cloud SQL
database_nameNom de la base de données de l'application
database_userNom de l'utilisateur de la base de données de l'application
database_password_secretNom du secret Secret Manager pour le mot de passe de la base de données
storage_bucketsBuckets de stockage GCS créés
container_imageImage de conteneur utilisée pour le déploiement
cicd_enabledIndique si le pipeline CI/CD est activé
github_repository_urlURL du dépôt GitHub connecté pour le CI/CD
kubernetes_readytrue lorsque le point de terminaison du cluster GKE est accessible et que toutes les ressources de charge de travail Kubernetes sont déployées. false lors du premier apply d'un nouveau cluster intégré (inline) — le cluster est créé mais le point de terminaison n'est pas encore lisible, de sorte que les ressources Kubernetes sont ignorées. Le pipeline CI/CD doit réexécuter apply pour terminer le déploiement.

Pièges de configuration et valeurs par défaut judicieuses​

Niveaux de risque : Critique (perte de données, panne complète, faille de sécurité) — Élevé (service indisponible ou dégradation significative) — Moyen (fonction dégradée ou coût accru) — Faible (impact mineur).

VariableValeur par défaut judicieuseRisqueConséquence d'une valeur incorrecte
project_id(requis)CritiquePas de valeur par défaut — le déploiement échoue immédiatement.
database_type"POSTGRES_15"CritiqueMattermost ne prend en charge que PostgreSQL. La définition à MYSQL_8_0 ou NONE entraîne l'échec du job db-init et le crash de Mattermost au démarrage.
application_database_name"mattermost"CritiqueImmuable après le déploiement — la modification recrée la base de données et détruit toutes les données Mattermost (canaux, messages, utilisateurs).
application_database_user"mattermost"CritiqueImmuable après le déploiement — la modification recrée l'utilisateur, invalide les informations d'identification et interrompt la connexion de Mattermost à la base de données.
site_url"" (dérivé de l'URL de l'équilibreur de charge)Élevé avec un domaine personnaliséVide est dérivé au démarrage de l'URL de l'équilibreur de charge ; sur un domaine personnalisé, définissez-le avant d'inviter des utilisateurs, sinon les liens et les redirections OAuth utiliseront l'adresse de l'équilibreur de charge.
edition"team"ÉlevéLa définition de "enterprise" sans clé de licence valide entraîne le démarrage de Mattermost dans un état sans licence et désactive silencieusement les fonctionnalités d'entreprise. Fournissez la clé via environment_variables.
enable_redisfalseÉlevéSûr pour les déploiements à réplica unique. Pour min_instance_count > 1, la mise en cache de session intégrée au processus entraîne des échecs d'authentification intermittents lorsque les requêtes sont équilibrées entre les pods. Activez Redis pour tout déploiement multi-réplicas.
min_instance_count1ÉlevéLa définition de 0 permet la mise à l'échelle à zéro. Les démarrages à froid interrompent les connexions WebSocket actives, ce qui fait que les utilisateurs voient des bannières de déconnexion et manquent les messages en temps réel jusqu'à la reconnexion. Gardez à 1 pour la production.
container_resources.memory_limit"4Gi"ÉlevéMattermost met en cache les canaux actifs et les sessions utilisateur en mémoire. Un sous-provisionnement (inférieur à 2Gi) provoque des arrêts OOM sous une charge d'équipe modérée, en particulier lors d'exportations de messages en masse ou d'exécution de plugins.
session_affinity"ClientIP"ÉlevéSans Redis et sans affinité de session, les sessions d'administrateur et d'utilisateur ne sont pas partagées entre les pods. Les utilisateurs sont effectivement déconnectés à chaque requête acheminée vers un réplica différent.
container_port8065CritiqueMattermost écoute sur 8065. La modification sans faire correspondre le port lié du conteneur entraîne l'échec de toutes les sondes de santé et le pod entre dans une boucle de redémarrage.
timeout_seconds300MoyenLes connexions WebSocket de Mattermost sont de longue durée. Un délai d'attente de backend de 300 secondes entraîne la coupure régulière des connexions actives. Définissez à 3600 pour les déploiements à forte utilisation de WebSocket.
enable_nfstrueMoyenNFS est activé par défaut et contient les téléchargements. Si vous le désactivez sans configurer de stockage compatible S3 ou gcs_volumes, les téléchargements de fichiers Mattermost sont stockés dans le système de fichiers éphémère du conteneur et perdus au redémarrage du pod.
create_cloud_storagefalseMoyenAucun bucket GCS n'est provisionné automatiquement par ce module. Sans create_cloud_storage = true et une entrée gcs_volumes, les fichiers téléchargés ne sont pas durables après les redémarrages de pod.
stateful_pvc_size"10Gi"MoyenPour les équipes qui partagent activement des fichiers et des médias, 10Gi se remplit rapidement. Provisionnez 50 à 100 Gi pour les équipes actives. La taille du PVC peut être étendue mais pas réduite.
quota_memory_requests / quota_memory_limits""Critique (spécifique à GKE)Doit utiliser des suffixes binaires (Gi, Mi) lorsqu'il est défini. Les entiers nus sont traités comme des octets et empêchent la planification de tous les pods.
backup_retention_days7MoyenTrop court pour les équipes actives. Augmentez à plus de 30 jours pour offrir une fenêtre de récupération significative.
enable_cloud_armorfalseMoyenSans Cloud Armor, la page de connexion et les points de terminaison d'API de Mattermost sont exposés aux attaques par force brute et par bourrage d'identifiants. Activez-le pour tout déploiement accessible publiquement.
enable_pod_disruption_budgetfalseMoyenDésactivé par défaut. Sans PDB, les mises à niveau de nœuds GKE peuvent arrêter tous les pods Mattermost simultanément, entraînant une panne complète. Activez-le pour la production.
startup_probe.failure_threshold30ÉlevéMattermost exécute des migrations de schéma PostgreSQL au premier démarrage. La réduction de failure_threshold en dessous de 20 sur les nouveaux déploiements avec de grandes bases de données peut entraîner le redémarrage du pod par Kubernetes avant la fin des migrations, créant une boucle de redémarrage.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.