Aller au contenu principal

Module Umami GKE — Guide de configuration

Module Umami GKE — Guide de configuration

Ce guide décrit chaque variable de configuration disponible dans le module Umami_GKE. Umami_GKE est un module enveloppe qui combine le module d'infrastructure générique App_GKE avec la configuration d'application partagée Umami_Common pour déployer la plateforme d'analyse web axée sur la confidentialité Umami sur Google Kubernetes Engine (GKE) Autopilot.

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

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


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

L'exécution d'Umami sur GKE Autopilot dans votre propre projet Google Cloud coûte environ 104,74 $ US/mois en frais Google Cloud (environ 177,74 $ US si ce n'est pas votre seul cluster Autopilot), en plus de frais de module RAD uniques de 110 crédits (11 $ US) — plus élevés que les frais du module Cloud Run car cette variante exécute également un volume NFS partagé sur GKE. GKE Autopilot convient à Umami qui doit rester opérationnel ou évoluer sur plusieurs pods ; pour le coût le plus bas, consultez plutôt le guide Cloud Run. Dans un projet géré par RAD, les frais de module tombent à 99 crédits (10 % de moins) — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (une seule fois)110 crédits99 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 Cloud104,74 $ US/mois, facturé par Google au prix catalogue~122 crédits/jour (environ 3 660/mois, 366 $ US au prix de la recharge), mesuré au prix catalogue plus la marge de RAD

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

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant 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 unique, et moins pour un plan mensuel.

Coût d'exécution par défaut dans votre propre projet

Ressource (valeur par défaut du module)Par mois
Pod GKE Autopilot, 1 vCPU / 0,5 Gio34,29 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total104,74 $ US

Les frais de gestion du cluster GKE sont exclus du total ci-dessus car ils sont partagés entre toutes les applications GKE du projet — 0 $ si c'est la seule, sinon environ 73 $/mois répartis entre le nombre d'applications que vous exécutez.

Comment cela se compare​

  • La propre solution hébergée d'Umami, Umami Cloud, propose un niveau Hobby gratuit, puis Pro à 20 $/mois et Business à 200 $/mois — vérifié sur la page de tarification d'Umami, le 8 octobre 2026. Le coût d'exécution du projet propre de RAD est un forfait d'environ 105 $/mois, quel que soit le volume d'événements.
  • Une comparaison avec un VPS autogéré, dimensionné selon la configuration par défaut d'Umami de 1 vCPU / 0,5 Gio : un Hetzner CPX11 ou un Droplet DigitalOcean de 1 vCPU/2 Go coûte environ 6-12 $/mois — plus votre propre temps pour les sauvegardes et les correctifs, et aucun plan de contrôle Kubernetes à gérer.
  • La majeure partie du coût de ce module, au-delà de la variante Cloud Run, est due au pod GKE et au volume NFS ; le module Cloud Run n'a besoin ni de l'un ni de l'autre et est l'option par défaut la moins chère pour Umami.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin​

C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la propre suppression logicielle récupérable de Google de 30 jours. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, aucune VM, ni la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

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.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour 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.

Ce qu'il faut : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc 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'étude/démo conviennent). Google indique que la plupart des services sont entièrement fonctionnels à nouveau dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, 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é Umami 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.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Dans votre propre projet, ou une fois que 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources définitivement, et ramener Umami signifie redéployer à partir de zéro. Cela coûte environ 113-116 crédits dans votre propre projet, ou environ 102-105 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Umami reste 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 dans votre propre projet (environ 3,49 $ US par jour), ou environ 1 jour ou plus dans un projet géré par RAD (122 crédits par jour).

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.

Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, afin que personne ne reçoive 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration ; tarification Umami.

Référence de configuration standard​

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

