Aller au contenu principal

Mattermost sur Google Cloud Run

Mattermost sur Google Cloud Run

Ce document fournit une référence complète pour le module modules/Mattermost_CloudRun. Il couvre l'architecture, la gestion des identités et des accès (IAM), les variables de configuration, les comportements spécifiques à Mattermost et les modèles opérationnels pour le déploiement de Mattermost sur Google Cloud Run (v2).


Ce que coûte Mattermost sur RAD, et comparaison​

Mattermost sur le module Cloud Run de RAD coûte environ 170 US$ par mois dans votre propre projet, un prix fixe quel que soit le nombre d'utilisateurs. RAD facture 175 crédits une fois par déploiement dans votre propre projet (157,5 crédits, soit 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. Mattermost se déploie également sur GKE Autopilot pour environ 150 US$ par mois — consultez le guide GKE si vous avez besoin qu'il y soit exécuté à la place. 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 ne représente que quelques dollars — 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éploiement175 crédits (17,50 US$ au prix de la recharge)157,5 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 buildIdentique
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 170 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 108 crédits par jour, soit environ 3 240 par mois (environ 324 US$ au prix de la recharge)
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

10 crédits coûtent 1 US$ pour une recharge unique, et moins pour un plan 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 de deuxième base de données.

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

Ressource (module par défaut)Par mois
Cloud Run, 2x vCPU / 2 GiB (alwaysOn)100 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$
Totalenviron 170 US$

Comparaison​

  • Slack, facturé 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é relevés sur slack.com depuis le Royaume-Uni.
  • Le module Mattermost de RAD coûte un forfait d'environ 170 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 la 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 vous gérez alors vous-même PostgreSQL, le stockage de fichiers, les correctifs de sécurité et la disponibilité.

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

Si Mattermost s'exécute 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 — pour l'évaluer, un environnement de démonstration, une charge de travail saisonnière ou intermittente — que de l'exécuter 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. La restauration ne peut donc 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. La facturation étant déjà déliée, rien n'est facturé pendant cette période d'attente. 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 Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — 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 324 US$ par mois pour le maintenir en fonctionnement. Déployez Mattermost, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour le temps où il était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet pour lequel RAD ne gère que 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 niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'évaluation conviennent). Google indique que la plupart des services sont à 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 que vous 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 redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) — 175 crédits (17,50 US$) au total. La suppression ne permet d'économiser de l'argent que si Mattermost devait rester inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 4 jours ou plus, à la fois dans votre propre projet (environ 5,68 US$ par jour) et dans un projet géré par RAD (108 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 fichiers/cache partagée. Ils ne s'arrêtent que si 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 en premier. 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 interrompue 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.

1. Vue d'ensemble du module​

Mattermost est une plateforme de messagerie et de collaboration d'équipe open source, auto-hébergeable — une alternative sécurisée à Slack avec des canaux persistants, des messages directs, le partage de fichiers, des intégrations, des bots, des commandes slash et des fonctionnalités de sécurité d'entreprise. Mattermost CloudRun est un module enveloppe construit au-dessus de App CloudRun. Il utilise App CloudRun pour toutes les provisions d'infrastructure GCP et injecte la configuration d'application spécifique à Mattermost, l'initialisation de la base de données et le stockage via Mattermost Common.

Capacités clés :

  • Calcul : Cloud Run v2 (Gen2), conteneur Mattermost personnalisé, 2 vCPU / 2 Gi par défaut. Le nombre minimal d'instances est de 1 par défaut — Mattermost maintient des connexions WebSocket persistantes pour la messagerie en temps réel, ce qui rend la mise à l'échelle à zéro inadaptée à la plupart des déploiements.
  • Persistance des données : Cloud SQL PostgreSQL 15. Le volume NFS partagé est monté à /mattermost/data par défaut (enable_nfs = true), de sorte que les téléchargements de fichiers et les pièces jointes survivent aux redémarrages et aux nouvelles révisions.
  • Sécurité : Hérite de Cloud Armor WAF, IAP, Binary Authorization et VPC Service Controls de App CloudRun. Mattermost génère ses propres clés de signature internes au premier démarrage et les stocke dans la base de données — aucun secret au niveau de l'application n'est auto-généré par ce module.
  • Mise en cache : Redis est facultatif (enable_redis = false par défaut). Lorsqu'il est activé, Mattermost utilise Redis comme cache distribué et backend de session — requis pour un comportement correct sur plusieurs réplicas.
  • Éditions : Team Edition (gratuite, par défaut) ou Enterprise Edition (licence payante requise). Contrôlé par la variable edition.
  • Messagerie en temps réel : Mattermost maintient des connexions WebSocket pour la livraison de messages en temps réel. Le délai d'expiration de 60 minutes des requêtes de Cloud Run signifie que timeout_seconds doit être défini sur 3600 pour les déploiements à forte utilisation de WebSocket. Pour les charges de travail de production nécessitant des connexions persistantes et de longue durée, envisagez Mattermost GKE.

Identité du projet et de l'application

VariableGroupeTypeValeur par défautDescription
project_id1string—ID du projet GCP. Obligatoire.
tenant_id1string'demo'Suffixe court ajouté à tous les noms de ressources.
support_users1list(string)[]Destinataires des e-mails pour l'accès IAM et les alertes de surveillance.
resource_labels1map(string){}Libellés appliqués à toutes les ressources provisionnées.
application_name3string'mattermost'Nom de ressource de base. Ne pas modifier après le déploiement initial.
display_name3string'Mattermost'Nom lisible par l'homme affiché dans l'interface utilisateur de la plateforme.
description3string'Mattermost - Open-source team messaging and collaboration'Description du service Cloud Run.
application_version3string'9.11.2'Balise de version de l'image Mattermost. Incrémenter pour déployer une nouvelle version.

Architecture de l'enveloppe : Mattermost CloudRun appelle Mattermost Common pour construire un objet application_config contenant les variables d'environnement spécifiques à Mattermost, la configuration de la sonde et la définition du job db-init. module_storage_buckets contient tout bucket de données GCS configuré pour le montage FUSE. scripts_dir est résolu au répertoire de scripts Mattermost Common au moment de l'apply.


2. IAM et contrôle d'accès​

Mattermost_CloudRun délègue toutes les provisions IAM à App_CloudRun. Les ensembles de rôles du compte de service Cloud Run, du compte de service Cloud Build, de l'agent de service IAP et de la rotation des mots de passe sont identiques à ceux de App_CloudRun.

Aucun secret au niveau de l'application auto-généré : Contrairement à de nombreux autres modules d'application, Mattermost Common ne génère pas automatiquement de secrets d'application tels qu'un SECRET_KEY. Mattermost génère ses propres clés de signature internes au premier démarrage et les stocke dans PostgreSQL. Les secrets DB_PASSWORD et ROOT_PASSWORD sont provisionnés automatiquement par App CloudRun et consommés par le job db-init.

Identité d'initialisation de la base de données : Le job Cloud Run db-init s'exécute sous le compte de service Cloud Run. Il se connecte à Cloud SQL PostgreSQL via le socket Unix du proxy d'authentification, en utilisant DB_HOST, DB_USER et le secret DB_PASSWORD de Secret Manager.

Délai de propagation IAM de 120 secondes : Hérité de App CloudRun — le service Mattermost n'est pas déployé tant que le délai n'est pas terminé, ce qui empêche les échecs de lecture de secrets au démarrage de la première révision.


3. Configuration du service principal​

A. Calcul (Cloud Run)​

Mattermost est une application basée sur Go qui est économe en ressources au démarrage, mais qui bénéficie d'une allocation CPU constante pour la gestion des connexions WebSocket et la livraison des messages. Mattermost CloudRun expose cpu_limit et memory_limit comme variables de niveau supérieur.

Le nombre minimal d'instances est de 1 par défaut (min_instance_count = 1). Cela empêche les démarrages à froid de la mise à l'échelle à zéro qui interrompraient les connexions WebSocket actives. Pour les environnements de développement ou sensibles aux coûts, min_instance_count = 0 est pris en charge mais entraînera la perte des sessions utilisateur lorsque l'instance sera réduite.

Le boost CPU au démarrage est toujours activé (codé en dur dans App CloudRun).

Image de conteneur : container_image_source est par défaut 'custom', ce qui signifie que Cloud Build compile une image personnalisée à l'aide du Dockerfile de Mattermost Common (basé sur l'image officielle mattermost/mattermost-team-edition ou mattermost/mattermost-enterprise-edition, selon edition). Définissez container_image_source = 'prebuilt' et container_image sur un URI d'image pour ignorer l'étape de build.

