Aller au contenu principal

Matomo sur Google Cloud Run

Matomo sur Google Cloud Run

Matomo est la principale plateforme d'analyse web open source — une alternative auto-hébergée à Google Analytics, axée sur la confidentialité, utilisée par plus d'un million de sites web. Ce module déploie Matomo sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Matomo et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


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

Le module Cloud Run de Matomo sur RAD coûte environ 84 $ US par mois dans votre propre projet, sans frais par page vue. RAD facture 75 crédits une fois par déploiement dans votre propre projet (67,5 crédits, soit 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. Matomo se déploie également sur GKE Autopilot pour environ 110 $ 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 que RAD gère pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,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 buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 84 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 $ 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

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : 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 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 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 (par défaut du module)Par mois
Cloud Run, 1x vCPU / 2 Gio (scaleToZero)13 $ US
Cloud SQL pour MySQL, 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 84 $ US

Comment cela se compare​

  • Le "Matomo Cloud" hébergé par Matomo propose des plans payants, mais son prix dépend d'un sélecteur de niveau de trafic sans chiffre fixe publié, de sorte qu'aucun chiffre unique ne peut être cité de manière fiable ici — vérifiez matomo.org/pricing pour votre propre volume de trafic avant de comparer.
  • Google Analytics est gratuit, ce qui est la véritable alternative par laquelle la plupart des sites commencent. Le module Matomo de RAD coûte environ 84 $ US par mois dans votre propre projet, et la raison de le payer n'est pas le prix — c'est la possession à 100 % de vos données de visiteurs, sans échantillonnage et sans données partagées avec Google, ce qui est important pour les sites sensibles au RGPD/CCPA.
  • Comparaison auto-gérée : avec 1 vCPU / 2 Gio et une base de données MySQL, un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go (~24 $ US/mois) est dans la fourchette, et vous gérez MySQL, les sauvegardes et les mises à niveau vous-même.

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

Si Matomo s'exécute dans un projet que RAD gère 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 à Matomo 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 Update 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à 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 201 $ US par mois pour le maintenir en fonctionnement. Déployez Matomo, utilisez-le 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 le temps qu'il a été réellement actif.
  • 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 niveau (100 crédits pour le niveau 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é Matomo 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) — 75 crédits (7,50 $ US) au total. La suppression permet d'économiser de l'argent seulement une fois que Matomo 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 2,79 $ US par jour) et dans un projet géré par RAD (67 crédits par jour).
  • La majeure partie du coût d'exécution est généralement partagée. Pour Matomo, il s'agit de la base de données et de la VM de fichier/cache partagée. Elles 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 la 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. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Matomo s'exécute en tant que conteneur PHP/Apache (l'image officielle matomo:5-apache) sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service PHP/Apache, 1 vCPU / 2 Gio par défaut, autoscaling basé sur les requêtes
Base de donnéesCloud SQL pour MySQL 8.0Requis — Matomo ne prend en charge que MySQL/MariaDB
Fichiers partagésFilestore (NFS)Persiste la racine de documents Matomo /var/www/html (gen2 requis)
Stockage d'objetsCloud StorageUn bucket matomo-data dédié provisionné automatiquement
CacheRedisActivé par défaut ; revient à l'IP de l'hôte NFS si aucun hôte Redis n'est donné
SecretsSecret ManagerMot de passe de la base de données géré automatiquement
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