Zone de configurationSection App GKE.mdNotes spécifiques à Umami
Projet et identité§2 IAM et contrôle d'accèsIdentique.
Identité de l'application§3.A Calcul (GKE Autopilot)Valeurs par défaut spécifiques à Umami ; voir Groupe 2 : Identité de l'application.
Exécution et mise à l'échelle§3.A Calcul (GKE Autopilot)Valeurs par défaut spécifiques à Umami pour container_port, cpu_limit, memory_limit ; voir Groupe 3 : Exécution et mise à l'échelle.
Variables d'environnement et secrets§3 Configuration du service principalAPP_SECRET auto-généré ; DATABASE_URL assemblé à l'exécution ; voir Groupe 5 : Variables d'environnement et secrets.
Réseau et politiques réseau§3.D Réseau et politiques réseauIdentique.
Jobs d'initialisation et CronJobs§3.E Jobs d'initialisation et CronJobsJob db-init fourni automatiquement par Umami Common ; voir Groupe 8 : Jobs et tâches planifiées.
Services supplémentaires§3.F Services supplémentairesIdentique.
Stockage — NFS§3.C Stockage (NFS / GCS / GCS Fuse)enable_nfs par défaut à false — Umami est sans état et n'a pas besoin de système de fichiers partagé.
Stockage — GCS§3.C Stockage (NFS / GCS / GCS Fuse)Aucun bucket de stockage provisionné par défaut ; voir Groupe 14 : Cloud Storage.
Configuration de la base de données§3.B Base de données (Cloud SQL)PostgreSQL requis ; voir Groupe 16 : Configuration de la base de données.
Planification et rétention des sauvegardes§3.B Base de données (Cloud SQL)Identique.
Scripts SQL personnalisés§3.E Jobs d'initialisation et CronJobsIdentique.
Observabilité et vérifications de santé§3.A Calcul (GKE Autopilot)Point de terminaison de santé /api/heartbeat ; voir Groupe 10 : Observabilité et santé.
Cloud Armor WAF§4.A Cloud Armor WAFIdentique.
Proxy conscient de l'identité§4.B Proxy conscient de l'identité (IAP)Identique.
Autorisation binaire§4.C Autorisation binaireIdentique.
Contrôles de service VPC§4.D Contrôles de service VPCIdentique.
Pilote CSI du magasin de secrets§4.E Pilote CSI du magasin de secretsToujours activé — aucune configuration requise.
Trafic et Ingress§5 Trafic et IngressIdentique.
CDN§5.B CDNIdentique.
Domaine personnalisé et IP statique§5.C Réservation d'IP statiqueVoir Groupe 19 : Domaine personnalisé et IP statique.
Déclencheurs Cloud Build§6.A Déclencheurs Cloud BuildIdentique.
Pipeline Cloud Deploy§6.B Pipeline Cloud DeployIdentique.
Mise en miroir d'images§6.C Mise en miroir d'imagesActivé par défaut pour éviter les limites de débit de GitHub Container Registry.
Budgets d'interruption de pod§7.A Budgets d'interruption de podIdentique.
Contraintes de répartition de topologie§7.B Contraintes de répartition de topologieIdentique.
Quotas de ressources§7.C Quotas de ressourcesIdentique.
Rotation automatique des mots de passe§7.D Rotation automatique des mots de passeVoir Groupe 16 : Configuration de la base de données.
Cache Redis§8.A Redis / MemorystoreRedis non câblé — Umami n'en a pas besoin ; voir Groupe : Cache Redis.
Importation de sauvegarde§8.B Importation de sauvegardeVoir Groupe 21 : Importation de sauvegarde.
Maillage de services (ASM)§8.C Maillage de services (ASM via Fleet)Identique.
Services multi-clusters§8.D Services multi-clusters (MCS)Identique.

Comment Umami GKE se rapporte à App GKE​

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

  1. PostgreSQL est requis. Umami nécessite PostgreSQL pour tout le stockage de données. La valeur par défaut database_type est "POSTGRES" (l'option PostgreSQL générique).
  2. DATABASE_URL est assemblé à l'exécution. Le point d'entrée Umami personnalisé construit DATABASE_URL à partir des variables DB_* injectées par la plateforme. Cela évite de stocker une chaîne de connexion en texte clair dans les variables d'environnement ou l'état Terraform.
  3. APP_SECRET est auto-généré. Umami Common génère un secret alphanumérique de 32 caractères et le stocke dans Secret Manager. Il est injecté dans le pod en tant que APP_SECRET.
  4. Aucun bucket de stockage n'est provisionné par défaut. Umami est un service d'analyse sans état — toutes les données résident dans PostgreSQL. storage_buckets est par défaut une liste vide.
  5. Un job db-init s'exécute lors du premier déploiement. Umami Common fournit un Job Kubernetes db-init par défaut qui pré-crée la base de données et l'utilisateur PostgreSQL Umami. Umami exécute ensuite ses propres migrations Prisma au démarrage.
  6. Les valeurs par défaut des ressources sont dimensionnées pour Umami. Les valeurs par défaut cpu_limit (1 vCPU) et memory_limit (512 Mio) reflètent l'empreinte légère d'Umami.
  7. Les sondes de santé ciblent /api/heartbeat. Le point de terminaison de santé dédié d'Umami, et non un chemin racine générique.
  8. Redis n'est pas utilisé. Umami stocke tout dans PostgreSQL ; le module ne câble aucune connexion Redis (la déclaration enable_redis mise en miroir n'est pas transmise à la Fondation).
  9. La mise en miroir d'images est activée par défaut. Umami est distribué via GitHub Container Registry (ghcr.io). Le module met en miroir l'image vers Artifact Registry pour éviter les limites de débit en production.

