Aller au contenu principal

Formbricks sur Google Cloud Run

Formbricks sur Google Cloud Run

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


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

L'exécution de Formbricks dans votre propre projet Google Cloud coûte environ 83,61 US$/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 110 crédits (99 crédits — 10 % de moins — dans un projet géré par RAD). Formbricks est une plateforme open source de gestion d'enquêtes et d'expériences. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et reprendre plus tard — voir "Mettre en pause gratuitement" ci-dessous.

Formbricks est également disponible sur GKE — consultez le guide GKE si vous avez besoin d'une orchestration basée sur Kubernetes ; ce guide couvre l'option Cloud Run, moins coûteuse.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits (une fois)99 crédits (une fois, 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 Cloud~83,61 US$/mois, facturé à votre propre compte de facturation Google au prix catalogue~67 crédits/jour (~6,70 US$/jour), mesuré à l'heure au prix catalogue plus la marge de RAD

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

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

RessourceUS$/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 2 GiB (scaleToZero)13,16 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$
Total83,61 US$

Comment cela se compare​

  • Le plan payant le moins cher de Formbricks Cloud, Pro, est de 74 US$/mois (3 espaces de travail, 2 000 réponses mensuelles, sièges illimités) — vérifié sur https://formbricks.com/pricing. Cela est inférieur à la facture Google Cloud de RAD d'environ 83,61 US$/mois pour la variante Cloud Run, rien qu'au prix affiché, mais cela limite l'utilisation ; l'instance de RAD est illimitée, auto-hébergée, et les données ne quittent jamais votre propre projet.
  • Le véritable compromis ici est entre la limite et le contrôle, pas le prix : un plan SaaS géré est moins cher à cette échelle, et le coût d'exécution de RAD est ce que coûtent réellement Cloud SQL, le calcul et le réseau au prix catalogue de Google, sans rien de caché dans un prix de siège groupé.
  • RAD ne prétend pas être moins cher qu'un VPS nu en termes d'argent — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.

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

Si Formbricks est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression du module Formbricks seul, cela ne supprime pas Cloud SQL, aucune VM ou 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 invoqué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 Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit. Les frais de module de 99 crédits ne sont pas facturés à nouveau.

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 cela, 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, ce qui convient à la plupart des utilisations d'étude/démo). 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, 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é Formbricks 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​

Si Formbricks se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.

Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 110 crédits (11,00 US$) dans votre propre projet, ou 99 crédits sur un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Formbricks resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution : environ 5 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 83,61 US$/mois), ou environ 4 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~67 crédits/jour).

La majeure partie du coût d'exécution de Formbricks est la base de données et 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 alors que quelque chose d'autre partage le projet n'économise que la part de calcul de cette application sur le total ci-dessus.

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, 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 propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les mécanismes de pause/restauration ; tarification de Formbricks Cloud pour les chiffres de Formbricks Cloud.

1. Vue d'ensemble du module​

Formbricks est une plateforme open source de gestion d'enquêtes et d'expériences. Elle permet aux équipes de créer des enquêtes produit, des enquêtes NPS, des flux d'intégration et des widgets de feedback in-app à partir d'une seule plateforme. Basée sur Next.js avec Prisma ORM, elle nécessite PostgreSQL, Redis en option et un stockage d'objets compatible S3. Formbricks CloudRun est un module enveloppe construit sur App CloudRun. Il utilise App CloudRun pour toutes les provisions d'infrastructure GCP et injecte la configuration d'application spécifique à Formbricks, les secrets, l'initialisation de la base de données et le stockage compatible S3 basé sur GCS via Formbricks Common.

Capacités clés :

  • Calcul : Cloud Run v2 (Gen2), conteneur Next.js sur le port 3000, 1 vCPU / 2 Gi par défaut (2 vCPU / 2 Gi recommandés pour la production). Mise à l'échelle à zéro (min_instance_count = 0) avec max_instance_count = 1.
  • Persistance des données : Cloud SQL PostgreSQL 15. NFS (VM GCE ou Filestore) activé par défaut. Un bucket GCS uploads est automatiquement provisionné par Formbricks Common pour le stockage de fichiers compatible S3 via les identifiants HMAC GCS.
  • Sécurité : Hérite de Cloud Armor WAF, IAP, Binary Authorization et VPC Service Controls de App CloudRun. Plusieurs secrets d'application auto-générés (clé NextAuth, clé de chiffrement, jeton cron, clés HMAC) sont provisionnés dans Secret Manager par Formbricks Common.
  • Mise en cache : Redis activé par défaut (enable_redis = true) — Formbricks utilise Redis pour la mise en cache et les files d'attente de tâches en arrière-plan.
  • CI/CD : Pipeline d'images personnalisées Cloud Build par défaut ; livraison progressive Cloud Deploy en option.
  • Sondes de santé : La sonde de démarrage est TCP sur le port du conteneur par conception, pas HTTP /api/v2/health — ce point de terminaison ne renvoie 2xx qu'une fois que Formbricks signale une disponibilité COMPLÈTE (DB + Redis + dépendances), donc une sonde de démarrage HTTP ne passe jamais même si Next.js écoute déjà ("Ready" dans les logs, mais le service n'est jamais créé). La sonde de vivacité est désactivée par défaut pour la même raison : la vivacité de Cloud Run ne peut pas utiliser une socket TCP, et le point de terminaison HTTP /api/v2/health redémarrerait en boucle un conteneur sain avant qu'il n'atteigne une disponibilité complète. La sonde de démarrage TCP seule gère le routage.

Identité du projet et de l'application

VariableGroupeTypeValeur par défautDescription
project_id1string—ID du projet GCP. Obligatoire.
tenant_id2string'demo'Suffixe court ajouté à tous les noms de ressources.
support_users2list(string)[]Destinataires des e-mails pour les alertes de surveillance.
resource_labels2map(string){}Libellés appliqués à toutes les ressources provisionnées.
application_name3string'formbricks'Nom de ressource de base. Ne pas modifier après le déploiement initial.
display_name3string'Formbricks Surveys'Nom lisible par l'utilisateur affiché dans la console GCP.
description3string'Formbricks - Open Source Survey and Experience Management'Description du service Cloud Run.
application_version3string'latest'Tag de version de l'image Formbricks. Incrémenter pour déployer une nouvelle version.
webapp_url3string""URL publique de l'instance Formbricks. Définir après le premier déploiement.