Valeurs par défaut judicieuses à connaître d'emblée :

  • MySQL 8.0 est obligatoire. Matomo nécessite MySQL/MariaDB ; PostgreSQL n'est pas pris en charge.
  • L'image officielle pré-construite est déployée directement. container_image_source = "prebuilt" signifie aucune étape Cloud Build — l'image matomo:<application_version> est mise en miroir dans Artifact Registry (pour éviter les limites de débit de Docker Hub) et déployée telle quelle.
  • La connexion à la base de données est TCP sur le VPC, pas un socket. enable_cloudsql_volume = false par défaut : la Fondation injecte l'IP privée de l'instance Cloud SQL comme MATOMO_DATABASE_HOST, et le client PHP de Matomo se connecte directement sur le réseau privé. Il n'y a pas de sidecar de socket Auth Proxy.
  • Les variables d'environnement MATOMO_DATABASE_* pré-remplissent l'installateur. L'hôte, le nom d'utilisateur, le nom de la base de données et le mot de passe sont injectés par la Fondation ; MATOMO_DATABASE_ADAPTER=mysql et MATOMO_DATABASE_TABLES_PREFIX=matomo_ sont définis par Matomo_Common.
  • NFS persiste la racine du document. nfs_mount_path par défaut à /var/www/html, où Matomo conserve config.ini.php, les plugins installés et les actifs générés. Le point d'entrée de l'image peuple un volume vide à partir de /usr/src/matomo au premier démarrage.
  • Un job db-init s'exécute à chaque apply pour créer de manière idempotente la base de données et l'utilisateur MySQL de Matomo.
  • Mise à l'échelle à zéro par défaut. min_instance_count = 0 et max_instance_count = 1 ; les démarrages à froid prennent 10 à 30 secondes. Définissez min_instance_count = 1 pour une production toujours active.
  • Le mot de passe de la base de données est généré automatiquement et stocké dans Secret Manager. Matomo n'a pas d'autres secrets d'application.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Matomo​

Matomo s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre le nombre minimal et maximal d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud SQL pour MySQL 8.0​