Groupe 1 : Projet et identité​

Identique à App_GKE. Voir App_GKE.

VariableValeur par défautDescription
project_id(requis)ID du projet GCP. Requis.
region"us-central1"Région GCP pour Cloud SQL, GCS et d'autres ressources.

Groupe 2 : Identité de l'application​

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

Valeurs par défaut spécifiques à Umami :

VariableValeur par défaut Umami GKEValeur par défaut App GKENotes
application_name"umami""gkeapp"Utilisé comme nom de base pour toutes les ressources GCP et Kubernetes. Ne pas modifier après le déploiement.
application_display_name"Umami""App GKE Application"Affiché dans l'interface utilisateur et les tableaux de bord de la plateforme. Peut être modifié librement.
application_description"Umami Analytics on GKE Autopilot""App GKE Custom Application…"Libellé descriptif. Peut être modifié librement.
application_version"postgresql-latest""1.0.0"La version de publication d'Umami à construire et déployer. Doit utiliser une balise préfixée par postgresql-.
deploy_applicationtruetrueDéfinissez false pour provisionner uniquement l'infrastructure de support sans déployer la charge de travail Umami.

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

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

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

VariableValeur par défaut Umami GKEValeur par défaut App GKENotes
container_port30008080Port Next.js natif d'Umami. Ne pas modifier sauf si votre Dockerfile personnalisé lie Umami à un port différent.
container_resources{ cpu_limit="1000m", memory_limit="512Mi" }{ cpu_limit="1000m", memory_limit="512Mi" }Mêmes valeurs par défaut — Umami est léger. Augmentez memory_limit à 1Gi pour les tableaux de bord d'analyse à fort trafic.
min_instance_count1varieLa valeur par défaut de GKE est 1 pod minimum. Définissez une valeur plus élevée pour les déploiements à haute disponibilité.
max_instance_count103Umami s'adapte horizontalement en toute sécurité — tout l'état est dans PostgreSQL, permettant de nombreuses instances concurrentes.
container_image_source"custom""custom"Le mode custom construit une image enveloppe qui assemble DATABASE_URL à partir des variables DB_*. Définissez sur "prebuilt" uniquement si vous fournissez DATABASE_URL manuellement.
enable_cloudsql_volumetruetrueSidecar Cloud SQL Auth Proxy. Requis pour qu'Umami se connecte à Cloud SQL via un socket Unix.
workload_type"Deployment""Deployment"Umami est sans état — Deployment est le type de charge de travail correct. N'utilisez pas StatefulSet sauf si vous attachez un stockage local persistant pour un cas d'utilisation non standard.

enable_vertical_pod_autoscaling : Par défaut à false. Activez pour permettre à GKE Autopilot de dimensionner automatiquement les pods Umami en fonction de l'utilisation des ressources observée. Utile pour l'optimisation des coûts en production.

Les variables d'exécution restantes (enable_image_mirroring, container_build_config, container_protocol, timeout_seconds, cloudsql_volume_mount_path, service_annotations, service_labels, termination_grace_period_seconds, deployment_timeout) se comportent comme décrit dans App_GKE Groupe 4.


Groupe 4 : Accès et réseau​

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

VariableValeur par défautDescription
enable_iapfalseActive l'authentification Identity-Aware Proxy sur l'équilibreur de charge.
iap_authorized_users[]Utilisateurs individuels ou comptes de service ayant accès à IAP.
iap_authorized_groups[]Groupes Google ayant accès à IAP.
iap_oauth_client_id""ID client OAuth pour la configuration IAP.
iap_oauth_client_secret""Secret client OAuth pour la configuration IAP.
iap_support_email""E-mail de support affiché sur l'écran de consentement Google OAuth.
enable_cloud_armorfalseAttache une politique de sécurité Cloud Armor au backend Ingress GKE.
admin_ip_ranges[]Plages CIDR d'administration autorisées via Cloud Armor.
cloud_armor_policy_name"default-waf-policy"Nom de la politique de sécurité Cloud Armor à attacher.
enable_vpc_scfalseActive l'application du périmètre des contrôles de service VPC.
network_name""Nom du réseau VPC. Laisser vide pour la découverte automatique.
network_tags[]Balises de pare-feu appliquées aux nœuds du cluster GKE.
enable_network_segmentationfalseApplique des règles Kubernetes NetworkPolicy pour restreindre le trafic pod-à-pod.

