Aller au contenu principal

Twenty CRM sur Google Cloud Run

Twenty CRM sur Google Cloud Run

Twenty est un CRM open source avec plus de 25 000 étoiles sur GitHub, conçu comme une alternative moderne et conviviale pour les développeurs à Salesforce et HubSpot. Ce module déploie Twenty sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

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


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

L'exécution de Twenty sur Cloud Run 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 (11 $ US) facturé une seule fois au moment du déploiement. Twenty est un CRM moderne et open source positionné comme une alternative à Salesforce et HubSpot, donc la comparaison honnête se fait par rapport aux prix SaaS par utilisateur plutôt qu'à un simple serveur. Dans un projet géré par RAD, les frais de module tombent à 99 crédits (10 % de moins) et le coût d'exécution est mesuré à l'heure en crédits — voir Mettez-le en pause gratuitement ci-dessous — ou voir le guide GKE si vous préférez l'exécuter sur Kubernetes.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)110 crédits99 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google Cloud83,61 $ US/mois, facturé par Google au prix catalogue~67 crédits/jour (environ 2 010/mois, 201 $ US au prix de la recharge), mesuré 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).

10 crédits coûtent 1 $ US pour une recharge unique, et moins pour un plan mensuel.

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

Ressource (par défaut du module)Par mois
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 cloud hébergé de Twenty facture par utilisateur, par mois : Pro est à 9 $/utilisateur/mois et Organization à 19 $/utilisateur/mois, tous deux facturés annuellement, avec Enterprise à partir de 50 000 $/an pour une isolation à locataire unique — vérifié sur la page de tarification de Twenty, le 8 octobre 2026. Une équipe de vente de cinq personnes sur le plan Pro coûte 45 $/mois et continue de croître avec les effectifs ; le coût d'exécution du projet propre à RAD est un forfait d'environ 84 $ US/mois, que l'équipe compte 5 ou 50 utilisateurs.
  • Salesforce et HubSpot, les acteurs historiques que Twenty est conçu pour remplacer, commencent leurs niveaux CRM payants bien au-dessus de 25-50 $/utilisateur/mois, ce qui est l'écart que Twenty (et RAD qui l'exécute) vise à combler.
  • Une comparaison avec un VPS autogéré, dimensionné selon les valeurs par défaut de Twenty (1 vCPU / 2 GiB) : un Hetzner CPX22 ou un Droplet DigitalOcean de 2 vCPU/4 Go coûte environ 24 $/mois — moins cher en termes de trésorerie, plus votre propre temps pour les sauvegardes et les correctifs Postgres, ce que Cloud SQL et Secret Manager gérés par RAD couvrent.

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

C'est l'avantage principal d'un projet géré par RAD, et cela ne coûte rien pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne détruit 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. La restauration ne peut donc pas être considérée comme un moyen fiable de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce qu'il faut : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox 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 logique 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é Twenty 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​

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

La suppression ne permet d'économiser de l'argent que si Twenty reste inutilisé assez longtemps pour que le coût de redéploiement soit inférieur à son propre coût d'exécution — environ 4 jours ou plus dans votre propre projet (environ 2,79 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (67 crédits par jour).

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

Sessions de lab et environnements gérés​

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

Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, afin que personne ne reçoive de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration ; tarification de Twenty.

1. Vue d'ensemble​

Twenty s'exécute comme un conteneur Node.js sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 2 vCPU / 2 GiB par défaut, autoscaling basé sur les requêtes
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — Twenty ne prend pas en charge MySQL
Stockage d'objetsCloud StorageOptionnel ; un bucket dédié lorsque enable_gcs_storage = true
Jobs en arrière-planRedis (optionnel)bull-mq lorsqu'activé ; pg-boss (basé sur PostgreSQL) par défaut sans infrastructure supplémentaire
SecretsSecret ManagerSecret d'application auto-généré (APP_SECRET / ENCRYPTION_KEY) et mot de passe de base de données
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app, équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • PostgreSQL 15 est obligatoire. La sélection de MySQL ou NONE empêche le démarrage.
  • Redis est activé par défaut. Twenty v0.4+ code en dur Redis pour le stockage de session et de cache — sans une connexion Redis valide, Twenty ne démarre pas. Lorsque redis_host est laissé vide, l'IP de la VM NFS de la plateforme est utilisée (nécessite enable_nfs = true ou un redis_host explicite).
  • pg-boss est la file d'attente de jobs lorsque Redis est désactivé. Il ne nécessite aucune infrastructure supplémentaire et utilise directement la base de données PostgreSQL.
  • Les pièces jointes de fichiers sont par défaut stockées localement de manière éphémère. Activez enable_gcs_storage pour un stockage d'objets persistant utilisant GCS.
  • Trois jobs d'initialisation s'exécutent avant le démarrage du serveur. db-init crée la base de données et l'utilisateur ; twenty-migrate exécute les migrations de schéma TypeORM ; twenty-verify est un job de garde qui fait échouer l'apply si le schéma core n'a pas de tables, détectant une migration en concurrence/échouée bruyamment au lieu de livrer un service sain contre une base de données vide. Les migrations de base de données sont désactivées dans le conteneur principal (DISABLE_DB_MIGRATIONS=true) pour maintenir des démarrages à froid rapides après le premier démarrage.
  • SERVER_URL et FRONT_BASE_URL doivent être définis manuellement. Sans eux, les liens d'API, CORS et les invitations par e-mail sont rompus.
  • Le APP_SECRET / ENCRYPTION_KEY est généré automatiquement et stocké dans Secret Manager ; vous ne le définissez jamais en texte clair.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service Twenty​

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

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

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