VariableGroupeValeur par défautDescription
deploy_application4trueDéfinissez false pour un déploiement uniquement d'infrastructure (SQL, stockage, secrets).
container_image_source4'custom''custom' construit via Cloud Build. 'prebuilt' déploie un URI d'image existant.
container_image4""Remplace l'URI de l'image. Laissez vide pour que Cloud Build gère l'image.
cpu_limit4'2000m'CPU par instance. 2 vCPU recommandés pour Mattermost.
memory_limit4'2Gi'Mémoire par instance. 2 Gi est le minimum ; augmenter pour les grandes équipes.
cpu_always_allocated4trueCPU alloué en permanence (facturation basée sur l'instance). Maintenu true : les connexions WebSocket en temps réel nécessitent une instance non limitée (à associer à min_instance_count >= 1).
container_resources4nullLorsqu'il est défini, remplace cpu_limit et memory_limit.
min_instance_count41Maintenez à 1 pour la production afin d'éviter les interruptions de WebSocket.
max_instance_count41Plafond de coût pour l'auto-mise à l'échelle.
container_port48065Port HTTP natif de Mattermost.
execution_environment4'gen2'Gen2 requis pour les montages de volume GCS Fuse.
timeout_seconds4300Durée maximale de la requête. Définir sur 3600 pour les déploiements à forte utilisation de WebSocket.
enable_cloudsql_volume4trueInjecte le sidecar Cloud SQL Auth Proxy. Définir false pour TCP.
container_protocol4'http1''http1' ou 'h2c'.
enable_image_mirroring4trueMet en miroir l'image Mattermost dans Artifact Registry.
traffic_split4[]Allocation de trafic canary/bleu-vert basée sur un pourcentage.
max_revisions_to_retain47Nombre maximal de révisions Cloud Run à conserver. Définir 0 pour désactiver.
service_annotations4{}Annotations Cloud Run avancées.
service_labels4{}Libellés appliqués au service Cloud Run.

Différences par rapport aux valeurs par défaut de App CloudRun :

VariableApp CloudRunMattermost CloudRunRaison
container_port80808065Port natif de Mattermost.
cpu_limit'1000m''2000m'Mattermost gère les connexions WebSocket concurrentes et l'indexation des messages.
memory_limit'512Mi''2Gi'Mattermost met en cache les canaux, les utilisateurs et les sessions en mémoire.
min_instance_count01La mise à l'échelle à zéro interrompt les connexions WebSocket actives des utilisateurs.
cpu_always_allocatedfalsetrueLa livraison WebSocket en temps réel ne doit pas être limitée par le CPU entre les requêtes.

B. Base de données (Cloud SQL — PostgreSQL 15)​

Mattermost nécessite PostgreSQL 13 ou une version ultérieure — PostgreSQL 15 est la valeur par défaut. Mattermost exécute ses propres migrations de schéma au démarrage ; aucune configuration manuelle du schéma de base de données n'est nécessaire au-delà de la création de la base de données et de l'utilisateur (gérée par le job db-init).

Le module utilise les variables abrégées db_name et db_user qui transitent par Mattermost Common vers la configuration de l'application.

VariableGroupeValeur par défautDescription
database_type12'POSTGRES_15'Moteur de base de données Cloud SQL. Ne pas modifier à partir de PostgreSQL.
db_name12'mattermost'Nom de la base de données PostgreSQL. Ne pas modifier après le déploiement initial.
db_user12'mattermost'Utilisateur de l'application PostgreSQL. Mot de passe auto-généré et stocké dans Secret Manager.
database_password_length1232Longueur du mot de passe auto-généré. Plage : 16–64.
enable_auto_password_rotation12falseRotation automatisée du mot de passe sans interruption de service.
rotation_propagation_delay_sec1290Secondes à attendre après la rotation avant de redémarrer le service.

C. Stockage (NFS)​

Mattermost stocke les fichiers téléchargés, les pièces jointes et les données de plugin sous /mattermost/data. Sans stockage persistant, tous les téléchargements d'utilisateurs sont perdus lors du redémarrage du conteneur ou du déploiement d'une nouvelle révision.

Par défaut, le volume NFS partagé est monté à /mattermost/data (enable_nfs = true, nfs_mount_path = "/mattermost/data"), ce qui est l'emplacement vers lequel MM_FILESETTINGS_DIRECTORY pointe — les téléchargements sont donc durables sans configuration supplémentaire. Le montage d'un bucket GCS à cet endroit avec gcs_volumes est une alternative uniquement si vous désactivez NFS ; ne montez pas les deux au même chemin.

VariableGroupeValeur par défautDescription
enable_nfs11trueMonte le volume NFS partagé à nfs_mount_path, où Mattermost conserve les téléchargements. Laissez-le activé à moins que vous ne montiez un autre stockage durable à cet endroit.
nfs_mount_path11'/mattermost/data'Chemin du conteneur où NFS est monté.
nfs_instance_name11""Nom de la VM GCE NFS existante. Laissez vide pour la découverte automatique.
nfs_instance_base_name11'app-nfs'Nom de base de la VM GCE NFS intégrée (inline).
create_cloud_storage11trueDéfinissez false pour ignorer la création du bucket GCS.
storage_buckets11[]Buckets GCS supplémentaires à provisionner.
gcs_volumes11[]Buckets GCS à monter via GCS Fuse. Chaque entrée : name, bucket_name, mount_path, readonly, mount_options. Uniquement nécessaire à /mattermost/data si NFS est désactivé.
manage_storage_kms_iam11falseCrée une clé CMEK KMS et active CMEK sur tous les buckets de stockage.
enable_artifact_registry_cmek11falseCrée une clé KMS Artifact Registry pour le chiffrement des images au repos.

Alternative (NFS désactivé) : un volume GCS FUSE pour le stockage de fichiers Mattermost :

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

D. Réseau​

Cloud Run utilise Direct VPC Egress pour atteindre l'adresse IP privée de Cloud SQL. Le sidecar Auth Proxy (enable_cloudsql_volume = true) gère la connexion à la base de données via un socket Unix.

VariableGroupeValeur par défautDescription
ingress_settings5'all''all' — internet public ; 'internal' — VPC uniquement ; 'internal-and-cloud-load-balancing' — force le trafic via l'équilibreur de charge HTTPS.
vpc_egress_setting5'PRIVATE_RANGES_ONLY''PRIVATE_RANGES_ONLY' achemine uniquement le trafic RFC 1918 via VPC. 'ALL_TRAFFIC' achemine tout le trafic sortant via VPC.

E. Initialisation et amorçage​

Un job Cloud Run db-init est automatiquement provisionné par Mattermost Common lorsque initialization_jobs est laissé comme liste vide par défaut ([]). Il utilise une image basée sur postgres et exécute Mattermost_Common/scripts/db-init.sh, qui effectue les opérations idempotentes suivantes :

  1. Se connecte à Cloud SQL PostgreSQL via le socket Unix du proxy d'authentification.
  2. Crée la base de données mattermost si elle n'existe pas.
  3. Crée l'utilisateur mattermost avec le mot de passe de Secret Manager.
  4. Accorde à l'utilisateur tous les privilèges sur la base de données.

Mattermost exécute ensuite ses propres migrations de schéma au premier démarrage — aucune configuration manuelle du schéma n'est requise.

VariableGroupeValeur par défautDescription
initialization_jobs13[]Jobs Cloud Run ponctuels. Laissez vide pour que Mattermost Common fournisse le job db-init par défaut. Une liste non vide le remplace entièrement. Chaque entrée : name, description, image, command, args, env_vars, secret_env_vars, cpu_limit, memory_limit, timeout_seconds, max_retries, task_count, execution_mode, mount_nfs, mount_gcs_volumes, depends_on_jobs, execute_on_apply, script_path.
cron_jobs13[]Jobs Cloud Run récurrents déclenchés par Cloud Scheduler. Chaque entrée : name, schedule, image, command, args, env_vars, secret_env_vars, cpu_limit, memory_limit, timeout_seconds, max_retries, task_count, parallelism, mount_nfs, mount_gcs_volumes, script_path, paused.

4. Sécurité avancée​

A. Cloud Armor WAF​

Lorsque enable_cloud_armor = true, un équilibreur de charge HTTPS global avec une politique Cloud Armor WAF (OWASP Top 10, DDoS adaptatif, limitation de débit de 500 requêtes/min) est provisionné devant Cloud Run.

VariableGroupeValeur par défautDescription
enable_cloud_armor10falseProvisionne un équilibreur de charge HTTPS global + Cloud Armor WAF. Requis pour les domaines personnalisés, le CDN et la protection DDoS.
admin_ip_ranges10[]Plages CIDR exemptées des règles WAF (par exemple, VPN de bureau, adresses IP de sortie CI/CD).

B. Proxy d'identité (IAP)​

Lorsque enable_iap = true, l'intégration IAP native de Cloud Run est activée sur le service. L'authentification Google Identity est requise avant que les requêtes n'atteignent Mattermost. Utile pour les déploiements internes uniquement où les utilisateurs doivent s'authentifier avec le compte Google Workspace de leur organisation avant d'atteindre la page de connexion Mattermost.

VariableGroupeValeur par défautDescription
enable_iap5falseActive IAP nativement sur le service Cloud Run.
iap_authorized_users5[]Utilisateurs/comptes de service ayant accès à IAP. Format : 'user:email' ou 'serviceAccount:sa@...'.
iap_authorized_groups5[]Groupes Google ayant accès à IAP. Format : 'group:name@example.com'.

C. Autorisation binaire​

Lorsque enable_binary_authorization = true, Cloud Run impose que les images Mattermost déployées portent une attestation cryptographique valide.

VariableGroupeValeur par défautDescription
enable_binary_authorization8falseApplique l'attestation d'image. Nécessite une politique d'autorisation binaire et un attestateur préconfigurés dans le projet.

D. Contrôles de service VPC​

Lorsque enable_vpc_sc = true, tous les appels d'API GCP de ce module sont liés à un périmètre VPC-SC existant.

VariableGroupeValeur par défautDescription
enable_vpc_sc22falseEnregistre les appels d'API du module dans le périmètre VPC-SC du projet. Un périmètre doit déjà exister avant l'activation.

E. Intégration de Secret Manager​

Les secrets d'application Mattermost sont stockés dans Secret Manager et injectés nativement par Cloud Run au démarrage de la révision — le texte en clair n'est jamais écrit dans l'état. Des secrets définis par l'utilisateur peuvent être ajoutés via secret_environment_variables.

VariableGroupeValeur par défautDescription
secret_environment_variables6{}Mappage nom de variable d'environnement → ID de secret Secret Manager. Résolu à l'exécution.
explicit_secret_values6{}Valeurs sensibles brutes écrites dans Secret Manager pendant le déploiement.
secret_rotation_period6'2592000s'Fréquence de notification de rotation de Secret Manager. Par défaut : 30 jours.
secret_propagation_delay630Secondes à attendre après la création du secret avant que les ressources dépendantes ne continuent.

5. Trafic et entrée​

A. Équilibreur de charge HTTPS​

Lorsque enable_cloud_armor = true, un équilibreur de charge HTTPS global soutenu par un NEG sans serveur est provisionné. Le trafic circule : Internet → Cloud Armor → Équilibreur de charge HTTPS global → NEG sans serveur → Cloud Run.

La définition de ingress_settings = 'internal-and-cloud-load-balancing' force tout le trafic Mattermost à passer par l'équilibreur de charge, empêchant l'accès direct à l'URL *.run.app.

B. Cloud CDN​

Lorsque enable_cdn = true (nécessite enable_cloud_armor = true), Cloud CDN est attaché au backend de l'équilibreur de charge HTTPS.

Considération Mattermost : Mattermost sert un mélange de trafic API en temps réel (WebSocket, REST) et d'actifs statiques (bundles JavaScript, CSS, fichiers de plugins). Cloud CDN est adapté à la livraison d'actifs statiques mais ne doit pas mettre en cache les réponses API ou les mises à niveau WebSocket. Mattermost définit les en-têtes Cache-Control appropriés sur ses actifs statiques, de sorte que le CDN peut être activé en toute sécurité pour la mise en cache en périphérie du bundle d'application.

VariableGroupeValeur par défautDescription
enable_cdn10falseActive Cloud CDN sur le backend de l'équilibreur de charge HTTPS. N'est efficace que lorsque enable_cloud_armor = true.
max_images_to_retain107Nombre maximal d'images de conteneurs à conserver dans Artifact Registry. Définir 0 pour désactiver.
delete_untagged_images10trueSupprime automatiquement les images non étiquetées d'Artifact Registry.
image_retention_days1030Jours après lesquels les images sont éligibles à la suppression. Définir 0 pour désactiver la suppression basée sur l'âge.

C. Domaines personnalisés​

Les domaines personnalisés sont attachés à l'équilibreur de charge HTTPS global via application_domains. Les certificats SSL gérés par Google sont provisionnés automatiquement. Le DNS doit pointer vers l'adresse IP de l'équilibreur de charge après l'apply.

VariableGroupeValeur par défautDescription
application_domains10[]Noms de domaine personnalisés. Certificats SSL gérés par Google provisionnés par domaine.

Après le premier apply, récupérez l'adresse IP de l'équilibreur de charge et créez un enregistrement A. Le provisionnement du certificat SSL prend 10 à 30 minutes après la propagation DNS. Ensuite, définissez site_url sur le domaine personnalisé afin que Mattermost génère des liens d'invitation et des URL de webhook corrects.


6. CI/CD et livraison​

A. Déclencheurs Cloud Build​

Lorsque enable_cicd_trigger = true, une connexion GitHub Cloud Build et un déclencheur de push sont provisionnés. Le déclencheur construit et déploie une image Mattermost personnalisée lorsque du code est poussé vers la branche configurée.

VariableGroupeValeur par défautDescription
enable_cicd_trigger8falseProvisionne un déclencheur GitHub Cloud Build. Nécessite github_repository_url et des identifiants.
github_repository_url8""URL HTTPS complète du dépôt GitHub.
github_token8""PAT GitHub (scopes repo, admin:repo_hook). Requis lors du premier apply. Sensible.
github_app_installation_id8""ID d'installation de l'application GitHub (préféré pour les dépôts d'organisation).
cicd_trigger_config8{ branch_pattern = "^main$" }Configuration avancée du déclencheur : branch_pattern, included_files, ignored_files, trigger_name, substitutions.

B. Pipeline Cloud Deploy​

Lorsque enable_cloud_deploy = true (nécessite enable_cicd_trigger = true), le pipeline CI/CD est mis à niveau vers un pipeline de livraison Cloud Deploy géré avec des étapes de promotion séquentielles.

VariableGroupeValeur par défautDescription
enable_cloud_deploy8falseProvisionne un pipeline Cloud Deploy. Nécessite enable_cicd_trigger = true.
cloud_deploy_stages8[dev, staging, prod(approval)]Étapes de promotion ordonnées. Chaque : name, target_name, service_name, require_approval, auto_promote.

7. Fiabilité et planification​

A. Mise à l'échelle et concurrence​

min_instance_count est défini par défaut sur 1 — Mattermost maintient des connexions WebSocket actives pour la messagerie en temps réel, et la mise à l'échelle à zéro déconnecterait tous les utilisateurs actifs. max_instance_count est défini par défaut sur 1 : Mattermost Team Edition n'a pas de clustering HA (une fonctionnalité Enterprise), donc une deuxième instance ne partage pas l'état WebSocket, de session ou de cache — les clients sur différentes instances cessent de voir les messages des autres en temps réel. N'augmentez cette valeur qu'avec une licence Enterprise et un clustering configuré.

B. Répartition du trafic​

La répartition du trafic est prise en charge pour les déploiements canary.

VariableGroupeValeur par défautDescription
traffic_split4[]Allocation de trafic basée sur un pourcentage entre les révisions nommées. Toutes les entrées doivent totaliser 100. Vide envoie 100 % à la dernière révision.

C. Sondes de santé et surveillance de la disponibilité​

Mattermost expose un point de terminaison de santé dédié à /api/v4/system/ping qui renvoie HTTP 200 lorsque l'application est entièrement initialisée et connectée à la base de données. Les sondes de santé ciblent ce point de terminaison.

Mattermost effectue des migrations de schéma au premier démarrage. La sonde de démarrage laisse suffisamment de temps pour que la migration se termine avant que le trafic ne soit dirigé vers la nouvelle révision.

VariableGroupeValeur par défautDescription
startup_probe14{ enabled=true, type="HTTP", path="/", initial_delay_seconds=60, period_seconds=15, failure_threshold=30 }Sonde de démarrage. Le conteneur ne reçoit pas de trafic tant que celle-ci n'a pas réussi.
liveness_probe14{ enabled=true, type="HTTP", path="/", initial_delay_seconds=60, timeout_seconds=5, period_seconds=30, failure_threshold=3 }Sonde de vivacité. Le conteneur est redémarré après failure_threshold échecs consécutifs.
startup_probe_config14{ enabled=true, path="/", initial_delay_seconds=60 }Inerte pour Mattermost. App_CloudRun ne fait que le connecter à son propre préréglage d'échantillon/de secours interne et inutilisé cloudrunapp (cloudrunapp.tf) — il n'atteint jamais le service Mattermost déployé.
health_check_config14{ enabled=true, path="/", initial_delay_seconds=60 }Inerte pour Mattermost, identique à startup_probe_config ci-dessus.
uptime_check_config14{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring (désactivé par défaut). Lorsqu'il est activé, des alertes notifient support_users si inaccessible.
alert_policies14[]Politiques d'alerte métrique Cloud Monitoring.

Remarque sur le chemin de la sonde : Les sondes réellement déployées proviennent uniquement de startup_probe/liveness_probe (transférées à Mattermost_Common, puis dans App_CloudRun's local.selected_module.startup_probe/.liveness_probe) — celles-ci sont par défaut à path = "/" dans le module Cloud Run, tandis que la variante GKE est par défaut à /api/v4/system/ping. Pour une signalisation de santé plus précise dans Cloud Run, remplacez startup_probe/liveness_probe's path par /api/v4/system/ping. startup_probe_config/health_check_config sont une paire de variables distinctes et inertes (voir tableau ci-dessus) — les remplacer n'a aucun effet sur les sondes déployées de Mattermost, donc ne vous en souciez pas.

D. Rotation automatique des mots de passe​

Lorsque enable_auto_password_rotation = true, un pipeline de rotation de mot de passe sans interruption de service est provisionné :

  1. Secret Manager émet une notification de rotation à chaque intervalle de secret_rotation_period.
  2. Eventarc déclenche un job de rotation Cloud Run.
  3. Le job génère un nouveau mot de passe, met à jour l'utilisateur Cloud SQL, écrit une nouvelle version du secret.
  4. Après rotation_propagation_delay_sec secondes, le job redémarre le service Mattermost.
VariableGroupeValeur par défautDescription
enable_auto_password_rotation12falseActive la rotation automatique des mots de passe.
rotation_propagation_delay_sec1290Secondes à attendre après l'écriture du nouveau secret avant de redémarrer.

8. Intégrations​

A. Paramètres de l'application Mattermost​

VariableGroupeValeur par défautDescription
site_url20""L'URL publique où Mattermost est accessible. Définit MM_SERVICESETTINGS_SITEURL. Si vide, elle est dérivée au démarrage de l'URL du service Cloud Run ; définissez-la pour un domaine personnalisé. (par exemple, 'https://chat.example.com')
edition20'team''team' (gratuit) ou 'enterprise' (payant — nécessite une clé de licence définie via environment_variables). Contrôle l'image de conteneur Mattermost sélectionnée.

URL du site. Mattermost utilise SiteURL pour les liens d'invitation, les e-mails et les rappels OAuth. Si site_url est vide, le point d'entrée le définit au démarrage à partir de l'URL du service Cloud Run ; définissez site_url explicitement lorsque vous servez Mattermost sur un domaine personnalisé.

B. Variables d'environnement​

Mattermost est entièrement configuré via des variables d'environnement utilisant le préfixe MM_. La variable environment_variables accepte toute clé de configuration Mattermost :

VariableGroupeValeur par défautDescription
environment_variables6{}Variables d'environnement en texte brut. À utiliser pour la configuration de Mattermost telle que l'e-mail, les plugins et les paramètres de service.

Variables de configuration Mattermost courantes injectées automatiquement par Mattermost Common :

Variable d'environnementValeurObjectif
MM_SERVICESETTINGS_LISTENADDRESS:8065Adresse de liaison pour le serveur HTTP Mattermost.
MM_METRICSSETTINGS_LISTENADDRESS:8067Point de terminaison des métriques Prometheus.
MM_FILESETTINGS_DRIVERTYPElocalType de stockage de fichiers — fichiers locaux sous le répertoire monté.
MM_FILESETTINGS_DIRECTORY/mattermost/data/Chemin de stockage de fichiers — correspond au point de montage GCS FUSE ou NFS.
MM_LOGSETTINGS_CONSOLELEVELINFONiveau de journalisation envoyé à stdout (capturé par Cloud Logging).
MM_LOGSETTINGS_ENABLEFILEfalseJournalisation basée sur les fichiers désactivée — Cloud Run capture stdout vers Cloud Logging.
MM_SERVICESETTINGS_TRUSTEDPROXYIPHEADERX-Forwarded-ForActive l'extraction correcte de l'IP client à partir des en-têtes de proxy Cloud Run et de l'équilibreur de charge.
MM_EMAILSETTINGS_ENABLEEMAILBATCHINGfalseDésactivé pour la compatibilité Cloud Run scale-to-zero. Le traitement par lots des e-mails nécessite des files d'attente en mémoire persistantes.
MM_CACHEBACKENDredis ou memoryDéfini sur redis lorsque enable_redis = true ; sinon memory.
MM_REDIS_ADDRESSHôte Redis:portInjecté lorsque enable_redis = true.

C. Cache Redis​

Redis est désactivé par défaut (enable_redis = false). Activez Redis pour tout déploiement exécutant plus d'une instance — sans Redis, plusieurs instances Mattermost ne peuvent pas partager l'état de session ou les caches, ce qui entraîne des échecs d'authentification intermittents et des données obsolètes.

VariableGroupeValeur par défautDescription
enable_redis21falseActive Redis pour la mise en cache et le stockage de sessions Mattermost. Recommandé pour les déploiements multi-réplicas.
redis_host21""Nom d'hôte ou IP du serveur Redis. Laissez vide pour utiliser l'IP du serveur NFS lorsque enable_redis = true. Remplacez par une instance Memorystore pour la production.
redis_port21'6379'Port TCP du serveur Redis (chaîne).
redis_auth21""Mot de passe d'authentification Redis. Laissez vide si l'authentification n'est pas requise. Sensible — jamais stocké dans l'état.

D. Métriques​

Mattermost expose des métriques au format Prometheus sur le port 8067 (/metrics). Activez les métriques dans la console système Mattermost sous Environment → Performance Monitoring, puis intégrez-les à Google Cloud Monitoring via un point de terminaison d'écriture à distance Prometheus ou un scraper exécuté dans le même VPC.

E. Importation et récupération de sauvegardes​

VariableGroupeValeur par défautDescription
backup_schedule7'0 2 * * *'Expression Cron (UTC) pour les sauvegardes quotidiennes automatisées.
backup_retention_days77Jours de rétention des fichiers de sauvegarde dans GCS.
enable_backup_import7falseDéclenche une restauration unique lors de l'apply. Définissez false après une importation réussie.
backup_source7'gcs''gcs' (nom de fichier du bucket GCS) ou 'gdrive' (ID de fichier Drive).
backup_file7'backup.sql'Nom de fichier de la sauvegarde dans le bucket GCS de sauvegardes géré par le module.
backup_format7'sql'Format de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip.

F. Observabilité et alertes​

VariableGroupeValeur par défautDescription
uptime_check_config14{ enabled=false, path="/" }Test de disponibilité : enabled, path, check_interval, timeout. Désactivé par défaut.
alert_policies14[]Politiques d'alerte métrique. Chacune : name, metric_type, comparison, threshold_value, duration_seconds.
support_users1[]Adresses e-mail notifiées par les déclencheurs de test de disponibilité et de politique d'alerte.

9. Exploration avec la console GCP​

Après un déploiement réussi, la console GCP est l'outil principal pour inspecter le déploiement Mattermost en direct.

Service Cloud Run Accédez à Cloud Run dans la console GCP et sélectionnez le service Mattermost (nommé app<name><tenant><id> par défaut, par exemple, appmattermostdemo). À partir de la page du service, vous pouvez :

  • Afficher l'URL du service pour accéder au client web Mattermost.
  • Inspecter les révisions actives et leurs pourcentages d'allocation de trafic.
  • Examiner la configuration du conteneur, y compris les variables d'environnement, les volumes montés et les limites de ressources.
  • Vérifier l'onglet Logs pour diffuser directement les journaux de l'application Mattermost — toutes les sorties stdout sont capturées par Cloud Logging.
  • Surveiller les Metrics pour le nombre de requêtes, la latence (p50, p95, p99), le nombre d'instances de conteneur, l'utilisation de la mémoire et la latence de démarrage.
  • Afficher les Revisions pour voir l'historique des déploiements, les poids de trafic actuels et les balises de révision actives.

Cloud SQL Accédez à SQL et sélectionnez l'instance PostgreSQL 15. Vérifications utiles :

  • Onglet Connections : nombre de connexions actives depuis le service Cloud Run (via le proxy d'authentification).
  • Operations & logs : activité récente de CREATE DATABASE, d'octroi d'utilisateur et de migration.
  • Onglet Databases : vérifiez que la base de données mattermost existe après le premier déploiement.
  • Onglet Users : confirmez que l'utilisateur mattermost a été créé par le job db-init.
  • Backups : sauvegardes automatisées et à la demande. Vérifiez avec la variable backup_schedule.

Cloud Storage Si vous avez remplacé NFS par un bucket gcs_volumes à /mattermost/data, accédez à Cloud Storage et sélectionnez le bucket. (Avec le montage NFS par défaut, la même arborescence se trouve sur le partage NFS.) Mattermost crée cette structure de répertoires sous le point de montage :

  • teams/ — icônes d'équipe et pièces jointes.
  • users/ — photos de profil.
  • plugins/ — fichiers de données de plugin. Les opérations de fichiers dans le bucket reflètent les téléchargements et les pièces jointes effectués par les utilisateurs de Mattermost.

Secret Manager Accédez à Secret Manager et filtrez par les libellés de ressource du déploiement. Les secrets créés par App CloudRun pour Mattermost incluent :

  • DB_PASSWORD — le mot de passe de l'utilisateur de l'application PostgreSQL.
  • ROOT_PASSWORD — le mot de passe root/superutilisateur PostgreSQL utilisé par le job db-init. Cliquez sur un secret pour afficher ses versions, son historique d'accès et sa configuration de rotation.

Cloud Build Accédez à Cloud Build → History pour inspecter les journaux de build d'images. Chaque déploiement crée un build qui compile l'image personnalisée de Mattermost (lorsque container_image_source = 'custom'). Les journaux de build affichent les étapes de build Docker, le comportement de mise en cache des couches et le push vers Artifact Registry.

Artifact Registry Accédez à Artifact Registry et trouvez le dépôt pour le projet. L'image Mattermost y est stockée après chaque exécution de Cloud Build. Les images plus anciennes sont nettoyées selon max_images_to_retain et image_retention_days.

Cloud Monitoring Accédez à Monitoring → Dashboards pour voir les tableaux de bord des métriques Cloud Run. Si uptime_check_config est activé, le test de disponibilité apparaît sous Monitoring → Uptime checks. Les politiques d'alerte créées via alert_policies apparaissent sous Monitoring → Alerting.


10. Exploration avec gcloud​

Les commandes gcloud suivantes sont utiles pour les opérations quotidiennes et le dépannage après le déploiement. Remplacez PROJECT_ID, REGION et SERVICE_NAME par vos valeurs réelles.

Décrire le service Cloud Run :

gcloud run services describe SERVICE_NAME \
--region=REGION \
--project=PROJECT_ID \
--format="yaml(spec.template.spec.containers[0].env)"

Afficher l'URL du service et la répartition actuelle du trafic :

gcloud run services describe SERVICE_NAME \
--region=REGION \
--project=PROJECT_ID \
--format="table(status.url, status.traffic[].revisionName, status.traffic[].percent)"

Lister toutes les révisions et leurs poids de trafic :

gcloud run revisions list \
--service=SERVICE_NAME \
--region=REGION \
--project=PROJECT_ID \
--sort-by="~metadata.creationTimestamp" \
--format="table(metadata.name, status.conditions[0].type, status.conditions[0].status, metadata.creationTimestamp)"

Diffuser les journaux en direct du service Mattermost :

gcloud logging read \
"resource.type=cloud_run_revision AND resource.labels.service_name=SERVICE_NAME" \
--project=PROJECT_ID \
--format="value(textPayload)" \
--freshness=10m \
--order=asc

Vérifier l'historique d'exécution du job Cloud Run db-init :

gcloud run jobs executions list \
--job=SERVICE_NAME-db-init \
--region=REGION \
--project=PROJECT_ID \
--format="table(metadata.name, status.conditions[0].type, metadata.creationTimestamp)"

Déclencher manuellement le job db-init (par exemple, après une restauration de base de données) :

gcloud run jobs execute SERVICE_NAME-db-init \
--region=REGION \
--project=PROJECT_ID \
--wait

Inspecter l'instance Cloud SQL et vérifier la connectivité de la base de données :

gcloud sql instances describe SQL_INSTANCE_NAME \
--project=PROJECT_ID \
--format="table(name, state, databaseVersion, settings.tier, ipAddresses[].ipAddress)"

Lister les bases de données Cloud SQL sur l'instance :

gcloud sql databases list \
--instance=SQL_INSTANCE_NAME \
--project=PROJECT_ID

Afficher les secrets Secret Manager pour le déploiement :

gcloud secrets list \
--project=PROJECT_ID \
--filter="labels.app=mattermost" \
--format="table(name, createTime, replication.automatic)"

Accéder à la dernière version du secret du mot de passe de la base de données :

gcloud secrets versions access latest \
--secret=DB_PASSWORD_SECRET_NAME \
--project=PROJECT_ID

Lister les images de conteneurs dans Artifact Registry :

gcloud artifacts docker images list REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME \
--filter="tags:mattermost" \
--sort-by="~createTime" \
--format="table(IMAGE, TAGS, CREATE_TIME, UPDATE_TIME)"

Forcer un nouveau déploiement (redéployer la dernière révision) :

gcloud run services update SERVICE_NAME \
--region=REGION \
--project=PROJECT_ID \
--update-env-vars=DEPLOY_TIMESTAMP=$(date +%s)

Vérifier l'état du test de disponibilité Cloud Monitoring :

gcloud monitoring uptime list-configs \
--project=PROJECT_ID \
--format="table(displayName, httpCheck.path, period, selectedRegions)"

Afficher les politiques d'alerte actives :

gcloud alpha monitoring policies list \
--project=PROJECT_ID \
--format="table(displayName, enabled, conditions[0].displayName)"

Inspecter le bucket GCS utilisé pour le stockage de fichiers Mattermost :

gsutil ls -l gs://BUCKET_NAME/
gsutil du -s gs://BUCKET_NAME/

Vérifier si un fichier de téléchargement Mattermost spécifique est présent :

gsutil stat gs://BUCKET_NAME/teams/TEAM_ID/channels/CHANNEL_ID/attachments/FILE_ID

11. Comportements gérés par la plateforme​

Les comportements suivants sont appliqués automatiquement par Mattermost CloudRun, quelles que soient les valeurs des variables.

ComportementImplémentationDétail
PostgreSQL 15 requisValeur par défaut database_type = "POSTGRES_15"Mattermost nécessite PostgreSQL 13 ou version ultérieure. La chaîne de connexion à la base de données et le pilote sont configurés par Mattermost Common.
NFS pour les donnéesenable_nfs = true, nfs_mount_path = "/mattermost/data"/mattermost/data est sur le volume NFS partagé par défaut, offrant un stockage de fichiers durable.
Mise en miroir d'images activée par défautenable_image_mirroring = trueL'image Mattermost Docker Hub est mise en miroir vers Artifact Registry avant le déploiement, évitant ainsi la dépendance à des registres externes.
Minimum 1 instanceValeur par défaut min_instance_count = 1Empêche la mise à l'échelle à zéro de déconnecter les sessions WebSocket des utilisateurs actifs.
Pas de secrets d'application auto-générésMattermost génère les clés au premier démarrageLes clés de signature internes, les secrets de session et les clés de chiffrement symétriques sont générés par Mattermost lui-même et stockés dans PostgreSQL — pas dans Secret Manager.
Job db-init par défautFourni par Mattermost Common lorsque initialization_jobs = []La base de données et l'utilisateur PostgreSQL sont créés automatiquement avant le démarrage de Mattermost. Remplacez par une liste initialization_jobs non vide pour remplacer.
Confiance des en-têtes de proxyMM_SERVICESETTINGS_TRUSTEDPROXYIPHEADER=X-Forwarded-ForRequis pour une extraction correcte de l'IP client lorsque Cloud Run est derrière Cloud Armor ou un équilibreur de charge. Injecté automatiquement.
Traitement par lots des e-mails désactivéMM_EMAILSETTINGS_ENABLEEMAILBATCHING=falseLe traitement par lots nécessite des files d'attente en mémoire persistantes incompatibles avec le modèle d'exécution sans état de Cloud Run.
Variable d'environnement URL du siteMM_SERVICESETTINGS_SITEURL défini à partir de la variable site_urlLorsque site_url n'est pas vide, il est injecté comme MM_SERVICESETTINGS_SITEURL ; sinon, le point d'entrée le dérive au démarrage de CLOUDRUN_SERVICE_URL.

12. Référence des variables​

Toutes les variables configurables par l'utilisateur exposées par Mattermost CloudRun, triées par groupe d'interface utilisateur puis par ordre.

VariableGroupeValeur par défautDescription
project_id1—ID du projet GCP. Obligatoire.
region1'us-central1'Région GCP pour le déploiement des ressources.
tenant_id1'demo'Suffixe court ajouté à tous les noms de ressources.
support_users1[]Adresses e-mail pour l'accès IAM et les alertes de surveillance.
resource_labels1{}Libellés appliqués à toutes les ressources provisionnées.
application_name3'mattermost'Nom de ressource de base. Ne pas modifier après le déploiement.
display_name3'Mattermost'Nom lisible par l'homme affiché dans l'interface utilisateur.
description3'Mattermost - Open-source team messaging and collaboration'Description du service.
application_version3'9.11.2'Tag de l'image de conteneur Mattermost.
deploy_application4trueDéfinir false pour un déploiement uniquement d'infrastructure.
container_image_source4'custom''custom' (Cloud Build) ou 'prebuilt' (image existante).
container_image4""URI de l'image de conteneur. Laissez vide pour que Cloud Build le gère.
cpu_limit4'2000m'CPU par instance. 2 vCPU recommandés.
memory_limit4'2Gi'Mémoire par instance.
cpu_always_allocated4trueCPU alloué en permanence. Maintenu true pour la gestion des WebSockets en temps réel.
container_resources4nullRemplace cpu_limit et memory_limit lorsqu'il est défini.
min_instance_count41Maintenir à 1 pour éviter les déconnexions WebSocket.
max_instance_count41Plafond de coût de l'auto-scaling.
container_port48065Port HTTP natif de Mattermost.
execution_environment4'gen2'Gen2 requis pour GCS Fuse.
timeout_seconds4300Durée maximale de la requête. Définir 3600 pour les connexions WebSocket.
enable_cloudsql_volume4trueSidecar Cloud SQL Auth Proxy.
container_protocol4'http1''http1' ou 'h2c'.
enable_image_mirroring4trueMet en miroir l'image Mattermost dans Artifact Registry.
traffic_split4[]Allocation de trafic Canary/bleu-vert.
max_revisions_to_retain47Nombre maximal de révisions Cloud Run à conserver.
service_annotations4{}Annotations Cloud Run avancées.
service_labels4{}Libellés appliqués au service Cloud Run.
ingress_settings5'all''all', 'internal', ou 'internal-and-cloud-load-balancing'.
vpc_egress_setting5'PRIVATE_RANGES_ONLY''PRIVATE_RANGES_ONLY' ou 'ALL_TRAFFIC'.
enable_iap5falseActive IAP nativement sur le service Cloud Run.
iap_authorized_users5[]Utilisateurs/SA ayant accès à IAP.
iap_authorized_groups5[]Groupes Google ayant accès à IAP.
environment_variables6{}Variables d'environnement en texte brut pour la configuration de Mattermost.
secret_environment_variables6{}Références Secret Manager.
explicit_secret_values6{}Valeurs sensibles brutes écrites dans Secret Manager.
secret_propagation_delay630Secondes à attendre après la création du secret.
secret_rotation_period6'2592000s'Fréquence de notification de rotation de Secret Manager.
backup_schedule7'0 2 * * *'Expression Cron (UTC) pour les sauvegardes automatisées.
backup_retention_days77Jours de rétention des fichiers de sauvegarde dans GCS.
enable_backup_import7falseDéclenche une restauration unique lors de l'apply.
backup_source7'gcs''gcs' ou 'gdrive'.
backup_file7'backup.sql'Nom de fichier de la sauvegarde dans le bucket de sauvegardes géré par le module.
backup_format7'sql'Format de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip.
enable_cicd_trigger8falseProvisionne un déclencheur GitHub Cloud Build.
github_repository_url8""URL HTTPS complète du dépôt GitHub.
github_token8""PAT GitHub. Requis lors du premier apply. Sensible.
github_app_installation_id8""ID d'installation de l'application GitHub.
cicd_trigger_config8{ branch_pattern = "^main$" }Configuration avancée du déclencheur Cloud Build.
enable_cloud_deploy8falseProvisionne un pipeline de livraison progressive Cloud Deploy.
cloud_deploy_stages8[dev, staging, prod(approval)]Étapes de promotion Cloud Deploy ordonnées.
enable_binary_authorization8falseApplique l'attestation d'image lors du déploiement.
binauthz_evaluation_mode8'ALWAYS_ALLOW''ALWAYS_ALLOW', 'REQUIRE_ATTESTATION', ou 'ALWAYS_DENY'.
enable_custom_sql_scripts9falseExécute des scripts SQL depuis GCS après le provisionnement.
custom_sql_scripts_bucket9""Bucket GCS contenant les scripts SQL.
custom_sql_scripts_path9""Préfixe de chemin dans le bucket.
custom_sql_scripts_use_root9falseExécuter les scripts en tant qu'utilisateur root de la base de données.
enable_cloud_armor10falseProvisionne un équilibreur de charge HTTPS global + Cloud Armor WAF.
admin_ip_ranges10[]Plages CIDR exemptées des règles WAF.
application_domains10[]Domaines personnalisés avec certificats SSL gérés par Google.
enable_cdn10falseActive Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain107Nombre maximal d'images de conteneurs récentes dans Artifact Registry.
delete_untagged_images10trueSupprime les images non taguées d'Artifact Registry.
image_retention_days1030Jours après lesquels les images sont éligibles à la suppression.
create_cloud_storage11trueDéfinir false pour ignorer la création du bucket GCS.
storage_buckets11[]Buckets GCS supplémentaires à provisionner.
enable_nfs11trueProvisionne un stockage partagé NFS.
nfs_mount_path11'/mattermost/data'Chemin du conteneur où NFS est monté.
nfs_instance_name11""Nom de la VM GCE NFS existante. Laissez vide pour la découverte automatique.
nfs_instance_base_name11'app-nfs'Nom de base pour la VM NFS intégrée.
gcs_volumes11[]Buckets GCS à monter via GCS Fuse.
manage_storage_kms_iam11falseCrée une clé CMEK KMS et active CMEK sur les buckets de stockage.
enable_artifact_registry_cmek11falseCrée une clé KMS Artifact Registry pour le chiffrement au repos.
database_type12'POSTGRES_15'Moteur Cloud SQL. Mattermost nécessite PostgreSQL.
db_name12'mattermost'Nom de la base de données PostgreSQL. Ne pas modifier après le déploiement.
db_user12'mattermost'Utilisateur de l'application PostgreSQL.
database_password_length1232Longueur du mot de passe auto-généré. Plage : 16–64.
enable_auto_password_rotation12falseRotation automatisée des mots de passe sans interruption.
rotation_propagation_delay_sec1290Secondes à attendre après la rotation avant de redémarrer.
initialization_jobs13[]Jobs Cloud Run ponctuels. Laissez vide pour le job Mattermost Common par défaut db-init.
cron_jobs13[]Jobs Cloud Run planifiés récurrents.
startup_probe14{ path="/", initial_delay_seconds=60, failure_threshold=30 }Sonde de démarrage.
liveness_probe14{ path="/", initial_delay_seconds=60, failure_threshold=3 }Sonde de vivacité.
startup_probe_config14{ enabled=true, path="/" }Inerte pour Mattermost — voir §C. Utilisez startup_probe à la place.
health_check_config14{ enabled=true, path="/" }Inerte pour Mattermost — voir §C. Utilisez liveness_probe à la place.
uptime_check_config14{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring (désactivé par défaut).
alert_policies14[]Politiques d'alerte métrique Cloud Monitoring.
site_url20""URL publique pour Mattermost. Définit MM_SERVICESETTINGS_SITEURL.
edition20'team''team' (gratuit) ou 'enterprise' (payant).
enable_redis21falseRedis pour la mise en cache de Mattermost. Requis pour les multi-réplicas.
redis_host21""Nom d'hôte/IP Redis. Par défaut, l'IP du serveur NFS si vide.
redis_port21'6379'Port TCP Redis (chaîne).
redis_auth21""Mot de passe d'authentification Redis. Sensible.
enable_vpc_sc22falseEnregistre les appels d'API dans le périmètre VPC-SC du projet.
vpc_cidr_ranges22[]Plages CIDR de sous-réseau VPC pour le niveau d'accès réseau VPC-SC.
vpc_sc_dry_run22trueJournalise les violations VPC-SC sans bloquer. Définir false pour appliquer.
organization_id22""ID d'organisation GCP pour VPC-SC. Découvert automatiquement si vide.
enable_audit_logging22falseActive les journaux d'audit Cloud détaillés.

13. Sorties​

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL publique du service Cloud Run.
service_locationRégion GCP où le service Cloud Run est déployé.
project_idID du projet GCP.
deployment_idSuffixe d'ID de déploiement utilisé dans les noms de ressources.
database_instance_nameNom de l'instance Cloud SQL PostgreSQL.
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.

14. 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(obligatoire)CritiquePas de valeur par défaut — le déploiement échoue immédiatement.
database_type"POSTGRES_15"CritiqueMattermost nécessite PostgreSQL 13 ou version ultérieure. La définition d'une variante MySQL ou SQL Server entraîne l'échec du démarrage de Mattermost avec une erreur de connexion du pilote.
db_name"mattermost"CritiqueImmuable après le premier déploiement — la modification de cette valeur entraîne la recréation de la base de données par Mattermost, détruisant tout l'historique des messages, les utilisateurs et la configuration.
db_user"mattermost"CritiqueImmuable après le premier déploiement — la modification de cette valeur recrée l'utilisateur Cloud SQL et interrompt la connexion à la base de données.
min_instance_count1ÉlevéLa mise à l'échelle à zéro (0) entraîne la perte des connexions WebSocket actives (messagerie en temps réel) pour tous les utilisateurs en ligne chaque fois que l'instance unique est réduite. Définir sur 1 pour tout déploiement de production.
timeout_seconds300ÉlevéMattermost maintient des connexions WebSocket pour la messagerie en temps réel. Un délai d'attente de 5 minutes entraîne la terminaison par Cloud Run de toutes les connexions WebSocket actives toutes les 5 minutes. Définir sur 3600 pour les déploiements de production fortement basés sur WebSocket.
enable_redisfalseÉlevéSûr avec l'instance unique par défaut. L'exécution de plusieurs réplicas (max_instance_count > 1) nécessite un clustering HA Enterprise et Redis pour le partage de session distribué. Sans cela, les utilisateurs subissent des échecs d'authentification intermittents et des données obsolètes car les requêtes sont acheminées vers différentes instances avec des caches mémoire indépendants.
site_url"" (dérivé de l'URL du service)Élevé avec un domaine personnaliséVide est acceptable sur l'URL run.app — elle est dérivée au démarrage. Sur un domaine personnalisé, la laisser vide fait que les liens d'invitation, les URI de redirection OAuth et les rappels de webhook pointent vers l'URL run.app à la place.
enable_nfstrueÉlevéLe désactiver sans monter un autre stockage durable (par exemple gcs_volumes) à /mattermost/data place les téléchargements et les pièces jointes sur le système de fichiers éphémère du conteneur ; ils sont perdus lorsqu'une nouvelle révision est déployée ou que le conteneur redémarre.
edition"team"MoyenLa définition de edition = "enterprise" sélectionne l'image de conteneur Enterprise Edition. Sans une clé de licence valide définie via environment_variables, Mattermost démarre en mode d'essai Enterprise et finit par revenir aux fonctionnalités de Team Edition.
memory_limit"2Gi"MoyenMattermost met en cache les listes de canaux, les sessions utilisateur et les index de messages en mémoire. Réduire en dessous de 1Gi provoque des redémarrages OOM en cas d'activité modérée de l'équipe. Augmenter à 4Gi pour les équipes de plus de 100 utilisateurs actifs.
backup_retention_days7MoyenSept jours sont insuffisants pour les équipes actives. Augmenter à plus de 30 jours pour toute instance Mattermost de production afin de permettre une récupération ponctuelle en cas de corruption de données ou de suppression accidentelle.
enable_cloud_armorfalseMoyenSans Cloud Armor, Mattermost est exposé directement sur l'URL *.run.app. Pour les équipes de production, activez Cloud Armor pour protéger l'API des attaques de bots et du bourrage d'identifiants.
enable_iapfalseFaibleAvec IAP désactivé, Mattermost est responsable de sa propre authentification. Envisagez d'activer IAP pour les déploiements internes uniquement afin d'ajouter une couche d'authentification supplémentaire avant que les requêtes n'atteignent Mattermost.
secret_propagation_delay30FaibleParfois insuffisant dans les configurations multi-régions. Augmenter à 60–90s si les secrets ne sont pas trouvés lors de l'apply.

15. Destruction des ressources​

Problème de suppression connu : libération d'adresse IPv4 sans serveur​

Lors de la destruction d'un déploiement Cloud Run, vous pouvez rencontrer une erreur similaire à :

Error: Error waiting for Subnetwork to be deleted: The following serverless IPv4 address(es) on subnet ... are still in use.

Cause : GCP conserve les adresses IPv4 sans serveur sur le sous-réseau VPC de manière asynchrone après la suppression d'un service Cloud Run. Ces adresses sont libérées par GCP environ 20 à 30 minutes après la suppression du service Cloud Run.

Résolution : Attendez 20 à 30 minutes après la tentative de destruction initiale, puis réexécutez la commande de destruction :

tofu destroy

La deuxième exécution réussira une fois que GCP aura libéré les adresses réservées.

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