Note IAP pour Umami : IAP protège le tableau de bord d'analyse Umami. Si vous appliquez IAP, notez que le point de terminaison du script de suivi (/script.js) et le point de terminaison de collecte d'événements (/api/send) doivent rester accessibles publiquement pour que les sites web suivis puissent rapporter des données. Considérez attentivement l'architecture de routage si vous restreignez l'accès.


Groupe 5 : Variables d'environnement et secrets​

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

Comportement spécifique à Umami :

Umami Common génère APP_SECRET et l'injecte comme variable d'environnement APP_SECRET. Aucune valeur par défaut SMTP n'est pré-remplie — Umami n'envoie pas d'e-mail nativement.

Utilisez environment_variables pour les options de configuration d'Umami :

environment_variables = {
DISABLE_TELEMETRY = "1" # Disable Umami's anonymous telemetry reporting
TRACKER_SCRIPT_NAME = "analytics.js" # Rename tracking script to avoid ad blockers
ALLOWED_FRAME_URLS = "https://example.com" # Allow Umami to be embedded in iframes
}
VariableValeur par défautDescription
environment_variables{}Variables d'environnement en texte clair injectées dans le pod à l'exécution.
secret_environment_variables{}Références Secret Manager injectées comme variables d'environnement.
secret_rotation_period'2592000s'Période de rotation des secrets Secret Manager (30 jours).
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.

Groupe 6 : Cluster GKE​

VariableValeur par défautDescription
gke_cluster_name""Nom du cluster GKE Autopilot cible. Laisser vide pour la découverte automatique.
namespace_name""Espace de noms Kubernetes. Auto-généré à partir de application_name et tenant_id si vide.
service_type"LoadBalancer"Type de service Kubernetes. "LoadBalancer" (la valeur par défaut) expose Umami directement sur une IP externe ; utilisez "ClusterIP" pour un accès interne uniquement derrière un Ingress.
session_affinity"None"Mode d'affinité de session. "None" est correct pour Umami — tout l'état est dans PostgreSQL, donc n'importe quel pod peut gérer n'importe quelle requête.
enable_multi_cluster_servicefalseEnregistre le service auprès des services multi-clusters GKE.
configure_service_meshfalseInjecte les proxys sidecar Anthos Service Mesh (Istio).
termination_grace_period_seconds30Secondes pendant lesquelles Kubernetes attend la terminaison du pod avant de le tuer de force.
deployment_timeout1800Nombre maximal de secondes à attendre pour que le déploiement GKE atteigne un état sain.
gke_cluster_selection_mode"primary"Stratégie de choix du cluster cible.

Groupe 7 : Sauvegarde et maintenance​

VariableValeur par défautNotes
backup_schedule"0 2 * * *"Quotidiennement à 02:00 UTC. Ajustez à votre fenêtre de maintenance préférée.
backup_retention_days7Rétention de 7 jours. Augmentez pour les déploiements de production (30 à 90 jours recommandés).

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

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

Job db-init par défaut d'Umami :

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

ChampValeur
Nom du jobdb-init
ImageImage client PostgreSQL
ObjectifPré-crée la base de données et l'utilisateur PostgreSQL Umami avant qu'Umami n'exécute ses propres migrations Prisma
Exécuter à chaque applytrue
CPU / Mémoire1000m / 512Mi

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

CronJobs : Les variables cron_jobs et additional_services sont disponibles et se comportent de manière identique à App_GKE. Utilisez cron_jobs pour des tâches telles que des exportations régulières de données analytiques ou la maintenance de la base de données.

Note : Le schéma cron_jobs dans Umami GKE utilise les champs CronJob de Kubernetes — restart_policy, concurrency_policy, failed_jobs_history_limit, successful_jobs_history_limit, starting_deadline_seconds, suspend.


Groupe 9 : Politiques de fiabilité​

Identique à App_GKE. Voir App_GKE.