B. Cloud SQL pour PostgreSQL 15​

Twenty stocke toutes les données de l'application (contacts, pipelines, objets personnalisés) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé via le proxy d'authentification Cloud SQL via un socket Unix (pas d'IP publique). Lors du premier déploiement, trois jobs d'initialisation s'exécutent en séquence : db-init crée la base de données et l'utilisateur, twenty-migrate exécute les migrations de schéma en utilisant le point d'entrée propre à Twenty, et twenty-verify protège contre un schéma vide en faisant échouer l'apply si les migrations n'ont pas réellement créé de tables.

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

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

C. Cloud Storage (stockage de fichiers optionnel)​

Lorsque enable_gcs_storage = true, un bucket Cloud Storage dédié est provisionné et Twenty est configuré pour utiliser l'API compatible S3 de GCS (STORAGE_TYPE=s3). Sans cela, les pièces jointes sont stockées dans le système de fichiers éphémère du conteneur et sont perdues lors des déploiements de nouvelles révisions.

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

Note : lorsque enable_gcs_storage = true, vous devez fournir les clés HMAC GCS via secret_environment_variables (STORAGE_S3_ACCESS_KEY_ID et STORAGE_S3_SECRET_ACCESS_KEY). Générez-les dans la Console sous Cloud Storage → Paramètres → Interopérabilité.

D. Redis (jobs en arrière-plan)​

Redis prend en charge le stockage de session et de cache de Twenty dans la v0.4+ et, lorsqu'il est activé, bascule le traitement en arrière-plan vers bull-mq. Sans Redis, Twenty utilise pg-boss (une file d'attente de jobs basée sur PostgreSQL) sans infrastructure supplémentaire. Lorsque redis_host est vide et enable_nfs = true, l'IP de la VM NFS est utilisée comme hôte Redis.

Lorsque enable_redis = true, un service Cloud Run worker dédié doit être déployé via additional_services pour consommer la file d'attente bull-mq.

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

E. Secret Manager​

Le secret de l'application Twenty (APP_SECRET / ENCRYPTION_KEY) et le mot de passe de la base de données sont stockés dans Secret Manager et injectés dans le service au moment de l'exécution ; le texte en clair n'apparaît jamais dans la configuration.

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

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

F. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de contrôle d'egress VPC contrôlent la connectivité.

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

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

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

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