Matomo stocke toutes les données analytiques (visites, rapports, utilisateurs, configuration du site) dans une instance Cloud SQL pour MySQL 8.0 gérée. Le service se connecte via l'IP privée de l'instance à travers le VPC (pas d'IP publique, pas de socket proxy) : la Fondation injecte l'IP privée comme MATOMO_DATABASE_HOST. Lors du premier déploiement, un Job db-init crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Filestore (NFS) et Cloud Storage​

La racine de documents de Matomo /var/www/html — configuration (config.ini.php), plugins installés et actifs générés — est écrite sur un partage Filestore (NFS) monté dans le service afin qu'elle survive aux redémarrages et à la mise à l'échelle à partir de zéro. Un bucket Cloud Storage dédié (matomo-data) est également provisionné automatiquement. L'environnement d'exécution gen2 est requis pour les montages NFS.

  • Console : Filestore → Instances ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour le montage NFS, GCS Fuse et CMEK.

D. Cache Redis​

Redis prend en charge le cache d'objets de Matomo, réduisant la charge de la base de données et améliorant les temps de chargement des pages. Lorsqu'aucun hôte Redis externe n'est configuré et que NFS est activé, l'IP de l'hôte NFS est utilisée comme point de terminaison Redis.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace

E. Secret Manager​

Le mot de passe de la base de données est stocké dans Secret Manager et injecté dans le service au moment de l'exécution en tant que MATOMO_DATABASE_PASSWORD ; le texte en clair n'apparaît jamais dans la configuration. Matomo ne nécessite aucun autre secret d'application.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

F. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de contrôle d'egress VPC contrôlent la connectivité. L'extrait de suivi que vous intégrez dans vos sites web pointe vers cette URL (ou votre domaine personnalisé).

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte facultatives.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Matomo​

  • Configuration de la base de données au premier déploiement. Un Job db-init (image mysql:8.0-debian) se connecte à Cloud SQL — préférant le socket Unix Auth Proxy lorsqu'il est monté, revenant à une connexion TCP via l'IP privée — et crée de manière idempotente la base de données Matomo, crée l'utilisateur de l'application et accorde tous les privilèges. Il vérifie également que l'utilisateur de l'application peut se connecter, ce qui permet à la fois de détecter rapidement les problèmes d'authentification et de réchauffer le cache d'authentification caching_sha2_password de MySQL 8 afin que les connexions TCP ultérieures du client PHP utilisent le chemin d'authentification rapide. Le job s'exécute à chaque apply et peut être réexécuté en toute sécurité.
  • L'installateur web complète la configuration. Le job db-init ne crée que la base de données vide ; la navigation vers l'URL du service pour la première fois lance l'installateur web de Matomo, dont l'écran de base de données est pré-rempli à partir des variables d'environnement MATOMO_DATABASE_* injectées. Vous y créez le compte superutilisateur et enregistrez votre premier site web suivi.
  • Persistance de la racine du document. Au premier démarrage, le point d'entrée de l'image officielle copie l'application Matomo de /usr/src/matomo dans le volume NFS (vide) à /var/www/html. Tout état ultérieur — config.ini.php, plugins, actifs générés — persiste là-bas à travers les redémarrages et les mises à niveau de version.
  • La connexion à la base de données est en TCP simple. Avec enable_cloudsql_volume = false, le client PHP MySQL de Matomo se connecte à l'IP privée de Cloud SQL via le VPC. Les variables d'environnement MATOMO_DATABASE_ADAPTER=mysql et MATOMO_DATABASE_TABLES_PREFIX=matomo_ sont définies par Matomo_Common.
  • Archivage des rapports. Par défaut, Matomo traite les rapports lors de la consultation de la page (archivage déclenché par le navigateur), ce qui convient aux trafics faibles à moyens et à la mise à l'échelle à zéro par défaut du module. Pour les sites à fort trafic, planifiez console core:archive via l'entrée cron_jobs afin que le traitement des rapports s'exécute en tant que Job Cloud Run au lieu de s'exécuter dans les requêtes des visiteurs.
  • Chemin de santé. Le démarrage utilise une sonde TCP (écoute de port) avec un seuil généreux de 20 échecs pour couvrir la copie du document racine au premier démarrage depuis /usr/src/matomo ; la vivacité cible / via HTTP, qui renvoie 200 — ou 302 vers l'installateur lors d'un nouveau déploiement — une fois Apache et PHP démarrés.
  • Les variables de réglage PHP sont des arguments de build. php_memory_limit, upload_max_filesize et post_max_size ne s'appliquent que lorsque container_image_source = "custom" (ce sont des arguments de build Docker) ; avec l'image pré-construite par défaut, ils n'ont aucun effet.

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Matomo sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namematomoNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameMatomoNom convivial affiché dans la console.
application_version5-apacheTag d'image Matomo — utilisez un tag de variante Apache ; incrémentez pour déployer une nouvelle révision.
php_memory_limit / upload_max_filesize / post_max_size512M / 64M / 64MArguments de build de réglage PHP — efficaces uniquement avec container_image_source = "custom".

Toutes les autres entrées de ce groupe suivent le comportement standard de App_CloudRun.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltDéploie directement l'image officielle de Matomo ; custom construit via Cloud Build.
container_image""Laissez vide pour utiliser matomo:<application_version>.
cpu_limit1000mCPU par instance ; 1 vCPU minimum pour Matomo.
memory_limit2GiMémoire par instance ; 2 Gio recommandés pour la génération de rapports.
min_instance_count0Mise à l'échelle à zéro ; définissez 1 pour une production toujours active.
max_instance_count1Gardez à 1 sauf si NFS partagé + affinité de session sont confirmés comme sûrs pour plusieurs instances.
container_port80Matomo s'exécute sur Apache, qui écoute sur le port 80.
enable_cloudsql_volumefalseMatomo se connecte via IP privée TCP (MATOMO_DATABASE_HOST) — pas de socket proxy.
execution_environmentgen2Requis pour le montage NFS.
enable_image_mirroringtrueMettez l'image en miroir dans Artifact Registry pour éviter les limites de débit de Docker Hub.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy. Remarque : IAP devant Matomo bloque également le point de terminaison de suivi public.
ingress_settingsallQuels réseaux peuvent atteindre le service. Les traqueurs sur les sites web publics nécessitent all (ou avec LB).
vpc_egress_settingPRIVATE_RANGES_ONLYLe trafic IP privé (y compris Cloud SQL) est acheminé via le VPC.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement supplémentaires en clair. MATOMO_DATABASE_ADAPTER et MATOMO_DATABASE_TABLES_PREFIX sont injectées automatiquement ; l'ensemble MATOMO_DATABASE_HOST/USERNAME/DBNAME/PASSWORD provient de la Fondation.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupes 8-10 — CI/CD, SQL personnalisé, domaine et Cloud Armor​

Comportement standard de App_CloudRun — voir App_CloudRun. Entrées clés : enable_cicd_trigger, enable_cloud_deploy, enable_binary_authorization, enable_custom_sql_scripts, application_domains, enable_cdn, enable_cloud_armor.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueVolume Filestore partagé pour la racine de documents Matomo. Nécessite gen2.
nfs_mount_path/var/www/htmlRacine de documents de Matomo — la configuration, les plugins et les actifs y persistent.
create_cloud_storage / storage_buckets[{ name_suffix = "data" }]Buckets supplémentaires ; le bucket matomo-data est toujours provisionné automatiquement.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Matomo nécessite MySQL — ne pas changer pour PostgreSQL.
db_namematomoNom de la base de données MySQL. Immuable après le premier déploiement.
db_usermatomoUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotationfalseRotation automatique du mot de passe de la base de données.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré (mysql:8.0-debian).
cron_jobs[]Jobs récurrents — l'emplacement naturel pour un console core:archive planifié sur les sites à fort trafic.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP, délai initial de 30s, période de 15s, 20 échecsSeuil généreux pour la copie du document racine au premier démarrage.
liveness_probeHTTP /, délai initial de 300s, période de 60s, 3 échecsMatomo sert 200/302 sur / une fois PHP et Apache démarrés.
uptime_check_configdésactivé, chemin /Vérification de disponibilité Cloud Monitoring — désactivée par défaut ; activer pour la production.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis comme backend de cache d'objets de Matomo.
redis_host""Point de terminaison Redis. Laissez vide pour utiliser l'IP de l'hôte NFS.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC.
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés (inclut le bucket matomo-data).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

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

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typeMYSQL_8_0CritiqueMatomo ne prend en charge que MySQL/MariaDB ; tout autre moteur bloque l'installateur.
db_name / db_userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données analytiques.
enable_nfstrueCritiqueSans la racine de document persistante, config.ini.php et les plugins sont perdus à chaque redémarrage — Matomo réentre dans l'installateur.
nfs_mount_path/var/www/htmlCritiqueMonter ailleurs laisse la racine de document sur un disque éphémère.
container_port80CritiqueApache écoute sur le port 80 ; une non-concordance échoue toutes les sondes de santé.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide échoue le job d'importation.
execution_environmentgen2ÉlevéLes montages NFS nécessitent gen2 ; gen1 ne peut pas monter Filestore.
enable_cloudsql_volumefalseÉlevéMatomo est câblé pour TCP via MATOMO_DATABASE_HOST (IP privée) ; passer au socket sans recâbler l'environnement hôte laisse l'installateur pointer vers un hôte inaccessible.
application_versionTag de variante Apache (ex. 5-apache)ÉlevéLes variantes fpm/alpine n'ont pas Apache et ne servent pas HTTP sur le port 80.
max_instance_count1ÉlevéPlusieurs instances sur la même racine de document NFS ne sont pas validées pour la sécurité de la session/configuration Matomo.
memory_limit2GiÉlevéTrop peu de mémoire échoue la génération de rapports PHP et le traitement des archives.
enable_redistrueMoyenSans cache d'objets, toutes les lectures de cache atteignent MySQL, augmentant la charge.
min_instance_count0 (dev) / 1 (prod)Moyen0 ajoute un démarrage à froid de 10 à 30 s pour la première page vue suivie après l'inactivité.
cron_jobs (core:archive)défini pour un trafic élevéMoyenL'archivage déclenché par le navigateur ralentit les requêtes côté visiteur sur les sites occupés.
enable_iapfalse pour les traqueurs publicsMoyenIAP devant le service bloque le point de terminaison de suivi que vos sites web appellent.
uptime_check_config.enabledtrue pour la prodFaiblePas de signal de disponibilité externe ; les échecs ne remontent que via les rapports d'utilisateurs.
php_memory_limit etc.valeurs par défautFaibleArguments de build uniquement — silencieusement inertes avec l'image pré-construite par défaut.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Matomo partagée avec la variante GKE est décrite dans Matomo_Common.

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