VariableValeur par défautNotes
enable_pod_disruption_budgettrueActivé par défaut. Empêche tous les pods Umami d'être évincés simultanément pendant la maintenance du cluster.
pdb_min_available"1"Au moins un pod Umami doit rester disponible pendant les interruptions volontaires.
enable_topology_spreadfalseActivez pour les déploiements à haute disponibilité afin de répartir les pods sur plusieurs zones.
topology_spread_strictfalseLorsque true, utilise la contrainte de répartition DoNotSchedule.

Groupe 10 : Observabilité et santé​

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

Point de terminaison de santé Umami : Umami expose /api/heartbeat comme son point de terminaison de santé dédié. Ce point de terminaison renvoie HTTP 200 lorsque Umami est en cours d'exécution et connecté à PostgreSQL. Toutes les configurations de sonde par défaut utilisent ce chemin.

VariableValeur par défaut Umami GKENotes
startup_probe_config{ enabled=true, path="/api/heartbeat", initial_delay_seconds=30, failure_threshold=30 }Un failure_threshold élevé permet les migrations Prisma au premier démarrage.
health_check_config{ enabled=true, path="/api/heartbeat", initial_delay_seconds=30, failure_threshold=3 }Sonde de vivacité — redémarre les pods non sains.
uptime_check_config{ enabled=false, path="/api/heartbeat" }Test de disponibilité Cloud Monitoring. Désactivé par défaut.
alert_policies[]Politiques d'alerte de métriques personnalisées Cloud Monitoring.

Note sur la sonde de démarrage : Le failure_threshold = 30 avec period_seconds = 10 donne à Umami jusqu'à 5 minutes (plus le délai initial de 30 secondes) pour terminer le démarrage et exécuter les migrations Prisma sur une nouvelle base de données. Lors des redémarrages ultérieurs (migrations déjà appliquées), le démarrage est beaucoup plus rapide.


Groupe 11 : Automatisation des charges de travail (Jobs)​

VariableValeur par défautDescription
initialization_jobs[]Jobs Kubernetes à exécuter avant le démarrage de l'application Umami. Laisser vide pour que Umami Common fournisse le job db-init par défaut.
cron_jobs[]Ressources Kubernetes CronJob récurrentes.
additional_services[]Services sidecar ou auxiliaires déployés à côté du conteneur Umami principal.

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

Identique à App_GKE. Voir App_GKE.

VariableValeur par défautDescription
enable_cicd_triggerfalseProvisionne un déclencheur GitHub Cloud Build.
github_repository_url""URL HTTPS complète du dépôt GitHub.
github_token""Jeton d'accès personnel GitHub. Sensible.
github_app_installation_id""ID d'installation de l'application GitHub.
cicd_trigger_config{ branch_pattern = "^main$" }Configuration avancée du déclencheur Cloud Build.
enable_cloud_deployfalsePasse à un pipeline Google Cloud Deploy géré.
cloud_deploy_stages[dev, staging, prod(approval)]Étapes de promotion ordonnées.
enable_binary_authorizationfalseApplique la politique d'autorisation binaire sur le cluster GKE.
binauthz_evaluation_mode"ALWAYS_ALLOW"Mode d'application de l'autorisation binaire. Non référencé.

Groupe 13 : NFS​

Umami ne nécessite pas NFS. enable_nfs est par défaut false. Toutes les données Umami sont stockées dans PostgreSQL.

VariableValeur par défautDescription
enable_nfsfalseProvisionne une instance Cloud Filestore (NFS). Non requis pour Umami.
nfs_mount_path"/mnt/nfs"Chemin de montage NFS du conteneur. Utilisé uniquement lorsque enable_nfs = true.
nfs_instance_name""Nom d'une VM NFS GCE existante. Découverte automatiquement si vide.
nfs_instance_base_name"app-nfs"Nom de base pour une VM NFS GCE intégrée.
nfs_volume_name"nfs-data-volume"Nom du volume Kubernetes pour le montage NFS.

Groupe 14 : Cloud Storage​

Umami ne nécessite pas de buckets GCS. storage_buckets est par défaut une liste vide.

VariableValeur par défautDescription
create_cloud_storagetrueContrôle si le module provisionne les buckets GCS définis dans storage_buckets.
storage_buckets[]Configurations de bucket GCS. Vide par défaut — Umami est sans état.
gcs_volumes[]Buckets GCS à monter via le pilote CSI GCS Fuse.
manage_storage_kms_iamfalseCrée un trousseau de clés CMEK KMS pour les buckets GCS.
enable_artifact_registry_cmekfalseCrée une clé KMS Artifact Registry pour le chiffrement des images au repos.
max_images_to_retain7Nombre maximal d'images conteneurs à conserver dans Artifact Registry.
delete_untagged_imagestrueSupprime automatiquement les images non étiquetées d'Artifact Registry.
image_retention_days30Jours après lesquels les images sont éligibles à la suppression.

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

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

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

