PostHog sur GKE Autopilot
PostHog est une plateforme open source d'analyse de produits — analyse d'événements, relecture de sessions, indicateurs de fonctionnalités, tests A/B et entonnoirs — publiée sous une licence hybride MIT/PostHog-commerciale. Elle fonctionne comme une application web Python/Django avec un planificateur Celery worker+beat colocalisé, et son pipeline d'événements est construit autour de deux services stateful supplémentaires : Kafka comme épine dorsale d'ingestion et ClickHouse comme magasin d'événements analytiques. Ce module déploie PostHog sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes.
Ce guide se concentre sur les services cloud utilisés par PostHog et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, 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_GKE plutôt que de les répéter ici.
Pas de variante Cloud Run, par conception. Le pipeline d'événements de PostHog exige Kafka et ClickHouse — deux services stateful et de longue durée incompatibles avec le modèle serverless et de mise à l'échelle à zéro de Cloud Run. Seuls
PostHog_GKEetPostHog_Commonexistent.
Prérequis de déploiement (recommandé, non obligatoire) : Déployer
ClickHouse_GKEen premier et y faire pointerclickhouse_hostest le chemin de production recommandé — correspondant au précédent de dépendance inter-modulesRAGFlow_GKE→Elasticsearch_GKEde ce catalogue. Contrairement àelasticsearch_hostsobligatoire de RAGFlow, PostHog offre également une solution de secours ClickHouse à nœud unique dans le module (enable_inline_clickhouse = true) pour une utilisation en développement/test, de sorte que le plan n'est pas rejeté d'emblée sans une instance externe — mais la validation au moment du plan exige toujours qu'UN des deux chemins soit résolu.
Ce que coûte PostHog sur RAD, et comment cela se compare
L'exécution de PostHog dans votre propre projet Google Cloud coûte environ 257,89 $ US/mois en infrastructure, plus des frais de module uniques de 300 crédits RAD (dimensionnés à 4 vCPU / 16 GiB sur les pods GKE Autopilot). RAD facture les frais de module une seule fois, au moment du déploiement — jamais plus lors d'une mise à jour — et les builds sont inclus dans le prix ; l'utilisation de Google Cloud elle-même est facturée à votre propre compte de facturation au prix catalogue de Google. Sur un projet géré par RAD, les mêmes ressources sont mesurées à l'heure en crédits au prix catalogue plus la marge de RAD — environ 190 crédits/jour — et les frais de module sont 10 % inférieurs, à 270 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement PostHog géré par RAD peut être arrêté, sans frais d'exécution, jusqu'à ce que vous en ayez à nouveau besoin.
Ce que vous payez sur RAD
| Élément | Votre propre projet | Projet géré par RAD |
|---|---|---|
| Frais de module | 300 crédits (une fois) | 270 crédits (une fois) |
| Builds | Inclus 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 build | Identique |
| Coût d'exécution Google Cloud | ~257,89 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google | ~190 crédits/jour, mesurés à l'heure au prix catalogue + marge de RAD |
Coût d'exécution par défaut dans votre propre projet
| Ressource | $/mois (prix catalogue Google, us-central1) |
|---|---|
| Pod GKE Autopilot, 4x vCPU / 16 GiB | 187,44 |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 |
| Cloud NAT et réseau | 5 |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 |
| Frais de gestion de cluster GKE* | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 |
| Total | 257,89 $ |
* Non inclus dans le total ci-dessus — il est partagé entre toutes les applications GKE exécutées dans le même projet, il est donc de 0 $ si c'est votre seul cluster GKE.
Comment cela se compare
- Nous n'avons pas pu vérifier un prix SaaS commercial actuel, directement comparable, pour ce projet open source exact. La comparaison honnête est donc un serveur autogéré nu : Hetzner CPX22 (2 vCPU/4 Go, ~24 $/mois), un Droplet DigitalOcean 2 vCPU/4 Go (~24 $/mois), ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, ~49 $/mois). L'empreinte de cette application (4+ vCPU, plusieurs dizaines de GiB de mémoire) est supérieure à toutes ces catégories — un serveur autogéré dimensionné pour correspondre coûterait bien plus que les chiffres ci-dessous, avant de compter l'effort distinct de gestion manuelle de sa propre base de données/couche de cache.
- RAD ne prétend pas battre un VPS nu sur le prix affiché — ce n'est généralement pas le cas. Ce que RAD ajoute pour un montant en dollars identique ou similaire, c'est une base de données gérée, des identifiants conservés dans Secret Manager, une surveillance et une mise à jour en un clic, qu'un VPS nu ne vous offre pas gratuitement.
- Sur un VPS nu, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, qui effectuez et testez les sauvegardes, et qui renouvelez les certificats ; Cloud SQL géré par RAD, Secret Manager et la surveillance gèrent les trois pour vous.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
C'est l'option principale sur un projet géré par RAD, et elle est gratuite 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 lui-même — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne détruit pas la base de données, une VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend.
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.
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 seulement avoir RAD qui gère sa 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, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude et de démonstration correspondent). 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 sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, de sorte que le bucket de sauvegarde est très probablement supprimé 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é ce déploiement 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'autre levier, pour un projet propre (ou un projet géré par RAD au-delà de sa fenêtre de restauration de 30 jours), consiste à supprimer PostHog purement et simplement et à le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 300 crédits au total pour ce module.
La suppression ne permet d'économiser de l'argent que si PostHog reste inutilisé suffisamment longtemps pour compenser le coût de ce redéploiement par rapport à son propre coût d'exécution — pour ce module, cela représente environ 4 jours ou plus d'inactivité, sur la base de son coût d'exécution de 257,89 $ US/mois mentionné ci-dessus. La majeure partie de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée, et elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise. La suppression de cette seule application n'économise donc que sa propre part de calcul si quelque chose d'autre partage le projet.
Conservez d'abord les données : les sauvegardes nocturnes sont stockées dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci. Copiez donc la dernière sauvegarde avant de la supprimer si vous souhaitez 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 dispose de 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres de RAD et les estimations de crédits quotidiens ; Resource Manager : supprimer et restaurer des projets pour les mécanismes de pause/restauration.
1. Vue d'ensemble
PostHog s'exécute comme une seule charge de travail Python/Django conteneurisée avec un planificateur Celery worker+beat colocalisé (correspondant au point d'entrée tout-en-un par défaut de l'image amont — la même forme que le modèle worker colocalisé de Saleor/Woodpecker de ce catalogue). Le déploiement relie quatre magasins de données indépendants, chacun ayant un rôle distinct, et aucun d'entre eux n'est facultatif :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod PostHog personnalisé, 4 vCPU / 8 GiB par défaut |
| Métadonnées d'application | Cloud SQL pour PostgreSQL 15 | Tables d'application Django uniquement — utilisateurs, équipes, indicateurs de fonctionnalités, tableaux de bord. Aucune donnée analytique. |
| Magasin d'événements analytiques | ClickHouse | Obligatoire. ClickHouse_GKE externe recommandé (production) ; solution de secours à nœud unique dans le module pour le développement/test |
| Épine dorsale d'ingestion | Kafka | Obligatoire. Courtier Redpanda à nœud unique inclus par défaut (pas encore de module Kafka autonome dans ce catalogue) |
| Cache / courtier | Redis | Obligatoire. Courtier Celery, pub/sub du serveur de plugins, cache Django — la plateforme injecte l'IP Redis co-hébergée par le serveur NFS par défaut |
| Stockage d'objets | Cloud Storage (interopérabilité S3) | Enregistrements de relecture de session et exportations de données, via le client natif compatible S3 de PostHog — pas un montage GCS FUSE |
| Secrets | Secret Manager | SECRET_KEY de Django, paire de clés HMAC d'interopérabilité S3, mot de passe de la base de données, CLICKHOUSE_PASSWORD (externe, ou généré pour la solution de secours intégrée) |
| Ingress | Cloud Load Balancing | Service LoadBalancer externe ; domaine personnalisé facultatif + certificat géré |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est fixe, et ce n'est PAS là que résident vos données analytiques. Postgres ne contient que les métadonnées d'application de Django. Chaque événement, personne, index d'enregistrement de session et requête d'analyse s'exécute sur ClickHouse à la place — une forme structurellement différente de la plupart des applications basées sur des bases de données de ce catalogue.
- Redis est obligatoire et ne peut pas être désactivé. Une validation au moment du plan rejette
enable_redis = falsed'emblée. Sansredis_host, la plateforme injecte l'IP Redis co-hébergée par le serveur NFS — c'est pourquoienable_nfsest par défauttruemême si PostHog lui-même n'a pas de dépendance média de système de fichiers. - ClickHouse est obligatoire, externe par défaut.
clickhouse_hostest vide etenable_inline_clickhouse = falseprêt à l'emploi — définissezclickhouse_hostsur une instanceClickHouse_GKEdéployée séparément pour la production, ou activezenable_inline_clickhouse = truepour une solution de secours de développement/test à nœud unique et sans persistance. - Kafka est obligatoire, inclus par défaut.
enable_inline_kafka = truedéploie un courtier Redpanda à nœud unique (compatible avec l'API Kafka, sans Zookeeper) comme entréeadditional_services— pas de volume persistant, acceptable pour un pipeline d'ingestion puisque les événements sont renvoyés/recapturés en cas de perte. - La mise à l'échelle horizontale est désactivée.
max_instance_countest plafonné à1— validé au moment du plan. Le conteneur principal colocalise le worker Celery avec son planificateur beat (--with-scheduler) ; N réplicas exécuteraient N planificateurs beat en double, déclenchant chaque tâche périodique N fois. - Une image personnalisée est toujours construite. Cloud Build étend
posthog/posthogavec un point d'entrée cloud et une surchargedocker-boot.sh(voir §3) — contrairement à la plupart des applications avec étiquettelatestde ce catalogue,posthog/posthogpublie une étiquettelatestvéritablement fraîche suivant la branche master, donc aucune substitution d'étiquette roulante n'est nécessaire, seulement la solution de contournement de nommage build-ARG standard. - Le stockage d'objets est S3-interop, pas GCS FUSE. Le stockage de relecture de session/exportation passe par le client natif compatible S3 de PostHog vers l'API S3-interop de GCS via un compte de service dédié + paire de clés HMAC.
enable_custom_domainest par défauttrue. Combiné avec lereserve_static_ip = truepar défaut, cela provisionne un certificat géré et HTTPS prêt à l'emploi via un nom d'hôte<ip>.nip.iomême lorsqueapplication_domainsest laissé vide.- Le CPU/la mémoire sont pré-dimensionnés au-dessus des valeurs par défaut génériques.
cpu_limit = "4000m"/memory_limit = "8Gi"— tous deux augmentés après vérification en direct du premier démarrage véritablement lourd de PostHog (Django enregistre ~80 sous-applicationsproducts, plus le worker+beat Celery colocalisé).
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que vous avez exécuté
gcloud container clusters get-credentials <cluster> --region <region> --project <project>
et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres
identifiants sont signalés dans les Sorties du déploiement.
A. GKE Autopilot — la charge de travail PostHog
Le pod PostHog exécute le serveur web Django/gunicorn et le planificateur Celery
worker+beat colocalisé dans un seul conteneur, correspondant à la séquence de
démarrage bin/docker par défaut de PostHog.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail PostHog pour voir les pods, les révisions et les événements.
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
# First lines of a healthy boot show the resolved config the cloud entrypoint composed:
kubectl logs -n "$NAMESPACE" deploy/<service-name> | grep -A6 'cloud-entrypoint'
Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail
(Déploiement vs StatefulSet). Notez que max_instance_count est
limité à 1 pour ce module — voir §4.
B. Cloud SQL pour PostgreSQL 15 — métadonnées d'application Django uniquement
PostHog stocke ses propres métadonnées d'application Django (comptes d'utilisateurs, équipes/projets,
définitions d'indicateurs de fonctionnalités, tableaux de bord) dans une instance Cloud SQL pour PostgreSQL 15 gérée,
accessible en privé via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1. Ce n'est
PAS là que résident les données analytiques — voir §C. Lors du premier déploiement, un Job d'initialisation
(db-init) crée la base de données et l'utilisateur de l'application ; les propres migrations Django de PostHog
s'exécutent automatiquement à chaque démarrage de conteneur.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs et 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, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.
C. ClickHouse — le véritable magasin d'événements analytiques
Chaque événement, enregistrement de personne, index de relecture de session et requête d'analyse/entonnoir s'exécute sur ClickHouse, et non sur Postgres — c'est la conception fondamentale de PostHog, pas un détail d'implémentation. Ce module ne gère pas directement une instance ClickHouse durable :
- Recommandé (production) : déployez
ClickHouse_GKEséparément et définissezclickhouse_hostsur son DNS/IP de service interne.clickhouse_password_secretaccepte un ID de secret Secret Manager (par exemple, la sortie de ce déploiement) et est injecté commeCLICKHOUSE_PASSWORD. - Solution de secours pour le développement/test :
enable_inline_clickhouse = truedéploie une instance ClickHouse à nœud unique en tant queadditional_serviceGKE à côté de PostHog — un seul nœud, avec son répertoire de données sur un volume persistant (clickhouse_disk_size, par défaut20Gi). Le mot de passe de son utilisateurdefaultest généré par déploiement et fourni par Secret Manager.
# Confirm PostHog can reach ClickHouse (native protocol, port 9000):
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- \
sh -c 'echo "SELECT 1" | curl -s "http://$CLICKHOUSE_HOST:8123/" --data-binary @-'
# If using the in-module fallback, inspect it directly:
kubectl get pods -n "$NAMESPACE" -l app=<service-name>-clickhouse
kubectl logs -n "$NAMESPACE" deploy/<service-name>-clickhouse
La solution de secours intégrée a nécessité un bootstrap véritablement étendu pour que les migrations de schéma de PostHog réussissent sur un seul nœud — un ClickHouse Keeper intégré (les tables de suivi des migrations de PostHog utilisent ReplicatedMergeTree, qui nécessite un coordinateur compatible ZooKeeper même pour un seul nœud), des macros de cluster/shard/réplica, dix clusters nommés (tous pointant vers le même nœud), des collections nommées pour les tables Kafka Engine, et un mot de passe — généré par déploiement et lu par l'application, le job de migration et le pod ClickHouse (un mot de passe vide désactive entièrement l'accès réseau pour l'utilisateur default — cela ne signifie pas "ouvert, non authentifié", confirmé par rapport au point d'entrée officiel clickhouse/clickhouse-server). La propre migration ClickHouse de PostHog nécessite également l'interface HTTP (port 8123) en plus du protocole natif (port 9000) — l'utilisation par ce module d'un deuxième port sur une entrée additional_services a motivé l'ajout d'un nouveau champ extra_ports à App_GKE lui-même (voir §3). Étant donné que les dictionnaires de PostHog stockent le mot de passe ClickHouse dans leur DDL sur le volume persistant, le script de démarrage du pod réécrit ces mots de passe stockés avec le mot de passe actuel avant le démarrage du serveur, de sorte qu'un changement de mot de passe ne rompt pas dictGet.
D. Kafka — l'épine dorsale d'ingestion
Kafka se situe entre la capture d'événements et ClickHouse. Sans lui, le pipeline d'ingestion de PostHog
(confirmé par rapport à docker-compose.hobby.yml actuel : web/worker/plugin-server
en dépendent tous) n'a nulle part où mettre en file d'attente les événements entrants.
- Par défaut :
enable_inline_kafka = truedéploie un courtier Redpanda à nœud unique (compatible avec l'API Kafka, sans Zookeeper — prend officiellement en charge un mode "conteneur de développement" à processus unique) en tant queadditional_serviceGKE. Pas de volume persistant — un replanification de pod perd les événements non consommés, acceptable pour un pipeline d'ingestion où les événements sont renvoyés/recapturés. - Alternative de production : définissez
kafka_hostspour pointer vers un courtier exploité en externe.
kubectl get pods -n "$NAMESPACE" -l app=<service-name>-kafka
kubectl logs -n "$NAMESPACE" deploy/<service-name>-kafka --tail=50
E. Redis — courtier Celery, pub/sub du serveur de plugins, cache Django
Redis est obligatoire et ne peut pas être désactivé — enable_redis = false est rejeté au moment du plan.
Sans redis_host défini, la plateforme injecte l'IP Redis co-hébergée par le serveur NFS
(c'est pourquoi enable_nfs est par défaut true, même si PostHog n'a pas de dépendance média de système de fichiers propre).
- CLI :
redis-cli -h <redis-host> ping
redis-cli -h <redis-host> info clients
F. Cloud Storage — stockage d'objets S3-interop
PostHog n'a pas de bibliothèque de médias de système de fichiers. Les enregistrements de relecture de session et les exportations de données passent par le client natif compatible S3 de PostHog, pointant vers l'API XML S3-interop de GCS via un compte de service dédié et une paire de clés HMAC — pas un montage GCS FUSE.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT"
gcloud storage ls gs://<storage-bucket>/ # bucket name is in the Outputs
G. Secret Manager
Le SECRET_KEY de Django (signature de session — généré une fois, jamais régénéré lors du redéploiement ;
sa rotation invalide chaque session active), la paire de clés HMAC d'accès/secret S3-interop,
et le mot de passe de la base de données sont tous stockés en tant que secrets Secret Manager et injectés
dans les pods au moment de l'exécution.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~posthog"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
H. Réseau et ingress
enable_custom_domain est par défaut true, ce qui achemine la charge de travail via l'équilibreur de charge de l'API Gateway avec un certificat géré par Google — servant automatiquement HTTPS sur un nom d'hôte <ip>.nip.io lorsque application_domains est vide. site_url (injecté comme SITE_URL, utilisé par PostHog pour construire des liens absolus — tableaux de bord, analyses partagées, charges utiles de webhook) doit être défini une fois qu'un nom d'hôte réel ou une IP statique est configuré ; il est par défaut l'URL intra-cluster prédite sinon.
kubectl get ingress,svc -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les détails sur les domaines personnalisés, Cloud CDN et les IP statiques.
I. Cloud Logging et Monitoring
Les flux stdout/stderr des pods vers Cloud Logging ; les métriques GKE et Cloud SQL vers Cloud Monitoring. Des tests de disponibilité et des politiques d'alerte facultatifs sont disponibles.
gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
--project "$PROJECT" --limit 50
3. Comportement de l'application PostHog
- Configuration de la base de données au premier déploiement. Un job d'initialisation (
db-init,postgres:15-alpine) crée la base de données et l'utilisateur PostgreSQL avant le démarrage de l'application. Aucune extension n'est installée — contrairement à de nombreuses applications de ce catalogue, PostHog n'en a pas besoin ; tout le stockage spécifique à l'analyse est dans ClickHouse. - Un deuxième job d'initialisation
clickhouse-migratedédié s'exécute jusqu'à la fin avant le démarrage de l'application. Le proprebin/migratede PostHog (exécuté à chaque démarrage de conteneur) lance la migration de schéma ClickHouse dans un sous-shell en arrière-plan qui s'exécute concurremment avec la migration Postgres au premier plan — et atteint sa vérification de migration asynchrone (run_async_migrations, qui interroge ClickHouse pour les tables que le job en arrière-plan peut encore être en train de créer) avant d'attendre ce job en arrière-plan. Sur une base de données fraîche, cela plante avecIndexError: list index out of rangeà chaque démarrage, pour toujours — le redémarrage ne permet pas à ClickHouse de "rattraper son retard" carbin/migraterefait toujours la même course à partir d'un démarrage à froid. Le jobclickhouse-migratede ce module exécute préalablementbin/migrate --scope=clickhousejusqu'à la fin sans que rien d'autre ne concurrence le même budget de temps, évitant ainsi complètement la course. - Les migrations Django s'exécutent automatiquement à chaque démarrage de conteneur, via
./bin/migrate(faisant partie de la séquence de démarrage par défaut intégrée à l'image personnalisée). - Le composant plugin-server Node.js est absent de l'image amont actuelle.
Vérifié en direct :
/code/nodejsest absent deposthog/posthog(à la fois:latestet un build vieux de 6 jours), mais le script de démarrage amont réessaie toujours de s'y connecter toutes les 2 secondes, bloquant le CPU à 100 % et affamant le processus qui doit répondre à la sonde de démarrage. Ledocker-boot.shde ce module ignore ce composant — l'ingestion d'événements et l'analyse de base fonctionnent bien ; les fonctionnalités dépendantes des plugins peuvent ne pas fonctionner tant que l'amont ne le restaure pas. Voir PostHog_Common pour le diagnostic complet. - Secrets immuables générés au premier démarrage.
SECRET_KEYet la paire de clés HMAC S3-interop sont générés une fois et jamais régénérés lors du redéploiement — la rotation deSECRET_KEYaprès le premier démarrage invalide chaque session active. - Points de terminaison de santé.
GET /_readyz(démarrage) effectue des vérifications approfondies des dépendances (état de la migration Postgres, ClickHouse, Kafka, courtier Celery, cache — vérifié à la source par rapport àposthog/health.py) avec unfailure_threshold = 145délibérément grand (~25 minutes) pour s'adapter aux migrations Django au premier démarrage.GET /_livez(vivacité) est la vérification légère qui ne vérifie pas les dépendances en aval. - La première exécution est interactive. Visitez l'interface web après le déploiement et créez le compte administrateur sur l'écran d'inscription — aucune information d'identification d'administrateur pré-remplie n'existe dans Secret Manager.
- Réplica unique par conception.
max_instance_countest plafonné à1— le conteneur principal colocalise le worker Celery avec son planificateur beat ; l'exécution de N réplicas déclencherait chaque tâche périodique N fois.
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 PostHog sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour la charge de travail et les ressources régionales. |
clickhouse_host | "" | Point de terminaison ClickHouse (nom d'hôte/IP nu, sans schéma). Recommandé : le DNS/IP de service interne d'un ClickHouse_GKE déployé séparément. |
clickhouse_port | 9000 | Port TCP du protocole natif ClickHouse (utilisé uniquement lorsque clickhouse_host est défini). |
kafka_hosts | "" | Adresses du courtier Kafka, host:port. Laissez vide pour le courtier Redpanda inclus. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Court suffixe 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 pour le suivi des coûts/de la propriété. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | posthog | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | PostHog Product Analytics | Nom convivial affiché dans la console. |
application_version | latest | Étiquette d'image posthog/posthog. PostHog publie une étiquette latest véritablement fraîche suivant la branche master — utilisée telle quelle, pas de substitution d'étiquette roulante. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
cpu_limit | 4000m | Augmenté par rapport à une valeur par défaut générique de 2000m après des délais d'expiration de sonde de démarrage vérifiés en direct (~95 % de saturation du CPU lors du premier démarrage). |
memory_limit | "16Gi" | Augmenté après des arrêts OOM vérifiés en direct à 4 Gi, 6 Gi et 8 Gi lors du premier démarrage — l'image enregistre plus de 90 sous-applications Django au démarrage. |
container_port | 8000 | Le port natif du serveur Django/gunicorn. |
min_instance_count | 1 | Réplicas minimum. |
max_instance_count | 1 | Plafonné à 1, validé au moment du plan — planificateur Celery beat colocalisé. |
enable_cloudsql_volume | true | Sidecar Cloud SQL Auth Proxy pour les connexions socket. |
Groupe 5 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres supplémentaires non secrets. Ne pas remplacer CLICKHOUSE_*, KAFKA_HOSTS, OBJECT_STORAGE_* — ceux-ci sont injectés automatiquement. |
secret_environment_variables | {} | Mappage variable d'environnement → nom de secret Secret Manager. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Comment le service est exposé. |
session_affinity | ClientIP | Routage persistant. |
network_tags | ["nfsserver"] | Étiquettes de nœud/pod ; nfsserver est requis pour la connectivité NFS (voir la note enable_nfs dans le groupe 13). |
Groupe 7 — Configuration StatefulSet
S'applique uniquement lorsque workload_type = "StatefulSet" ou stateful_pvc_enabled = true ;
PostHog lui-même n'a pas d'exigence de stockage persistant par pod (les données analytiques sont
résidentes dans ClickHouse, pas locales).
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe_config / startup_probe | HTTP /_readyz, vérifications approfondies des dépendances | failure_threshold délibérément grand (~25 min) pour couvrir les migrations Django au premier démarrage. |
health_check_config / liveness_probe | HTTP /_livez | Vérification de vivacité légère — ne vérifie pas les dépendances en aval. |
uptime_check_config | { enabled=false, path="/_livez" } | Test de disponibilité Cloud Monitoring facultatif ; désactivé par défaut. |
Groupe 11 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laissez vide pour utiliser les jobs db-init + clickhouse-migrate intégrés. |
additional_services | [] | Services supplémentaires fournis par l'opérateur uniquement — le courtier Redpanda inclus et la solution de secours ClickHouse facultative dans le module sont injectés automatiquement et ne font PAS partie de cette liste. |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | Conservé true uniquement parce que c'est le mécanisme qui rend l'IP Redis co-hébergée disponible — PostHog n'a pas de dépendance média de système de fichiers propre. |
nfs_mount_path | /mnt/nfs | Inerte pour PostHog. |
Groupe 14 — Cloud Storage
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Provisionne le bucket GCS utilisé par le client compatible S3 natif de PostHog (relecture de session, exportations). |
storage_buckets | [{ name_suffix="storage" }] | Le seul bucket dans lequel le client S3-interop de PostHog écrit. |
gcs_volumes | [] | Non utilisé — PostHog n'a pas de bibliothèque de médias de système de fichiers. |
Groupe 15 — ClickHouse et Kafka
| Variable | Valeur par défaut | Description |
|---|---|---|
clickhouse_database | posthog | Nom de la base de données ClickHouse où les événements sont lus/écrits. |
clickhouse_user | default | Nom d'utilisateur ClickHouse. |
clickhouse_password_secret | "" | ID du secret Secret Manager contenant le mot de passe ClickHouse (par exemple, d'un ClickHouse_GKE déployé séparément). Laissez vide pour la solution de secours intégrée, qui obtient un mot de passe généré par déploiement dans Secret Manager. |
enable_inline_clickhouse | false | ClickHouse à nœud unique en tant que additional_service GKE. Développement/test uniquement — un seul nœud, données sur un volume persistant (clickhouse_disk_size). |
clickhouse_image_tag | 26.6.1.1193 | Épinglé à la version exacte utilisée par le docker-compose.base.yml de PostHog — une étiquette générique récente (par exemple 24.12-alpine) échoue à une vérification d'expression TTL dans l'une des propres migrations de PostHog. |
enable_inline_kafka | true | Courtier Redpanda à nœud unique en tant que additional_service GKE — la valeur par défaut. |
kafka_image_tag | v25.1.9 | Étiquette d'image Redpanda. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES (fixé à POSTGRES_15 par PostHog_Common) | Métadonnées d'application uniquement — les données analytiques résident dans ClickHouse. |
db_name | posthog_db | Nom de la base de données. Immuable après le premier déploiement. |
db_user | posthog_user | Utilisateur de l'application. Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Provisionne l'Ingress pour les noms d'hôte personnalisés + certificat géré. |
application_domains | [] | Noms d'hôte à servir. |
reserve_static_ip | true | IP externe stable entre les redéploiements. |
site_url | "" | Injecté comme SITE_URL — utilisé pour construire des liens absolus (tableaux de bord, analyses partagées, charges utiles de webhook). Par défaut, l'URL intra-cluster prédite ; défini une fois qu'un domaine personnalisé ou une IP statique est configuré. |
Groupe 21 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | true | Obligatoire, validé — ne peut pas être désactivé. Courtier Celery, pub/sub du serveur de plugins, cache Django. |
redis_host | "" | Hôte Redis. Lorsque vide et que NFS est activé, l'IP du serveur NFS est utilisée. |
redis_port | 6379 | Port Redis. |
Pour tous les autres groupes (CI/CD, Sauvegarde et maintenance, SQL personnalisé, IAP, Cloud Armor, VPC Service Controls), PostHog hérite du comportement standard de App_GKE sans surcharges spécifiques à l'application.
5. Sorties
Ces valeurs sont renvoyées en cas de déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
web_url | URL de l'interface utilisateur web de PostHog — servie par le service primaire lui-même (le conteneur Django/gunicorn colocalisé), et non par un frontend séparé. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name | Nom de la base de données de l'application (métadonnées de l'application uniquement). |
database_user | Utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port. |
storage_buckets | Buckets Cloud Storage créés (stockage d'objets interopérable S3). |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
initialization_jobs | Noms des jobs db-init et clickhouse-migrate. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. false lors du premier apply d'un nouveau cluster intégré — relancez l'apply pour terminer le déploiement. |
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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
enable_redis | true (ne peut pas être désactivé) | Critique | Le broker Celery de PostHog, le pub/sub du plugin-server et le cache Django nécessitent tous Redis ; le serveur refuse de démarrer sans lui. |
clickhouse_host / enable_inline_clickhouse | l'un doit être résolu | Critique | Sans un point de terminaison ClickHouse accessible, l'ensemble du pipeline d'événements analytiques de PostHog ne peut pas fonctionner — pas d'événements, pas d'insights, pas de relecture de session. |
kafka_hosts / enable_inline_kafka | l'un doit être résolu (par défaut : intégré) | Critique | Sans Kafka, les événements ingérés n'ont nulle part où être mis en file d'attente — le pipeline s'arrête. |
max_instance_count | 1 (validé, ne peut pas être dépassé) | Critique | Le planificateur Celery beat colocalisé déclenche chaque tâche périodique une fois par réplica ; N réplicas signifie N exécutions en double des jobs planifiés. |
enable_inline_clickhouse | false pour la production | Critique | Le fallback intégré au module est un nœud unique sans réplication — son volume persistant survit à un redémarrage de pod, mais il n'y a pas de redondance ou de sauvegarde gérée pour les données analytiques (événements, relectures de session, insights). |
enable_inline_kafka | true acceptable pour la plupart, false + broker externe pour une mise en file d'attente durable | Élevé | Le Redpanda fourni n'a pas de volume persistant — un replanification de pod perd les événements non consommés (acceptable pour une ingestion renvoyée, pas pour une file d'attente durable). |
redis_host | hôte explicite, ou laisser "" avec enable_nfs=true | Critique | Si aucun n'est défini, REDIS_HOST est vide et PostHog échoue rapidement au démarrage avec une erreur claire. |
db_name / db_user | défini une fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur. Notez que cela n'affecte que les métadonnées de l'application, pas les données analytiques (résidant dans ClickHouse). |
cpu_limit / memory_limit | 4000m / 8Gi minimum | Élevé | En dessous de ces valeurs, le premier démarrage réellement lourd de PostHog (Django enregistrant ~80 sous-applications, plus le worker Celery colocalisé + beat) a été vérifié en direct pour déclencher des timeouts de sonde de démarrage (CPU) ou des OOM kills (mémoire, confirmés à 4Gi et 6Gi). |
clickhouse_image_tag (fallback intégré) | 26.6.1.1193 — ne pas utiliser de tag récent générique | Élevé | Une version récente générique (par exemple 24.12-alpine) échoue à une vérification de validation d'expression TTL utilisée par l'une des propres migrations ClickHouse de PostHog, sans solution de contournement de configuration. |
SECRET_KEY rotation | ne jamais faire pivoter après le premier démarrage | Critique | La rotation de la clé de signature de Django invalide chaque session active. |
enable_iap / enable_cloud_armor | activer pour la production | Moyen | L'interface utilisateur web de PostHog (et l'écran d'inscription initial de l'administrateur) est autrement accessible publiquement. |
site_url | définir une fois qu'un domaine personnalisé/une IP statique existe | Moyen | Laissé à la valeur par défaut intra-cluster prédite, les liens du tableau de bord / les insights partagés / les charges utiles de webhook pointent vers une URL interne inaccessible une fois l'accès externe configuré. |
application_version | latest (véritablement frais, contrairement à plusieurs applications de ce catalogue) | Moyen | L'incrémentation déclenche une reconstruction d'image et un redémarrage progressif ; vérifier la compatibilité du schéma Postgres + ClickHouse pour les sauts de version majeure. |
Pour le comportement de base référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à PostHog est décrite dans PostHog_Common.
Guides associés
- Lab pratique : PostHog sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- PostHog Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de ClickHouse sur GKE Autopilot, Plausible Analytics sur GKE Autopilot, Metabase sur GKE Autopilot dans la solution Product Analytics.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.