Architecture de l'enveloppe : Formbricks CloudRun appelle Formbricks Common pour construire un objet application_config contenant des variables d'environnement spécifiques à Formbricks, des secrets auto-générés, le câblage de stockage S3/GCS, la configuration des sondes et la définition du job db-init. module_storage_buckets contient le bucket uploads provisionné par Formbricks Common. scripts_dir est résolu au répertoire Formbricks_Common/scripts au moment de l'apply.

Note sur l'URL de l'application web : Lorsque webapp_url est laissé vide, main.tf calcule une URL de service Cloud Run déterministe (https://<service>-<project-number>.<region>.run.app) et la transmet à Formbricks Common comme WEBAPP_URL/NEXTAUTH_URL — Formbricks ne revient jamais réellement à la valeur par défaut localhost:3000 de l'image sur Cloud Run (Cloud Run n'interpole pas les références $(VAR), donc l'URL est calculée comme une chaîne de caractères simple). Définissez webapp_url explicitement uniquement pour pointer les rappels OAuth et les liens e-mail vers un domaine personnalisé au lieu de l'URL run.app prédite.


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

Formbricks_CloudRun délègue toutes les provisions IAM à App_CloudRun. Le compte de service Cloud Run, le compte de service Cloud Build, l'agent de service IAP et les ensembles de rôles de rotation de mot de passe sont identiques à ceux du module App_CloudRun.

Secrets d'application auto-générés : Contrairement à Ghost, Formbricks Common auto-génère plusieurs secrets au niveau de l'application et les stocke dans Secret Manager. Ceux-ci sont créés une fois et restent stables entre les déploiements :

SecretVariable d'environnementNotes
NEXTAUTH_SECRETNEXTAUTH_SECRETClé de chiffrement de session NextAuth.js (aléatoire de 32 caractères).
ENCRYPTION_KEYENCRYPTION_KEYClé de chiffrement des données Formbricks.
CRON_SECRETCRON_SECRETJeton d'authentification des jobs cron.
HUB_API_KEYHUB_API_KEYClé API Formbricks Hub.
CUBEJS_API_SECRETCUBEJS_API_SECRETSecret d'analyse Cube.js.
S3_ACCESS_KEYS3_ACCESS_KEYClé d'accès HMAC GCS pour les téléchargements compatibles S3.
S3_SECRET_KEYS3_SECRET_KEYClé secrète HMAC GCS pour les téléchargements compatibles S3.
SMTP_PASSWORDSMTP_PASSWORDCréé uniquement lorsque smtp_host est configuré.
REDIS_URLREDIS_URLCréé uniquement lorsque Redis est activé avec l'authentification.

Les secrets DB_PASSWORD et ROOT_PASSWORD sont provisionnés automatiquement par App CloudRun et consommés par le job db-init.

Accès à Secret Manager : Le compte de service Cloud Run se voit accorder roles/secretmanager.secretAccessor sur tous les secrets provisionnés. Les valeurs en texte clair ne sont jamais écrites dans l'état du déploiement.


3. Configuration du service principal​

A. Calcul (Cloud Run)​

Formbricks est une application Next.js qui effectue des migrations de base de données Prisma au démarrage. Formbricks CloudRun expose cpu_limit et memory_limit comme variables de niveau supérieur avec des valeurs par défaut judicieuses.

La mise à l'échelle à zéro est activée (min_instance_count = 0 par défaut). Les démarrages à froid de Formbricks prennent généralement 15 à 20 secondes, car Next.js compile et Prisma valide sa connexion à la base de données. Pour les enquêtes de production avec des exigences de SLA, définissez min_instance_count = 1 pour éliminer les démarrages à froid.

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

Image du conteneur : container_image_source par défaut à 'custom', ce qui signifie que Cloud Build construit une image personnalisée à l'aide du Dockerfile de Formbricks_Common (en enveloppant ghcr.io/formbricks/formbricks). Définissez container_image_source = 'prebuilt' et container_image = 'ghcr.io/formbricks/formbricks:latest' pour ignorer la construction et déployer directement en amont.

VariableGroupeValeur par défautDescription
deploy_application4trueDéfinissez false pour un déploiement uniquement d'infrastructure (SQL, stockage, secrets).
container_image_source4'custom''custom' construit via Cloud Build. 'prebuilt' déploie un URI d'image existant.
container_image4""Remplace l'URI de l'image. Laissez vide pour que Cloud Build gère l'image.
cpu_limit4'1000m'CPU par instance. 1 vCPU minimum ; '2000m' recommandé pour la production.
memory_limit4'2Gi'Mémoire par instance. 2 Gi par défaut ; ne pas définir en dessous de 512 Mi.
container_port43000Port HTTP natif de Formbricks. Ne pas modifier.
execution_environment4'gen2'Gen2 requis pour les montages NFS et GCS Fuse.
timeout_seconds4300Durée maximale de la requête. Augmenter pour les téléchargements de fichiers volumineux.
enable_cloudsql_volume4trueMonte le volume de socket Unix du proxy d'authentification Cloud SQL. Par défaut à true : une connexion TCP IP directe force sslmode=require, et le client pg de Formbricks/Prisma vérifie le certificat Cloud SQL IP privée, ce qui échoue contre son CA non fiable (chaque requête renvoie 500). Le socket évite cela — le proxy effectue le mTLS et l'application se connecte avec sslmode=disable.
traffic_split4[]Allocation de trafic canary/blue-green basée sur un pourcentage.
service_annotations4{}Annotations Cloud Run avancées.
service_labels4{}Libellés appliqués au service Cloud Run.
min_instance_count40Instances minimales en cours d'exécution. Définir à 1 pour éliminer les démarrages à froid.
max_instance_count41Instances concurrentes maximales. Augmenter pour les déploiements à trafic plus élevé.
cpu_always_allocated4falseFacturation basée sur les requêtes par défaut : Formbricks sert les enquêtes/tableaux de bord sur demande, et son pipeline de réponse (e-mails de notification, webhooks, intégrations) ne s'exécute qu'après une réponse à l'enquête. Définissez true si vous exécutez des enquêtes en direct qui nécessitent des notifications/webhooks en temps réel livrés sans attendre la prochaine requête pour réveiller l'instance.

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

VariableApp CloudRunFormbricks CloudRunRaison
container_port80803000Le serveur Next.js de Formbricks se lie au port 3000.
cpu_limit'1000m''1000m'Même valeur par défaut — passer à '2000m' pour la production.
memory_limit'512Mi''2Gi'Next.js + Prisma + rendu d'enquête nécessitent beaucoup plus de RAM.
enable_image_mirroringfalsetrueFormbricks met en miroir vers Artifact Registry pour éviter les limites de débit de ghcr.io.

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

Formbricks nécessite PostgreSQL. Formbricks Common fixe database_type = "POSTGRES_15". Le module utilise db_name et db_user comme variables abrégées spécifiques à Formbricks.

Connexion par socket Unix : enable_cloudsql_volume par défaut à true. Formbricks se connecte à Cloud SQL PostgreSQL via le socket Unix du proxy d'authentification Cloud SQL (monté à cloudsql_volume_mount_path, par défaut /cloudsql), injecté comme DB_HOST. Cela évite un échec de vérification de certificat qui se produit lorsque le client pg de Formbricks/Prisma se connecte directement via TCP IP privée avec sslmode=require contre l'autorité de certification non fiable de Cloud SQL. Définissez enable_cloudsql_volume = false uniquement pour une connexion TCP IP directe dont vous savez qu'elle présente un certificat vérifiable.

VariableGroupeValeur par défautDescription
db_name12'formbricks'Nom de la base de données PostgreSQL. Ne pas modifier après le déploiement initial.
db_user12'formbricks'Utilisateur de l'application PostgreSQL. Mot de passe auto-généré dans Secret Manager.
database_password_length1232Longueur du mot de passe auto-généré. Plage : 16–64.
enable_auto_password_rotation12falseRotation automatisée du mot de passe sans interruption.
rotation_propagation_delay_sec1290Secondes à attendre après la rotation avant de redémarrer le service.
sql_instance_name12""Nom d'une instance Cloud SQL existante. Laissez vide pour la découverte automatique.
sql_instance_base_name12'app-sql'Nom de base pour une instance Cloud SQL intégrée. L'ID de déploiement est ajouté.

database_type est fixé à "POSTGRES_15" par Formbricks Common et n'est pas modifiable par l'utilisateur via la variable standard database_type. Formbricks nécessite PostgreSQL et ne démarrera pas avec MySQL ou SQL Server.

C. Stockage (NFS et GCS)​

NFS est activé par défaut (enable_nfs = true). Formbricks stocke les fichiers partagés sur le volume NFS lorsque plusieurs instances sont actives. Nécessite execution_environment = 'gen2'.

Bucket de téléchargement GCS : Formbricks Common provisionne automatiquement un bucket GCS uploads dédié et configure Formbricks pour utiliser l'API XML compatible S3 de GCS via des identifiants HMAC. Le nom du bucket est injecté comme S3_BUCKET_NAME, et S3_ENDPOINT_URL=https://storage.googleapis.com achemine le client S3 de Formbricks vers GCS. Ce bucket est distinct de tous les buckets listés dans storage_buckets.

Injection de clé HMAC : S3_ACCESS_KEY et S3_SECRET_KEY sont des identifiants HMAC GCS auto-générés stockés dans Secret Manager et injectés comme variables d'environnement secrètes au moment de l'exécution.

VariableGroupeValeur par défautDescription
enable_nfs11trueProvisionne un volume NFS pour le stockage de fichiers partagés. Nécessite gen2.
nfs_mount_path11'/mnt/nfs'Chemin du conteneur où le partage NFS est monté.
create_cloud_storage11trueDéfinissez false pour ignorer la création de buckets supplémentaires. Le bucket uploads est toujours provisionné.
storage_buckets11[{ name_suffix = "data" }]Buckets GCS supplémentaires au-delà du bucket de téléchargement auto-provisionné.
gcs_volumes11[]Buckets GCS à monter via GCS Fuse (nécessite gen2).
nfs_instance_name9""Nom d'une VM GCE NFS existante. Laissez vide pour la découverte automatique.
nfs_instance_base_name9'app-nfs'Nom de base pour une VM GCE NFS intégrée. L'ID de déploiement est ajouté.
manage_storage_kms_iam11falseCrée un trousseau de clés KMS CMEK et active CMEK sur tous les buckets de stockage.
enable_artifact_registry_cmek11falseCrée une clé KMS Artifact Registry pour le chiffrement des images au repos.

D. Réseau​

Cloud Run utilise Direct VPC Egress pour atteindre Cloud SQL. Comme enable_cloudsql_volume = true est la valeur par défaut, Formbricks se connecte à PostgreSQL via le socket Unix du proxy d'authentification Cloud SQL plutôt que par une connexion TCP directe à l'IP privée.

VariableGroupeValeur par défautDescription
ingress_settings5'all''all' — internet public ; 'internal' — VPC uniquement ; 'internal-and-cloud-load-balancing' — force le trafic via le LB HTTPS.
vpc_egress_setting5'PRIVATE_RANGES_ONLY''PRIVATE_RANGES_ONLY' achemine uniquement le trafic RFC 1918 via VPC.

E. Initialisation et amorçage​

Un job Cloud Run db-init est automatiquement provisionné par Formbricks Common lorsque initialization_jobs est laissé comme liste vide par défaut. Il utilise une image compatible PostgreSQL et exécute Formbricks_Common/scripts/db-init.sh, qui effectue une création de base de données et d'utilisateur idempotente avant le démarrage du service Formbricks.

Les migrations Prisma sont gérées par Formbricks lui-même au démarrage du conteneur (PRISMA_MIGRATE=false est défini pour désactiver la migration forcée, car Formbricks exécute sa propre logique de migration Prisma au démarrage).

VariableGroupeValeur par défautDescription
initialization_jobs13[]Jobs Cloud Run à exécution unique. Laissez vide pour que Formbricks Common fournisse le job db-init par défaut.
cron_jobs13[]Jobs récurrents déclenchés par Cloud Scheduler.

4. Sécurité avancée​

A. Cloud Armor WAF​

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

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

B. Proxy conscient de l'identité (IAP)​

Lorsque enable_iap = true, l'intégration IAP native de Cloud Run est activée directement sur le service. L'authentification par identité Google est requise avant que les requêtes n'atteignent Formbricks. Utile pour les déploiements internes ou les environnements d'enquête de pré-production.

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

C. Autorisation binaire​

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

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

D. Contrôles de service VPC​

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

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

E. Intégration de Secret Manager​

Les secrets d'application Formbricks sont stockés dans Secret Manager et injectés nativement par Cloud Run au démarrage de la révision — le texte en clair n'est jamais écrit dans l'état.

Formbricks Common génère automatiquement tous les secrets d'application requis. Les secrets définis par l'utilisateur peuvent être ajoutés via secret_environment_variables pour les mots de passe SMTP et d'autres valeurs sensibles personnalisées.

VariableGroupeValeur par défautDescription
secret_environment_variables6{}Mappage du nom de la variable d'environnement → ID du secret Secret Manager. Résolu au moment de l'exécution.
secret_rotation_period6'2592000s'Fréquence à laquelle Secret Manager émet des notifications de rotation. Par défaut : 30 jours.
secret_propagation_delay630Secondes à attendre après la création du secret avant que les ressources dépendantes ne continuent.

5. Trafic et entrée​

A. Équilibreur de charge HTTPS​

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

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

B. Cloud CDN​

Lorsque enable_cdn = true (nécessite enable_cloud_armor = true), Cloud CDN est attaché au backend de l'équilibreur de charge HTTPS. Formbricks sert un mélange de pages rendues côté serveur Next.js et d'actifs statiques. Le CDN est bien adapté aux actifs statiques (bundles JS, CSS, images d'enquête téléchargées), mais les soumissions d'enquête et les points de terminaison d'API ne doivent pas être mis en cache.

VariableGroupeValeur par défautDescription
enable_cdn10falseActive Cloud CDN sur le backend du LB HTTPS. N'est efficace que lorsque enable_cloud_armor = true.
max_images_to_retain107Nombre maximal d'images de conteneurs récentes à conserver dans Artifact Registry.
delete_untagged_images10trueSupprime automatiquement les images non taguées (pendantes) d'Artifact Registry.
image_retention_days1030Jours après lesquels les images sont éligibles à la suppression.

C. Domaines personnalisés​

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

Après avoir défini un domaine personnalisé, mettez à jour webapp_url pour qu'il corresponde — NextAuth.js utilise cette valeur pour les URI de redirection OAuth et les liens e-mail.

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

6. CI/CD et livraison​

A. Déclencheurs Cloud Build​

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

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

B. Pipeline Cloud Deploy​

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

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

7. Fiabilité et planification​

A. Mise à l'échelle et concurrence​

min_instance_count = 0 et max_instance_count = 1 sont les valeurs par défaut. Les démarrages à froid de Formbricks prennent 15 à 20 secondes en raison de l'initialisation de Next.js et de la configuration de la connexion Prisma. Pour les déploiements de production, définissez min_instance_count = 1.

Lorsque Redis est activé (enable_redis = true), plusieurs instances Formbricks peuvent partager l'état du cache, ce qui rend la mise à l'échelle horizontale sûre. Augmentez max_instance_count pour les périodes d'enquête à fort trafic.

B. Répartition du trafic​

La répartition du trafic est prise en charge. Étant donné que Formbricks externalise l'état de session vers PostgreSQL et l'état du cache vers Redis, les déploiements canary sont sûrs — les requêtes sont acheminées de manière cohérente, quelle que soit l'instance qui les traite.

VariableGroupeValeur par défautDescription
traffic_split4[]Allocation de trafic basée sur un pourcentage entre les révisions nommées. Toutes les entrées doivent totaliser 100.

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

Formbricks expose /api/v2/health — un point de terminaison de santé dédié qui renvoie HTTP 200 uniquement une fois que l'application ET ses dépendances de base de données/Redis signalent une disponibilité complète. En raison de cette sémantique de "disponibilité complète", les sondes ne ciblent délibérément pas toutes les deux comme une vérification HTTP :

  • startup_probe par défaut à TCP, pas HTTP /api/v2/health : une sonde HTTP sur ce chemin ne passe jamais avant la disponibilité complète, de sorte que la sonde de démarrage de Cloud Run ne réussirait jamais même si Next.js écoute déjà sur le port du conteneur ("Ready" dans les logs, mais le service ne devient jamais routable). Une sonde TCP réussit dès que l'application lie le port — la bonne porte pour "acheminer le trafic ici".
  • liveness_probe est désactivé par défaut (enabled = false) : les sondes de vivacité de Cloud Run ne peuvent pas utiliser une socket TCP, et le chemin HTTP /api/v2/health redémarrerait en boucle un conteneur par ailleurs sain avant qu'il n'atteigne une disponibilité complète. La sonde de démarrage TCP gère déjà le trafic, donc la vivacité est désactivée.
VariableGroupeValeur par défautDescription
startup_probe14{ enabled=true, type="TCP", path="/api/v2/health", initial_delay_seconds=30, timeout_seconds=5, period_seconds=20, failure_threshold=10 }Sonde de disponibilité au démarrage. TCP par conception — voir l'explication ci-dessus. Le conteneur ne reçoit aucun trafic tant que cela ne réussit pas.
liveness_probe14{ enabled=false, type="HTTP", path="/api/v2/health", initial_delay_seconds=15, timeout_seconds=5, period_seconds=30, failure_threshold=3 }Sonde de vivacité. Désactivée par défaut — voir l'explication ci-dessus. N'activez que si vous comprenez le risque de boucle de redémarrage contre /api/v2/health avant la disponibilité complète.
startup_probe_config14{ enabled=true, type="TCP" }Sonde de démarrage de service de niveau App_CloudRun, indépendante de startup_probe spécifique à Formbricks ci-dessus.
health_check_config14{ enabled=true, type="HTTP", path="/" }Sonde de vivacité de service de niveau App_CloudRun, indépendante de liveness_probe spécifique à Formbricks ci-dessus.
uptime_check_config14{ enabled=false, path="/" }Vérification de disponibilité Cloud Monitoring. Désactivée par défaut ; activez pour la surveillance de production — les alertes notifient support_users si inaccessible.
alert_policies14[]Politiques d'alerte métrique Cloud Monitoring.

D. Rotation automatique des mots de passe​

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

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

8. Intégrations​

A. Cache Redis​

Redis est activé par défaut (enable_redis = true). Formbricks utilise Redis pour mettre en cache les réponses API, limiter le taux de requêtes et gérer les files d'attente des jobs en arrière-plan. Lorsque Redis est activé et que redis_host n'est pas fourni, le module utilise par défaut l'IP du serveur NFS comme hôte Redis (une instance Redis légère colocalisée sur la VM GCE NFS). Pour les déploiements de production, pointez redis_host vers une instance Google Cloud Memorystore for Redis dédiée.

VariableGroupeValeur par défautDescription
enable_redis21trueActive Redis pour la mise en cache et la limitation de taux de Formbricks. Recommandé pour tous les déploiements.
redis_host21""Nom d'hôte ou IP du serveur Redis. Laissez vide pour utiliser l'IP du serveur NFS.
redis_port21'6379'Port TCP du serveur Redis (chaîne).
redis_auth21""Mot de passe d'authentification Redis. Sensible — jamais stocké dans l'état.

B. E-mail (SMTP)​

Formbricks utilise SMTP pour les e-mails transactionnels : invitations d'utilisateurs, notifications de réponses aux sondages et e-mails d'intégration. Les variables SMTP dédiées offrent une interface plus propre que environment_variables :

VariableGroupeValeur par défautDescription
smtp_host5'smtp.gmail.com'Nom d'hôte du serveur SMTP. Définissez sur "" pour désactiver l'e-mail.
smtp_port5587Port SMTP. Utilisez 587 pour STARTTLS (recommandé) ou 465 pour TLS implicite.
smtp_user5""Nom d'utilisateur d'authentification SMTP.
smtp_password5""Mot de passe SMTP. Auto-généré et stocké dans Secret Manager si laissé vide. Sensible.
smtp_secure_enabled5falseActiver TLS implicite. Définissez true lorsque smtp_port = 465.
mail_from5""Adresse de l'expéditeur affichée dans les e-mails Formbricks (par exemple, 'noreply@surveys.example.com').

C. Formbricks Hub & Cube.js​

À partir de Formbricks v5, la plateforme se connecte à un service Formbricks Hub pour la gestion des licences et l'analyse, et à un sidecar Cube.js pour les requêtes d'analyse.

VariableGroupeValeur par défautDescription
hub_api_url21'http://localhost:8080'URL de l'API Formbricks Hub. À remplacer lors de l'exécution de Hub en tant que service Cloud Run séparé.
cubejs_api_url21'http://localhost:4000'URL de l'API d'analyse Cube.js. À remplacer pour un déploiement Cube.js séparé.

D. Importation et récupération de sauvegarde​

Lorsque enable_backup_import = true, un job Cloud Run dédié restaure une sauvegarde de base de données existante dans l'instance Cloud SQL PostgreSQL provisionnée pendant l'apply.

VariableGroupeValeur par défautDescription
backup_schedule7'0 2 * * *'Expression Cron (UTC) pour les sauvegardes quotidiennes automatisées.
backup_retention_days77Jours de rétention des fichiers de sauvegarde dans GCS.
enable_backup_import7falseDéclenche une restauration unique lors de l'apply. Définissez false après une importation réussie.
backup_source7'gcs''gcs' (URI GCS complet) ou 'gdrive' (ID de fichier Drive).
backup_uri7""URI GCS complet (par exemple, 'gs://my-bucket/formbricks-2024.sql') ou ID de fichier Google Drive.
backup_format7'sql'Format du fichier de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip.

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

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

ComportementImplémentationDétail
PostgreSQL 15 requisdatabase_type = "POSTGRES_15" corrigé par Formbricks CommonFormbricks nécessite PostgreSQL. MySQL et SQL Server ne sont pas pris en charge.
Stockage compatible S3 via GCSSTORAGE_PROVIDER=s3, S3_ENDPOINT_URL=https://storage.googleapis.com injectés automatiquementLe client de téléchargement de fichiers S3 de Formbricks est pointé vers GCS via l'API XML. Les identifiants HMAC dans Secret Manager authentifient la connexion.
Bucket de téléchargement GCSBucket uploads provisionné par Formbricks Common via module_storage_bucketsUn bucket GCS dédié aux téléchargements de fichiers Formbricks est provisionné séparément de storage_buckets.
Secrets auto-générésNEXTAUTH_SECRET, ENCRYPTION_KEY, CRON_SECRET, HUB_API_KEY, CUBEJS_API_SECRET, S3_ACCESS_KEY, S3_SECRET_KEYTous les secrets au niveau de l'application sont créés une seule fois par Formbricks Common et restent stables.
NFS activé par défautenable_nfs = true par défautLe stockage NFS partagé est provisionné. Nécessite execution_environment = 'gen2'.
Redis activé par défautenable_redis = true par défautLa mise en cache Redis est activée par défaut. Lorsque redis_host est vide, l'IP du serveur NFS est utilisée.
Mise en miroir des imagesenable_image_mirroring = true par défautLes images Formbricks sont mises en miroir de ghcr.io vers Artifact Registry pour éviter les limites de taux.
Connexion à la base de données via socket Unixenable_cloudsql_volume = true par défautFormbricks se connecte à PostgreSQL via le socket Unix du proxy d'authentification Cloud SQL plutôt que par TCP direct, évitant ainsi un échec de vérification de certificat Prisma contre l'autorité de certification non fiable de Cloud SQL.
Sonde de démarrage TCPstartup_probe.type = "TCP" par défautLe propre endpoint /api/v2/health de Formbricks ne renvoie 2xx qu'à pleine disponibilité (DB + Redis + dépendances), donc une sonde HTTP contre celui-ci ne passe jamais ; TCP réussit dès que l'application lie le port.
Sonde de vivacité désactivéeliveness_probe.enabled = false par défautLa vivacité de Cloud Run ne peut pas utiliser TCP, et HTTP /api/v2/health relancerait en boucle un conteneur sain mais pas entièrement prêt. La sonde de démarrage TCP gère déjà le routage.
Répertoire des scriptsscripts_dir = abspath("${module.formbricks_app.path}/scripts")Les scripts d'initialisation proviennent de Formbricks Common.

10. Exploration avec la console GCP​

Après le déploiement, utilisez la console GCP pour observer et exploiter le déploiement Formbricks.

Service Cloud Run :

  • Accédez à Cloud Run dans la console et sélectionnez votre service Formbricks (nommé appformbricks<tenant><id>).
  • L'onglet Révisions affiche chaque révision déployée avec son allocation de trafic, son nombre d'instances et son horodatage de création.
  • L'onglet Métriques affiche le nombre de requêtes, les latences des requêtes, le nombre d'instances de conteneur et la latence de démarrage — utile pour évaluer les paramètres min_instance_count.
  • L'onglet Journaux diffuse directement les journaux du conteneur. Recherchez la sortie de migration Prisma et les messages de démarrage de NextAuth.js au premier démarrage.
  • L'onglet YAML révèle la spécification complète du service Cloud Run, y compris toutes les variables d'environnement injectées (les références de secrets apparaissent comme des noms de secrets, pas des valeurs).

Secret Manager :

  • Accédez à Sécurité → Secret Manager et filtrez par le préfixe de déploiement (par exemple, formbricks-demo).
  • Les secrets auto-générés — NEXTAUTH_SECRET, ENCRYPTION_KEY, CRON_SECRET, HUB_API_KEY, CUBEJS_API_SECRET, S3_ACCESS_KEY, S3_SECRET_KEY — seront tous présents.
  • L'onglet Versions de chaque secret indique quand il a été créé. Un secret avec une seule version et aucune activité de rotation est dans son état initial.
  • Cliquez sur un nom de secret pour voir quels services Cloud Run le référencent (sous Utilisation).

Cloud SQL :

  • Accédez à SQL et sélectionnez l'instance PostgreSQL utilisée par Formbricks.
  • L'onglet Connexions affiche les connexions de base de données actives depuis le compte de service Cloud Run.
  • L'onglet Bases de données confirme l'existence de la base de données formbricks.
  • L'onglet Utilisateurs confirme que l'utilisateur formbricks a été créé par le job db-init.
  • L'onglet Opérations enregistre toutes les actions administratives, y compris la création d'utilisateurs et les changements de mot de passe.

Cloud Storage :

  • Accédez à Cloud Storage → Buckets et recherchez le bucket uploads (nommé avec l'application et le préfixe de déploiement).
  • Les pièces jointes de fichiers de réponses aux sondages téléchargées par les utilisateurs apparaissent comme des objets sous le bucket.
  • L'onglet Autorisations confirme que le compte de service HMAC a roles/storage.objectAdmin sur le bucket.
  • L'onglet Configuration affiche l'état CMEK si manage_storage_kms_iam = true.

Cloud Build :

  • Accédez à Cloud Build → Historique pour voir l'historique de build de l'image Formbricks.
  • Chaque build correspond à un déploiement ou à une incrémentation de version.
  • Cliquez sur n'importe quel build pour voir les étapes du Dockerfile, les arguments de build et la cible de push dans Artifact Registry.

Artifact Registry :

  • Accédez à Artifact Registry et trouvez le dépôt pour le déploiement Formbricks.
  • Les images sont taguées avec la valeur application_version.
  • L'onglet Vulnérabilités (si l'analyse est activée) affiche les CVE détectées dans l'image Formbricks.

Cloud Monitoring :

  • Accédez à Monitoring → Tests de disponibilité pour voir le test de disponibilité créé par le module (lorsque uptime_check_config.enabled = true).
  • Accédez à Monitoring → Alertes pour voir toutes les alert_policies configurées.
  • Dans Explorateur de métriques, interrogez run.googleapis.com/request_latencies filtré sur le nom de votre service pour suivre les temps de réponse p50/p95/p99.

11. Exploration avec gcloud​

Les commandes suivantes sont utiles pour les opérations quotidiennes d'un déploiement Formbricks Cloud Run. Remplacez PROJECT_ID, REGION et DEPLOYMENT_ID par vos valeurs.

Décrire le service Cloud Run et récupérer l'URL :

gcloud run services describe appformbricks<DEPLOYMENT_ID> \
--region=REGION \
--project=PROJECT_ID \
--format="yaml(status.url, spec.template.spec.containers[0].resources)"

Lister toutes les révisions Cloud Run et leurs répartitions de trafic :

gcloud run revisions list \
--service=appformbricks<DEPLOYMENT_ID> \
--region=REGION \
--project=PROJECT_ID \
--format="table(metadata.name, status.conditions[0].status, spec.containerConcurrency, metadata.creationTimestamp)"

Afficher les journaux de conteneurs Cloud Run en direct :

gcloud logging read \
'resource.type="cloud_run_revision" AND resource.labels.service_name="appformbricks<DEPLOYMENT_ID>"' \
--project=PROJECT_ID \
--freshness=10m \
--format="table(timestamp, textPayload)" \
--order=asc

Lister tous les secrets Formbricks dans Secret Manager :

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

Afficher la dernière version d'un secret spécifique (métadonnées uniquement — pas la valeur) :

gcloud secrets versions describe latest \
--secret=formbricks-nextauth-secret \
--project=PROJECT_ID

Lister les jobs Cloud Run (inclut db-init) :

gcloud run jobs list \
--region=REGION \
--project=PROJECT_ID \
--filter="metadata.name~formbricks"

Exécuter le job db-init manuellement (par exemple, après un changement de schéma) :

gcloud run jobs execute formbricks-db-init-<DEPLOYMENT_ID> \
--region=REGION \
--project=PROJECT_ID \
--wait

Vérifier l'instance et la base de données Cloud SQL :

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

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

Lister les buckets GCS pour le déploiement Formbricks :

gcloud storage buckets list \
--project=PROJECT_ID \
--filter="name~formbricks" \
--format="table(name, location, storageClass)"

Afficher l'historique de Cloud Build pour les builds d'images :

gcloud builds list \
--project=PROJECT_ID \
--filter="substitutions.REPO_NAME~formbricks" \
--limit=10 \
--format="table(id, status, createTime, duration)"

Lister les images Artifact Registry :

gcloud artifacts docker images list \
REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME \
--filter="package~formbricks" \
--format="table(package, tags, updateTime)"

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

gcloud monitoring uptime list-configs \
--project=PROJECT_ID \
--filter="displayName~formbricks"

12. Référence des variables​

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

VariableGroupeValeur par défautDescription
project_id1—ID du projet GCP. Obligatoire.
region1'us-central1'Région GCP pour le déploiement des ressources.
tenant_id2'demo'Court suffixe ajouté à tous les noms de ressources.
support_users2[]Adresses e-mail pour les alertes de surveillance.
resource_labels2{}Libellés appliqués à toutes les ressources provisionnées.
application_name3'formbricks'Nom de ressource de base. Ne pas modifier après le déploiement initial.
display_name3'Formbricks Surveys'Nom lisible par l'homme affiché dans la console GCP.
description3'Formbricks - Open Source Survey and Experience Management'Description du service.
application_version3'latest'Tag de l'image du conteneur. Incrémenter pour déployer une nouvelle version.
webapp_url3""URL publique de l'instance Formbricks. À définir après le premier déploiement.
deploy_application4trueDéfinissez false pour un déploiement d'infrastructure uniquement.
container_image_source4'custom''custom' (Cloud Build) ou 'prebuilt' (image existante).
container_image4""URI de l'image du conteneur. Laissez vide pour que Cloud Build le gère.
container_build_config4{ enabled = true }Configuration Cloud Build : chemin Dockerfile, contexte, arguments de build.
cpu_limit4'1000m'CPU par instance. Mettre à niveau vers '2000m' pour la production.
memory_limit4'2Gi'Mémoire par instance. Formbricks (Next.js 16) nécessite un minimum de 2 Gio — 512 Mio provoque des plantages OOM au démarrage.
container_port43000Port natif de Formbricks. Ne pas modifier.
execution_environment4'gen2'Gen2 requis pour les montages NFS.
timeout_seconds4300Durée maximale de la requête.
enable_cloudsql_volume4trueMonter le socket du proxy d'authentification Cloud SQL. Valeur par défaut true — évite un échec de vérification de certificat sur TCP direct.
cloudsql_volume_mount_path4'/cloudsql'Chemin du conteneur pour le socket du proxy d'authentification lorsque enable_cloudsql_volume = true.
container_protocol4'http1''http1' ou 'h2c'.
enable_image_mirroring4trueMet en miroir l'image Formbricks dans Artifact Registry.
traffic_split4[]Allocation de trafic Canary/blue-green.
min_instance_count40Nombre minimum d'instances en cours d'exécution. Définir sur 1 pour la production.
max_instance_count41Nombre maximal d'instances concurrentes. Augmenter pour un trafic plus élevé.
cpu_always_allocated4falseFacturation basée sur les requêtes par défaut (Formbricks sert les sondages/tableaux de bord sur demande ; le pipeline de réponse — e-mails de notification, webhooks, intégrations — ne s'exécute qu'après une réponse au sondage). Définissez true pour les sondages en direct nécessitant des notifications/webhooks en temps réel sans attendre la prochaine requête.
max_revisions_to_retain47Nombre maximal de révisions Cloud Run à conserver.
service_annotations4{}Annotations Cloud Run avancées.
service_labels4{}Libellés appliqués au service Cloud Run.
ingress_settings5'all''all', 'internal' ou 'internal-and-cloud-load-balancing'.
vpc_egress_setting5'PRIVATE_RANGES_ONLY''PRIVATE_RANGES_ONLY' ou 'ALL_TRAFFIC'.
enable_iap5falseActive IAP nativement sur le service Cloud Run.
iap_authorized_users5[]Utilisateurs/comptes de service ayant accès à IAP.
iap_authorized_groups5[]Groupes Google ayant accès à IAP.
smtp_host5'smtp.gmail.com'Nom d'hôte du serveur SMTP. Définissez sur "" pour désactiver l'e-mail.
smtp_port5587Port SMTP (587 pour STARTTLS, 465 pour TLS implicite).
smtp_user5""Nom d'utilisateur d'authentification SMTP.
smtp_password5""Mot de passe SMTP. Auto-généré dans Secret Manager si vide. Sensible.
smtp_secure_enabled5falseActiver TLS implicite (true pour le port 465).
mail_from5""Adresse de l'expéditeur dans les e-mails Formbricks.
environment_variables6Valeurs par défaut SMTPVariables d'environnement en texte brut. Valeurs par défaut SMTP pré-remplies.
secret_environment_variables6{}Références Secret Manager pour des valeurs sensibles supplémentaires.
secret_propagation_delay630Secondes à attendre après la création du secret.
secret_rotation_period6'2592000s'Fréquence de notification de rotation de Secret Manager.
backup_schedule7'0 2 * * *'Expression Cron (UTC) pour les sauvegardes automatisées.
backup_retention_days77Jours de rétention des fichiers de sauvegarde dans GCS.
enable_backup_import7falseDéclenche une restauration unique lors de l'apply.
backup_source7'gcs''gcs' (URI complet) ou 'gdrive' (ID de fichier).
backup_uri7""URI GCS complet ou ID de fichier Google Drive.
backup_format7'sql'Format de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip.
enable_cicd_trigger8falseProvisionne un déclencheur GitHub Cloud Build.
github_repository_url8""URL HTTPS complète du dépôt GitHub.
github_token8""PAT GitHub. Requis lors du premier apply. Sensible.
github_app_installation_id8""ID d'installation de l'application GitHub.
cicd_trigger_config8{ branch_pattern = "^main$" }Configuration avancée du déclencheur Cloud Build.
enable_cloud_deploy8falseProvisionne un pipeline de livraison progressive Cloud Deploy.
cloud_deploy_stages8[dev, staging, prod(approval)]Étapes de promotion Cloud Deploy ordonnées.
enable_binary_authorization8falseApplique l'attestation d'image lors du déploiement.
enable_custom_sql_scripts9falseExécute des scripts SQL depuis GCS après le provisionnement.
custom_sql_scripts_bucket9""Bucket GCS contenant les scripts SQL.
custom_sql_scripts_path9""Préfixe de chemin dans le bucket.
custom_sql_scripts_use_root9falseExécuter les scripts en tant qu'utilisateur root de la base de données.
nfs_instance_name9""Nom d'une VM GCE NFS existante. Laissez vide pour la découverte automatique.
nfs_instance_base_name9'app-nfs'Nom de base pour la VM NFS intégrée.
enable_cloud_armor10falseProvisionne un équilibreur de charge HTTPS global + Cloud Armor WAF.
admin_ip_ranges10[]Plages CIDR exemptées des règles WAF.
application_domains10[]Domaines personnalisés avec certificats SSL gérés par Google.
enable_cdn10falseActive Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain107Nombre maximal d'images de conteneurs à conserver dans Artifact Registry.
delete_untagged_images10trueSupprime automatiquement les images non taguées.
image_retention_days1030Jours après lesquels les images sont éligibles à la suppression.
create_cloud_storage11trueDéfinissez false pour ignorer la création du bucket GCS.
storage_buckets11[{ name_suffix = "data" }]Buckets GCS supplémentaires à provisionner.
enable_nfs11trueProvisionne le stockage partagé NFS. Nécessite gen2.
nfs_mount_path11'/mnt/nfs'Chemin du conteneur où NFS est monté.
gcs_volumes11[]Buckets GCS à monter via GCS Fuse.
manage_storage_kms_iam11falseCrée une clé KMS CMEK et active CMEK sur les buckets de stockage.
enable_artifact_registry_cmek11falseCrée une clé KMS Artifact Registry pour le chiffrement des images au repos.
db_name12'formbricks'Nom de la base de données PostgreSQL. Ne pas modifier après le déploiement initial.
db_user12'formbricks'Utilisateur de l'application PostgreSQL.
database_type12'POSTGRES_15'Moteur de base de données. Ne pas modifier — Formbricks nécessite PostgreSQL.
database_password_length1232Longueur du mot de passe auto-généré. Plage : 16–64.
enable_auto_password_rotation12falseRotation automatisée du mot de passe sans interruption de service.
rotation_propagation_delay_sec1290Secondes à attendre après la rotation avant de redémarrer le service.
initialization_jobs13[]Jobs Cloud Run ponctuels. Laissez vide pour que Formbricks Common fournisse le job db-init par défaut.
cron_jobs13[]Jobs Cloud Run planifiés récurrents.
startup_probe14{ path="/api/v2/health", initial_delay_seconds=30, failure_threshold=10 }Sonde de démarrage ciblant le point de terminaison de santé de Formbricks.
liveness_probe14{ path="/api/v2/health", initial_delay_seconds=15, failure_threshold=3 }Sonde de vivacité.
startup_probe_config14{ enabled=true, type="TCP" }Sonde de démarrage du service au niveau App_CloudRun.
health_check_config14{ enabled=true, type="HTTP", path="/" }Sonde de vivacité du service au niveau App_CloudRun.
uptime_check_config14{ enabled=true, path="/" }Test de disponibilité Cloud Monitoring.
alert_policies14[]Politiques d'alerte métrique Cloud Monitoring.
enable_redis21trueRedis pour la mise en cache et la limitation de taux de Formbricks.
redis_host21""Nom d'hôte/IP Redis. Par défaut, l'IP du serveur NFS si vide.
redis_port21'6379'Port TCP Redis (chaîne).
redis_auth21""Mot de passe d'authentification Redis. Sensible.
hub_api_url21'http://localhost:8080'URL de l'API Formbricks Hub (v5+).
cubejs_api_url21'http://localhost:4000'URL de l'API d'analyse Cube.js (v5+).
enable_vpc_sc22falseEnregistre les appels API dans le périmètre VPC-SC du projet.
vpc_cidr_ranges22[]Plages CIDR du sous-réseau VPC pour le niveau d'accès réseau VPC-SC.
vpc_sc_dry_run22trueEnregistre les violations VPC-SC sans bloquer. Définissez false pour appliquer.
organization_id22""ID de l'organisation GCP pour VPC-SC. Découvert automatiquement si vide.
enable_audit_logging22falseActive les journaux d'audit Cloud détaillés.

13. Sorties​

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL publique du service Cloud Run.
service_locationRégion GCP où le service Cloud Run est déployé.
project_idID du projet GCP.
deployment_idSuffixe d'ID de déploiement utilisé dans les noms de ressources.
database_instance_nameNom de l'instance Cloud SQL PostgreSQL.
database_nameNom de la base de données de l'application.
database_userNom de l'utilisateur de la base de données de l'application.
database_password_secretNom du secret Secret Manager pour le mot de passe de la base de données.
storage_bucketsBuckets de stockage GCS créés (inclut le bucket uploads).
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.

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.
webapp_url"" (calculé automatiquement)MoyenSi laissé vide, main.tf calcule une URL de service Cloud Run déterministe et l'injecte comme WEBAPP_URL/NEXTAUTH_URL — Formbricks ne revient pas réellement à localhost:3000 sur cette plateforme. Définissez webapp_url explicitement pour pointer les URI de redirection OAuth et les liens e-mail vers un domaine personnalisé au lieu de l'URL run.app prédite.
db_name"formbricks"CritiqueImmuable après le premier déploiement — la modification de cette valeur entraîne la recréation de la base de données, détruisant toutes les définitions de sondages, les réponses et les données utilisateur.
db_user"formbricks"CritiqueImmuable après le premier déploiement — la modification de cette valeur recrée l'utilisateur PostgreSQL et invalide toutes les informations d'identification stockées.
enable_redistrueÉlevéRedis est activé par défaut. Lorsque redis_host = "", le module revient à l'IP du serveur NFS. Si enable_nfs = false et redis_host est également vide, Formbricks ne peut pas initialiser sa couche de mise en cache et échouera au démarrage.
redis_host"" (résolution automatique vers l'IP NFS)ÉlevéS'appuie sur l'IP du serveur NFS si vide. Si NFS est également désactivé, la connectivité Redis échoue au démarrage.
enable_nfstrueÉlevéSans NFS, les actifs de sondage et les pièces jointes téléchargés sont stockés sur le système de fichiers éphémère du conteneur. Tous les téléchargements sont perdus à chaque nouvelle révision Cloud Run. Plusieurs instances serviront un contenu de fichier incohérent.
memory_limit"2Gi"ÉlevéLe runtime Next.js et l'ORM Prisma de Formbricks nécessitent une heap importante. Réduire en dessous de 512Mi provoque des plantages OOM sous un trafic de sondage normal. 2Gi est le minimum recommandé pour la production.
min_instance_count0MoyenLa mise à l'échelle à zéro provoque des démarrages à froid de 15 à 20 secondes. Les utilisateurs visitant un sondage immédiatement après une période d'inactivité subiront ce délai. Définissez sur 1 pour tout sondage de production avec des exigences de SLA.
cpu_always_allocatedfalseMoyenFacturation basée sur les requêtes par défaut — le pipeline de réponse (e-mails de notification, webhooks, intégrations) ne s'exécute que lorsqu'une instance sert une requête. Si vous exécutez des sondages en direct qui nécessitent des notifications/webhooks en temps réel sans attendre la prochaine requête pour réveiller l'instance, définissez true (facturation basée sur l'instance, coût plus élevé).
smtp_host'smtp.gmail.com' (espace réservé)ÉlevéPar défaut, un nom d'hôte d'espace réservé est utilisé afin que la validation d'environnement de Formbricks dispose d'un bloc SMTP complet ; sans de véritables informations d'identification smtp_user/smtp_password, la livraison des e-mails échoue toujours. Configurez un véritable fournisseur SMTP avant d'inviter des membres de l'équipe.
enable_cloud_armorfalseMoyenSans Cloud Armor, le panneau d'administration de Formbricks est accessible depuis l'internet public, protégé uniquement par l'authentification propre à Formbricks. Activez-le pour tout déploiement de production.
backup_retention_days7MoyenSept jours sont insuffisants pour les déploiements de sondages actifs. Augmentez à plus de 30 jours pour toute instance Formbricks de production collectant des réponses de sondages précieuses.
container_port3000CritiqueFormbricks se lie au port 3000. Modifier cela sans faire correspondre la configuration du serveur d'applications entraîne l'échec de toutes les sondes de santé Cloud Run et le service est marqué comme non sain.
enable_backup_importfalseCritiqueNécessite que backup_uri soit un chemin GCS ou Drive valide et accessible. L'activation avec un backup_uri vide entraîne l'échec du job de restauration pendant l'apply.
secret_propagation_delay30FaibleParfois insuffisant dans les configurations multi-régions. Augmentez à 60-90s si les secrets Formbricks ne sont pas trouvés pendant l'apply.

Destruction des ressources​

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

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

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

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

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

tofu destroy

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

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