VariableValeur par défaut Umami GKEValeur par défaut App GKENotes
database_type"POSTGRES""POSTGRES"Umami nécessite PostgreSQL. Ne pas changer pour MySQL ou NONE.
application_database_name"umami""gkeappdb"Ne pas modifier après le déploiement — la modification recrée la base de données et détruit toutes les données analytiques.
application_database_user"umami""gkeappuser"Ne pas modifier après le déploiement.
database_password_length3232Longueur du mot de passe auto-généré. Plage : 16–64.

Rotation automatique des mots de passe :

VariableValeur par défautDescription
enable_auto_password_rotationfalseDéploie un job de rotation automatique des mots de passe de la base de données.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer les pods.

Extensions PostgreSQL :

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

Groupe 19 : Domaine personnalisé et IP statique​

Identique à App_GKE. Voir App_GKE.

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne une ressource Kubernetes Ingress pour le routage de domaine personnalisé. Activé par défaut.
application_domains[]Noms de domaine personnalisés (par exemple, ["analytics.example.com"]).
reserve_static_iptrueRéserve une IP statique globale pour l'équilibreur de charge. Recommandé pour les déploiements de production.
static_ip_name""Nom de l'IP réservée. Auto-généré si vide.
enable_cdnfalseActive Cloud CDN sur le backend Ingress GKE.
network_tags[]Balises réseau de pare-feu VPC appliquées aux nœuds GKE.
network_name""Nom du réseau VPC. Auto-découvert si vide.

Groupe 21 : Importation de sauvegarde​

VariableValeur par défautDescription
enable_backup_importfalseDéclenche un job d'importation de base de données unique pendant le déploiement.
backup_source"gcs"Source du fichier de sauvegarde : "gcs" ou "gdrive".
backup_file"backup.sql"Nom du fichier de sauvegarde à importer.
backup_format"sql"Format de sauvegarde : sql, tar, gz, tgz, tar.gz, zip, auto.

Groupe 8 : Quota de ressources​

Identique à App_GKE. Voir App_GKE.

VariableValeur par défautDescription
enable_resource_quotafalseCrée un ResourceQuota Kubernetes dans l'espace de noms de l'application.
quota_cpu_requests""Requêtes CPU totales autorisées dans l'espace de noms.
quota_cpu_limits""Limites CPU totales autorisées dans l'espace de noms.
quota_memory_requests""Requêtes mémoire totales. Doit utiliser des suffixes d'unité binaire (par exemple, "4Gi", "8192Mi").
quota_memory_limits""Limites mémoire totales. Doit utiliser des suffixes d'unité binaire.

Attention : quota_memory_requests et quota_memory_limits doivent utiliser des suffixes binaires (Gi, Mi) lorsqu'ils sont définis. Les entiers bruts (par exemple, "4") sont traités comme des octets par Kubernetes et bloqueront toute planification de pod avec une erreur de dépassement de quota.


Cache Redis​

Umami n'utilise pas Redis — il stocke toutes les données analytiques directement dans PostgreSQL sans couche de cache. La variable enable_redis est déclarée dans Umami_GKE uniquement pour satisfaire la mise en miroir des variables de Foundation ; elle n'est pas transmise à l'appel App_GKE, donc la modifier n'a aucun effet.

VariableValeur par défautDescription
enable_redistrueDéclaration inerte (mise en miroir de Foundation uniquement) — non transmise à App_GKE, donc aucune variable d'environnement Redis n'est injectée quelle que soit la valeur.

Si vous avez besoin de Redis pour une intégration personnalisée ou un service adjacent, utilisez additional_services pour déployer un sidecar Redis, ou configurez Memorystore indépendamment.


Groupe 22 : Contrôles de service VPC​

VariableValeur par défautDescription
enable_vpc_scfalseApplique les périmètres des contrôles de service VPC autour des API GCP.
vpc_cidr_ranges[]Plages CIDR de sous-réseau VPC pour le niveau d'accès réseau VPC-SC.
vpc_sc_dry_runtrueEnregistre les violations sans les bloquer.
organization_id""ID d'organisation GCP pour VPC-SC. Découvert automatiquement si vide.
enable_audit_loggingfalseActive les journaux d'audit Cloud détaillés.