3. Comportement de l'application Twenty​

  • Configuration de la base de données au premier déploiement. Trois jobs d'initialisation s'exécutent séquentiellement avant le démarrage du service :
    1. db-init — se connecte à Cloud SQL via le socket Unix du proxy d'authentification, crée la base de données et l'utilisateur PostgreSQL, accorde les privilèges et installe l'extension uuid-ossp. Il est idempotent et peut être réexécuté en toute sécurité.
    2. twenty-migrate — exécute le point d'entrée propre à Twenty (twenty-entrypoint.sh) avec DISABLE_DB_MIGRATIONS=false, exécutant les migrations de schéma TypeORM et enregistrant les jobs cron en arrière-plan. max_retries = 3 car l'instance Cloud SQL d'un nouveau locataire peut encore être en cours de stabilisation lorsque ce job arrive en concurrence.
    3. twenty-verify — un job de garde (depends_on_jobs = ["twenty-migrate"]) qui vérifie que le schéma core a bien des tables et fait échouer l'apply si ce n'est pas le cas. Cela existe parce qu'un échec de job d'initialisation ne fait PAS échouer l'apply du module à lui seul — sans cette garde, une migration twenty-migrate en concurrence ou échouée pourrait livrer silencieusement un service d'apparence saine pointant vers une base de données VIDE (chaque requête backend meurt alors avec relation "core.keyValuePair" does not exist", et l'interface utilisateur affiche "Impossible d'atteindre le backend"). Inspectez-les après le déploiement :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"
  • Migrations désactivées au démarrage normal. Le conteneur principal s'exécute avec DISABLE_DB_MIGRATIONS=true afin que les migrations ne s'exécutent que via le job twenty-migrate. Cela réduit le temps de démarrage à froid de plusieurs minutes à quelques secondes lors des démarrages ultérieurs.
  • Jobs en arrière-plan. Lorsque Redis est désactivé (mode pg-boss), les jobs en arrière-plan — envoi d'e-mails, livraison de webhooks, synchronisation de données — sont traités par le service principal. Lorsque Redis est activé (mode bull-mq), un service worker séparé doit être déployé via additional_services pointant vers la même image avec la commande worker. Inspecter les jobs :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"
  • Chemin de santé. La sonde de démarrage interroge /healthz avec un délai initial de 120 secondes et jusqu'à 40 échecs (~10 minutes) pour accommoder les migrations au premier démarrage. La sonde de vivacité interroge /healthz avec un délai initial de 30 secondes.
  • SERVER_URL est requis. Sans cela, Twenty génère des liens d'API brisés, des erreurs CORS se produisent sur tous les appels d'API et les invitations par e-mail échouent. Définissez-le via environment_variables :
    environment_variables = {
    SERVER_URL = "https://crm.example.com"
    FRONT_BASE_URL = "https://crm.example.com"
    }

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 Twenty sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

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

Groupe 2 — Environnement de déploiement​

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

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nametwentyNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameTwenty CRMNom convivial affiché dans la Console.
description(défini)Description du service.
application_versionlatestTag de version de l'image Twenty. Épinglez à une version spécifique pour la production (par exemple, 0.50.0).

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance. 2 vCPU recommandés pour la production.
memory_limit2GiMémoire par instance. Augmentez à 4Gi pour les grands ensembles de données.
min_instance_count0Instances minimales. Gardez ≥ 1 pour éviter le démarrage à froid sur les charges de travail webhook/job.
max_instance_count3Instances maximales.
cpu_always_allocatedfalseFacturation basée sur les requêtes par défaut : ce service exécute uniquement le serveur de Twenty (node dist/main) — aucun processus worker n'est déployé et l'enregistrement cron est désactivé, il n'y a donc pas de travail en arrière-plan en cours de traitement à limiter. Définissez true uniquement si un worker Twenty ou un autre job en arrière-plan est déployé dans ce conteneur.
container_port3000Twenty écoute sur le port 3000. Ne pas modifier sauf si vous utilisez une image personnalisée.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions de socket Unix.
execution_environmentgen2Gen2 requis pour le réseau VPC.
container_image_sourcecustomcustom (Cloud Build) ou prebuilt (URI d'image existant).
enable_image_mirroringtrueMettre en miroir l'image Twenty dans Artifact Registry.
traffic_split[]Allocation de trafic Canary/bleu-vert entre les révisions.
max_revisions_to_retain7Nombre d'anciennes révisions à conserver.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy. Utile pour l'accès CRM interne.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.
ingress_settingsallQuels réseaux peuvent atteindre le service (tous / interne / LB uniquement).
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres en texte clair. Définissez SERVER_URL et FRONT_BASE_URL ici.
secret_environment_variables{}Mappage de var d'env → nom de secret Secret Manager. Utilisez pour STORAGE_S3_ACCESS_KEY_ID et STORAGE_S3_SECRET_ACCESS_KEY lorsque le stockage GCS est activé.
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer le service.

Groupe 7 — Sauvegarde et restauration​

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

Groupe 8 — CI/CD et autorisation binaire​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization, binauthz_evaluation_mode.

Groupe 9 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Domaine, CDN, Cloud Armor et rétention d'images​

VariableValeur par défautDescription
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge externe. Doit correspondre à SERVER_URL.
enable_cdnfalseActiver Cloud CDN sur le backend LB. Nécessite enable_cloud_armor = true.
enable_cloud_armor / admin_ip_rangesdésactivéAttacher une politique WAF / restreindre l'accès privilégié.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_gcs_storagefalseProvisionner un bucket GCS pour le stockage de fichiers persistant à l'aide de l'API compatible S3.
create_cloud_storage / storage_buckets / gcs_volumes(défini)Buckets supplémentaires / montages GCS Fuse.
enable_nfsfalseVolume NFS (Filestore). Non requis pour Twenty ; activer uniquement si l'IP NFS est utilisée comme hôte Redis.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — ne pas modifier. Options : POSTGRES_15, POSTGRES_14, POSTGRES_13.
db_nametwentyNom de la base de données. Immuable après le premier déploiement.
db_usertwentyUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
db_host_env_var_name / db_name_env_var_name / db_user_env_var_name / db_port_env_var_name / service_url_env_var_name""Noms de variables d'environnement supplémentaires facultatifs sous lesquels les détails de connexion sont injectés.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser les jobs intégrés db-init, twenty-migrate et twenty-verify.
cron_jobs[]Jobs Cloud Run récurrents supplémentaires déclenchés par Cloud Scheduler.
additional_services[]Services Cloud Run supplémentaires. Requis pour un worker bull-mq dédié lorsque enable_redis = true.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / startup_probe_configHTTP /healthz, délai 120s, 40 échecsSonde /healthz ; permet jusqu'à ~10 minutes pour les migrations au premier démarrage.
liveness_probe / health_check_configHTTP /healthz, délai 30sSonde de vivacité.
uptime_check_configdésactivé, chemin /healthzVérification de disponibilité Cloud Monitoring.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueActiver Redis. Requis pour Twenty v0.4+ ; la désactivation force pg-boss.
redis_host""Point de terminaison Redis. Lorsqu'il est vide, l'IP de la VM NFS est utilisée (nécessite enable_nfs = true).
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).

Groupe 22 — Contrôles de service VPC et journalisation d'audit​

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

5. Sorties​

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

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

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

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

ParamètreValeur judicieuseRisqueConséquence si incorrect
SERVER_URL / FRONT_BASE_URL (dans environment_variables)URL publique du déploiementCritiqueLes liens d'API sont rompus, les erreurs CORS bloquent toutes les requêtes, les invitations par e-mail échouent. Définir avant la première utilisation.
database_typePOSTGRES_15CritiqueTwenty nécessite PostgreSQL ; MySQL ou NONE interrompt les migrations de schéma et le démarrage.
db_name / db_userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit les données.
enable_cloudsql_volumetrueCritiqueTwenty se connecte via le socket Unix du proxy d'authentification ; la désactivation supprime le socket et interrompt toutes les connexions à la base de données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation ; la réactivation sur un déploiement en direct écrase les données.
APP_SECRET / ENCRYPTION_KEY (auto-généré)ne pas faire pivoter manuellementCritiqueLa rotation du secret invalide toutes les sessions JWT actives, déconnectant immédiatement chaque utilisateur.
enable_redistrue (requis dans v0.4+)ÉlevéSans Redis, Twenty v0.4+ ne démarre pas ; le stockage de session et de cache est codé en dur pour Redis.
redis_hosthôte explicite ou enable_nfs = trueÉlevéLorsque enable_redis = true et redis_host est vide sans VM NFS, l'URL Redis est vide et Twenty ne parvient pas à se connecter.
additional_services (worker)configuré lors de l'utilisation de RedisÉlevéLorsque enable_redis = true, bull-mq est actif mais aucun worker ne traite la file d'attente ; les jobs en arrière-plan (e-mail, webhooks) ne s'exécutent jamais.
enable_gcs_storagetrue pour la productionÉlevéSans stockage GCS, les pièces jointes sont stockées dans le stockage éphémère du conteneur et perdues lors du déploiement de nouvelles révisions.
STORAGE_S3_ACCESS_KEY_ID / SECRET_ACCESS_KEYvia secret_environment_variablesÉlevéLorsque le stockage GCS est activé, les clés HMAC ne sont pas auto-générées ; toutes les opérations de fichiers échouent sans elles.
memory_limit2GiÉlevéEn dessous de 1 GiB, le processus Node.js est tué par manque de mémoire sous charge.
application_versionversion épinglée (par exemple, 0.50.0)Élevélatest se résout en une image différente à chaque exécution de Cloud Build, rendant les retours arrière imprévisibles.
container_port3000ÉlevéLe serveur de Twenty écoute sur le port 3000 ; toute autre valeur entraîne l'échec permanent des vérifications de santé.
startup_probeHTTP /healthz, délai généreuxÉlevéUne fenêtre trop courte entraîne l'arrêt du service pendant les migrations au premier démarrage (qui prennent 8 à 10 minutes sur un schéma vierge).
min_instance_count1Moyen0 ajoute une latence de démarrage à froid et risque de manquer les webhooks entrants pendant que l'instance monte en charge.
cpu_always_allocatedfalse sauf si un worker est déployéMoyenLa définition de true sans worker/cron en cours d'exécution dans ce conteneur paie pour un CPU inactif sans rien à limiter ; nécessaire uniquement si un travail en arrière-plan est ajouté à ce service.
enable_iap / enable_cloud_armoractiver pour les déploiements non publicsMoyenL'interface CRM est autrement accessible publiquement.
vpc_egress_settingPRIVATE_RANGES_ONLYMoyenLorsque Memorystore Redis est utilisé, son IP privée peut nécessiter ALL_TRAFFIC pour le routage.
organization_iddéfini explicitement pour VPC-SCMoyenLe périmètre VPC-SC n'est pas activé sans cela — enable_vpc_sc = true n'a aucun effet.

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

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