Exploration avec la console GCP​

Après un déploiement réussi, explorez l'installation Umami dans la console GCP :

Charge de travail GKE : Accédez à Kubernetes Engine → Charges de travail. Trouvez le déploiement nommé d'après votre application_name et tenant_id. Cliquez pour afficher :

  • L'état du pod, le nombre de redémarrages et l'âge.
  • L'onglet Journaux — diffuse les journaux des conteneurs des pods Umami en cours d'exécution.
  • L'onglet Détails — affiche la spécification du déploiement, les limites de ressources, la configuration de la sonde et les variables d'environnement (non sensibles).
  • L'Historique des révisions — liste les ReplicaSets précédents.

Services et Ingress GKE : Accédez à Kubernetes Engine → Services et Ingress. Trouvez le service pour votre déploiement Umami. Affichez :

  • L'adresse IP externe (si service_type = "LoadBalancer" ou reserve_static_ip = true).
  • Les mappages de ports.
  • L'état de la vérification de l'état de l'équilibreur de charge.

Instance Cloud SQL : Accédez à SQL. Trouvez l'instance nommée app-sql-<deployment_id>. Explorez :

  • Vue d'ensemble — nom de la connexion, version de PostgreSQL, utilisation du stockage.
  • Bases de données — la base de données umami avec toutes les tables analytiques.
  • Utilisateurs — l'utilisateur de l'application umami.
  • Opérations — historique des maintenances, basculements et sauvegardes.

Secret Manager : Accédez à Sécurité → Secret Manager. Trouvez le secret secret-<tenant_resource_prefix>-<application_name>-app-secret (injecté comme APP_SECRET) pour ce déploiement. Cliquez pour afficher :

  • Les versions du secret et les horodatages de création.
  • Le journal d'accès montrant quand les pods GKE ont lu le secret.
  • La configuration de la rotation.

Artifact Registry : Accédez à Artifact Registry. Trouvez le dépôt pour ce déploiement. Affichez les images Umami mises en miroir depuis GitHub Container Registry, leurs balises et la politique de rétention.

Cloud Monitoring : Si uptime_check_config.enabled = true a été défini, accédez à Surveillance → Tests de disponibilité pour afficher les résultats du test de disponibilité /api/heartbeat dans les régions GCP. Accédez à Surveillance → Tableaux de bord pour trouver le tableau de bord GKE auto-provisionné avec les métriques CPU, mémoire et requêtes.


Exploration avec gcloud et kubectl​

Utilisez ces commandes pour inspecter le déploiement Umami GKE. Remplacez PROJECT_ID, CLUSTER_NAME, REGION, NAMESPACE et DEPLOYMENT_NAME par vos valeurs.

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

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

# Describe the Umami deployment
kubectl describe deployment DEPLOYMENT_NAME -n NAMESPACE

# View Umami pod logs
kubectl logs -n NAMESPACE -l app=DEPLOYMENT_NAME --tail=100

# Follow live logs from all Umami pods
kubectl logs -n NAMESPACE -l app=DEPLOYMENT_NAME -f

# Check resource usage across Umami pods
kubectl top pods -n NAMESPACE

# Check HPA status (horizontal pod autoscaling)
kubectl get hpa -n NAMESPACE

# Describe the Kubernetes Service
kubectl get service -n NAMESPACE
kubectl describe service SERVICE_NAME -n NAMESPACE

# Check pod environment variables (non-sensitive)
kubectl exec -n NAMESPACE POD_NAME -- env | grep -v PASSWORD | grep -v SECRET

# Test health endpoint from inside a pod
kubectl exec -n NAMESPACE POD_NAME -- \
wget -qO- http://localhost:3000/api/heartbeat

# Check Cloud SQL instance
gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID \
--format="table(name,state,databaseVersion,settings.tier)"

# List databases
gcloud sql databases list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

# Check Secret Manager secrets
gcloud secrets list \
--project=PROJECT_ID \
--filter="name~umami" \
--format="table(name,createTime)"

# List Artifact Registry images
gcloud artifacts docker images list \
REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME \
--project=PROJECT_ID \
--format="table(image,tags,createTime)"

# Check Kubernetes namespace resource quota (if enabled)
kubectl describe resourcequota -n NAMESPACE

# View PodDisruptionBudget
kubectl get pdb -n NAMESPACE

# Check recent Kubernetes events for the namespace
kubectl get events -n NAMESPACE --sort-by='.metadata.creationTimestamp' | tail -20

# Check Cloud Monitoring uptime checks
gcloud monitoring uptime list-configs \
--project=PROJECT_ID \
--format="table(displayName,httpCheck.path,period,timeout)"

Sorties du module​

Umami GKE expose les sorties Terraform suivantes :

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

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

Niveaux de risque : Critique (perte de données, panne totale, 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"CritiqueUmami nécessite PostgreSQL. Le fait de le définir sur MySQL ou NONE entraîne l'échec de l'assemblage de DATABASE_URL et Umami ne peut pas se connecter à la base de données.
application_database_name"umami"CritiqueLa modification de cette valeur après le déploiement initial détruit toutes les données analytiques collectées. La base de données est recréée vide tandis que les anciennes données restent orphelines dans Cloud SQL.
application_database_user"umami"CritiqueLa modification de cette valeur après le déploiement initial recrée l'utilisateur Cloud SQL, invalidant les identifiants et rompant toute connectivité à la base de données.
container_port3000CritiqueUmami écoute sur 3000. Une non-concordance entraîne l'échec de toutes les sondes de santé et Kubernetes redémarre continuellement le pod.
container_image_source"custom"ÉlevéL'image officielle d'Umami n'accepte pas les variables DB_* individuelles — elle nécessite un DATABASE_URL entièrement formé. L'utilisation de "prebuilt" sans définir manuellement DATABASE_URL dans environment_variables entraînera l'échec d'Umami au démarrage avec une erreur de connexion à la base de données manquante.
application_version"postgresql-latest"ÉlevéDoit utiliser une balise préfixée par postgresql-. Les balises simples (par exemple, latest) n'existent pas pour la variante PostgreSQL d'Umami. Une balise invalide entraîne l'échec du pull du conteneur.
admin_password(à changer lors de la première connexion)CritiqueLes identifiants par défaut (admin / umami) sont connus publiquement. Les laisser inchangés expose le tableau de bord analytique et toutes les données suivies à quiconque connaît l'URL du service.
container_resources.memory_limit"512Mi"Moyen512 Mio sont suffisants pour un trafic léger à modéré. En cas d'utilisation intensive et concurrente du tableau de bord ou de requêtes analytiques complexes, Umami peut manquer de mémoire. Augmentez à 1Gi si une pression mémoire est observée.
enable_cloudsql_volumetrueCritiqueUmami se connecte à Cloud SQL via le socket Unix du proxy d'authentification. La désactivation de cette option supprime le socket, entraînant l'échec de toutes les connexions à la base de données.
startup_probe_config.failure_threshold30ÉlevéAvec period_seconds = 10, un failure_threshold de 30 donne à Umami jusqu'à 5 minutes pour démarrer et exécuter les migrations Prisma. Réduire cette valeur en dessous de 10 peut entraîner le redémarrage du pod par Kubernetes avant la fin des migrations, créant une boucle de redémarrage sur les nouveaux déploiements.
session_affinity"None"FaibleUmami est entièrement sans état — aucune affinité de session n'est requise. Toutes les requêtes peuvent être traitées par n'importe quel pod sans problèmes de cohérence.
min_instance_count1MoyenAu moins un pod Umami doit toujours être en cours d'exécution pour que les données analytiques soient collectées. La mise à l'échelle à zéro entraînerait des lacunes dans les données pendant les périodes sans trafic de tableau de bord.
quota_memory_requests / quota_memory_limits""Critique (spécifique à GKE)Doit utiliser des suffixes binaires (Gi, Mi) lorsqu'il est défini. Les entiers bruts sont traités comme des octets, bloquant toute planification de pod avec une erreur de dépassement de quota.
enable_pod_disruption_budgettrueMoyenDéjà activé par défaut. La désactivation permet à tous les pods d'être terminés simultanément lors des mises à niveau des nœuds GKE Autopilot, entraînant de brèves interruptions de service.
backup_retention_days7MoyenLa perte de données analytiques est difficile à récupérer. Augmentez à 30 jours et plus pour les déploiements de production où les données analytiques historiques ont une valeur commerciale.
enable_backup_importfalseÉlevéDéfinir cette valeur sur true déclenche une restauration de base de données à chaque apply. N'activez cette option que pour la migration initiale depuis une instance Umami existante ; remettez-la immédiatement à false.
enable_vpc_scfalseMoyenLe périmètre VPC-SC n'est actif que lorsque organization_id est également défini. Sans les deux, enable_vpc_sc = true n'a aucun effet d'application.

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