Aller au contenu principal

EspoCRM sur Google Cloud Run

EspoCRM sur Google Cloud Run

EspoCRM est une plateforme de gestion de la relation client (CRM) open source, sous licence GPLv3, basée sur PHP et Apache. Ce module déploie EspoCRM sur Cloud Run v2 sur la base 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 EspoCRM et sur la manière de les explorer et de les exploiter à partir de la console Google Cloud et de la ligne de commande. Pour les mécanismes communs à toutes les applications Cloud Run — identité de service, entrée et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte EspoCRM sur RAD, et comparaison​

Dans un projet Google Cloud que vous possédez, le module Cloud Run d'EspoCRM sur RAD coûte environ 84 US$ par mois, plus 7,50 US$ une fois par déploiement et aucune licence par utilisateur. GKE Autopilot est l'alternative pour les charges de travail qui doivent rester actives en permanence ou fonctionner à côté d'autres applications Kubernetes ; consultez le guide GKE, environ 110 US$ par mois. EspoCRM est un CRM gratuit et open source qui gère les comptes, les contacts, les prospects, les opportunités et les cas. Les chiffres sont valables au 8 octobre 2026 ; les sources sont énumérées à la fin de cette section.

Si cela s'exécute dans un projet géré par RAD pour vous, il peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de rester en cours d'exécution — ainsi, un déploiement à usage occasionnel coûte quelques dollars par mois, et non les 201 US$ par mois qu'il coûte pour le maintenir en fonctionnement. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement75 crédits (7,50 US$ au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour créer, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien à supprimer 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 au temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 84 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, environ 2 010 par mois (environ 201 US$ au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est détenu en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : le premier à 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. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1 vCPU / 2 Gio, mise à l'échelle à zéro13 US$
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 US$
Serveur de fichiers NFS/cache : une petite VM13 US$
Passerelle et adresse IP Cloud NAT5 US$
Cloud Storage pour les modules complémentaires et les sauvegardes1 US$
Totalenviron 84 US$

Comment cela se compare​

EspoCRM a son propre plan hébergé officiel, EspoCRM Cloud : les plans hébergés officiels d'EspoCRM sont de 11 £/utilisateur/mois (Basic, minimum 3 utilisateurs), 19 £/utilisateur/mois (Enterprise, minimum 5 utilisateurs) et 49 £/utilisateur/mois (Ultimate, minimum 10 utilisateurs) — lu le 8 octobre 2026.

OptionPar moisQui l'exécute
EspoCRM Cloud, Basic (3 utilisateurs min.)33 £/mois (3 × 11 £)EspoCRM
EspoCRM Cloud, Enterprise (5 utilisateurs min.)95 £/mois (5 × 19 £)EspoCRM
RAD, Cloud Run, votre propre projet84 US$, plus 7,50 US$ une foisAutomatisation de RAD, dans votre projet
RAD, Cloud Run, un projet géré par RADenviron 960 crédits (96 US$)RAD
RAD, GKE Autopilotenviron 110 US$ ; voir le guide GKE AutopilotRAD

Le prix d'EspoCRM Cloud a été lu sur sa propre page de tarification le 8 octobre 2026 et peut avoir changé depuis — vérifiez la source avant de vous fier au chiffre.

  • EspoCRM Cloud est la comparaison fixe ; un serveur autogéré est la comparaison flexible. Sur votre propre machine Hetzner ou DigitalOcean (2 vCPU/4 Go, environ 24 US$/mois) ou une instance GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, environ 49 US$/mois), vous paieriez moins en espèces que l'une ou l'autre option, mais vous géreriez vous-même le système d'exploitation, la base de données, les sauvegardes, les correctifs de sécurité et les mises à niveau — exactement ce que les services Cloud SQL, Secret Manager et de surveillance gérés par RAD font pour vous.
  • Un serveur bon marché est bon marché jusqu'à ce que quelque chose tombe en panne. Sur RAD, les sauvegardes, la récupération à un instant précis, la rotation des mots de passe via Secret Manager, ainsi que la journalisation et la surveillance proviennent de Google Cloud par défaut. Sur votre propre serveur, ou sur un plan hébergé à prix fixe sans contrôle d'infrastructure, chacun de ces éléments est un travail que quelqu'un doit encore faire ou une limite que vous ne pouvez pas modifier.

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

Si EspoCRM s'exécute dans un projet géré par RAD pour vous, vous avez une option au-delà de la mise à l'échelle : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à un déploiement dont vous n'avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, un besoin saisonnier — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration. Par conséquent, la restauration ne peut 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.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne le supprime pas immédiatement : il le conserve, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, la VM ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de restaurer 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 201 US$ par mois pour le maintenir en fonctionnement. Déployez EspoCRM, utilisez-le pour une session, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez que les frais de module une fois et les heures pendant lesquelles il a effectivement été actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes 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é ce déploiement et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Ne payez que pendant que vous l'utilisez, l'autre façon : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes, de sorte que la majeure partie de son propre coût de calcul s'arrête d'elle-même lorsque personne ne l'utilise. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, le moyen d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 US$). La suppression permet d'économiser de l'argent si EspoCRM resterait inutilisé pendant environ 3 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).
  • Supprimez tout ce qu'EspoCRM utilise. La majeure partie du coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée. Elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
  • Conservez 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 la supprimer si vous voulez la conserver.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lors du déploiement.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose d'EspoCRM 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 mise en pause 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 ceux du client.

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

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour le mécanisme de pause/restauration ; Tarification EspoCRM Cloud. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

EspoCRM s'exécute en tant que conteneur PHP/Apache sur Cloud Run v2. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Apache/PHP, 1 vCPU / 2 Gio par défaut, autoscaling sans serveur ; mise à l'échelle à zéro prise en charge
Base de donnéesCloud SQL pour MySQL 8.0Obligatoire — EspoCRM ne prend pas en charge PostgreSQL ; connecté via TCP sur IP privée
Stockage d'objetsCloud Storage + Filestore (NFS)Un bucket GCS dédié gcs-espocrm<tenant-prefix>-espocrm-data est provisionné mais non monté par défaut ; un volume NFS partagé est monté à /var/www/html/data pour les téléchargements (enable_nfs = true par défaut)
CacheRedis (facultatif)Cache d'objets facultatif ; désactivé par défaut
SecretsSecret ManagerESPOCRM_ADMIN_PASSWORD auto-généré ; mot de passe de la base de données
EntréeURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • MySQL 8.0 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée (database_type = "MYSQL_8_0") ; EspoCRM ne prend pas en charge PostgreSQL.
  • La base de données est accessible via TCP sur IP privée, et non via un socket. enable_cloudsql_volume est par défaut false sur Cloud Run. La connexion MySQL PDO d'EspoCRM nécessite un véritable hôte TCP, donc cloud-entrypoint.sh compose l'IP privée Cloud SQL (DB_IP). Cloud SQL MySQL n'impose pas SSL sur TCP sur IP privée, donc aucun câblage TLS supplémentaire n'est requis.
  • Le compte administrateur est amorcé automatiquement. L'installateur en amont crée l'utilisateur admin avec le ESPOCRM_ADMIN_PASSWORD auto-généré au premier démarrage — récupérez-le de Secret Manager pour vous connecter.
  • Le schéma est créé au premier démarrage, et non par un job de migration. db-init crée la base de données et l'utilisateur ; le docker-entrypoint.sh en amont exécute ensuite l'action d'installation/migration automatiquement lorsque le conteneur démarre.
  • La mise à l'échelle à zéro est activée par défaut (min_instance_count = 0, max_instance_count = 1). Les démarrages à froid ajoutent plusieurs secondes de latence à la première requête après une période d'inactivité. Définissez min_instance_count = 1 pour éviter les démarrages à froid.
  • NFS est activé par défaut. enable_nfs = true monte un volume Filestore partagé à /var/www/html/data, de sorte que les pièces jointes téléchargées et les données d'exécution d'EspoCRM persistent après les redémarrages du conteneur et sont partagées entre les instances — contrairement à un déploiement Cloud Run nu avec seulement un disque éphémère. Le bucket GCS gcs-espocrm<tenant-prefix>-espocrm-data auto-provisionné n'est pas monté par défaut.
  • Instance unique par défaut. max_instance_count = 1 — Cloud Run n'a pas d'affinité de session intégrée, donc maintenez le service en instance unique à moins que vous n'ayez vérifié le comportement d'EspoCRM sous des sessions PHP concurrentes sur plusieurs réplicas.
  • ESPOCRM_SITE_URL est dérivé de l'URL de service prédite au moment de la planification et résolu par le point d'entrée, de sorte que les liens absolus et les vérifications de l'installateur d'EspoCRM utilisent le véritable hôte Cloud Run plutôt que localhost.
  • Entrée publique par défaut. ingress_settings = "all" pour que l'interface utilisateur du CRM soit accessible ; l'activation d'IAP place la connexion Google devant elle.

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 signalés dans les Sorties du déploiement.

A. Cloud Run — le service EspoCRM​

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

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

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

B. Cloud SQL pour MySQL 8.0​

EspoCRM stocke toutes les données de l'application (contacts, prospects, opportunités, activités, utilisateurs) dans une instance Cloud SQL pour MySQL 8.0 gérée. Étant donné que enable_cloudsql_volume est par défaut false, le service se connecte via l'IP privée (DB_IP) via la sortie VPC sur le port 3306 ; aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application.

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

Un bucket Cloud Storage dédié (gcs-espocrm<tenant-prefix>-espocrm-data) est provisionné automatiquement, mais il n'est pas monté par défaut (gcs_volumes est par défaut []). Le stockage persistant réel pour les pièces jointes téléchargées et les données d'exécution d'EspoCRM est un volume NFS (Filestore) partagé, monté à /var/www/html/data car enable_nfs = true par défaut. Des buckets GCS supplémentaires peuvent être déclarés via storage_buckets, et montés via gcs_volumes (nécessite l'environnement d'exécution gen2) si vous souhaitez utiliser le bucket.

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

Voir App_CloudRun pour les options GCS Fuse, NFS et CMEK.

D. Cache d'objets Redis​

Redis est désactivé par défaut. Lorsque enable_redis = true est défini, REDIS_HOST et REDIS_PORT sont injectés et EspoCRM utilise Redis comme backend de cache d'objets pour réduire la charge de la base de données. Lorsque redis_host est laissé vide et enable_nfs est vrai, l'IP de la VM du serveur NFS est utilisée comme point de terminaison Redis.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    # Confirm the Redis env injected into the running revision:
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

E. Secret Manager​

Le mot de passe administrateur de première exécution (ESPOCRM_ADMIN_PASSWORD) est généré automatiquement et stocké dans Secret Manager, puis injecté dans le service en tant que variable d'environnement secrète. Le mot de passe de la base de données est géré séparément par la fondation.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~espocrm-admin-password"
    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 entrée​

Le service est accessible à son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être ajoutés ; les paramètres d'entrée et la sortie VPC contrôlent la connectivité. EspoCRM se connecte à Cloud SQL via le VPC, donc la sortie VPC doit atteindre l'IP privée.

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

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

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

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

Le cloud-entrypoint.sh affiche les valeurs résolues ESPOCRM_DATABASE_* et ESPOCRM_SITE_URL au démarrage — un moyen rapide de confirmer l'hôte de la base de données et l'URL du site utilisés par le conteneur.


3. Comportement de l'application EspoCRM​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute db-init.sh à l'aide de mysql:8.0-debian. Il résout la connexion Cloud SQL (socket du proxy d'authentification si présent, sinon TCP sur IP privée), crée de manière idempotente la base de données et l'utilisateur de l'application, accorde les privilèges et vérifie que l'utilisateur de l'application peut se connecter (en réchauffant le cache d'authentification caching_sha2_password de MySQL 8). Le job s'exécute lors de l'apply et peut être réexécuté en toute sécurité.
  • Schéma créé au premier démarrage. Il n'y a pas de job de migration séparé. Une fois que db-init a provisionné la base de données, le docker-entrypoint.sh EspoCRM en amont exécute automatiquement l'action d'installation/migration au démarrage du conteneur, créant le schéma et l'utilisateur admin.
  • La connexion administrateur est auto-générée. Le mot de passe de l'utilisateur admin provient du secret ESPOCRM_ADMIN_PASSWORD. Récupérez-le avant votre première connexion :
    gcloud secrets versions access latest \
    --secret="secret-<resource_prefix>-espocrm-admin-password" --project "$PROJECT"
    Changez-le dans l'interface utilisateur d'EspoCRM (Administration → Utilisateurs) une fois que vous êtes connecté.
  • L'URL du site doit correspondre à l'hôte accessible. EspoCRM construit des liens absolus à partir de ESPOCRM_SITE_URL ; le point d'entrée le définit à partir de l'URL prédite run.app (ou CLOUDRUN_SERVICE_URL au moment de l'exécution). Si vous placez un domaine personnalisé devant le service, définissez l'URL du site sur cet hôte afin que les liens et les redirections OAuth soient corrects.
  • Chemin de santé. Le démarrage utilise une sonde TCP sur le port 80 ; la sonde de vivacité est HTTP GET / — EspoCRM sert sa page de connexion sans authentification (200). Prévoyez plusieurs minutes au premier démarrage pour l'étape d'installation/migration (la sonde de vivacité par défaut a un délai initial de 300 secondes).
  • Les téléchargements persistent sur NFS. Avec enable_nfs = true (par défaut), les pièces jointes et les données d'exécution d'EspoCRM résident sous le montage Filestore partagé /var/www/html/data, survivant aux redémarrages du conteneur et partagées entre les instances. Le bucket GCS gcs-espocrm<tenant-prefix>-espocrm-data est provisionné mais non monté par défaut.
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

4. Variables de configuration​

Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour EspoCRM sont listés ; chaque autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameespocrmNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameEspoCRMNom lisible par l'homme affiché dans la console.
application_versionlatestTag d'image pour espocrm/espocrm ; latest est épinglé en interne à 10.0.2. Épinglez à une version spécifique en production.
php_memory_limit512MLimite de mémoire PHP ; augmentez-la pour les plugins lourds ou les gros médias.
upload_max_filesize64MTaille maximale de téléchargement d'un seul fichier (≤ post_max_size).
post_max_size64MTaille maximale de POST ; doit être ≥ upload_max_filesize.

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 ; minimum 1 vCPU pour EspoCRM + MySQL.
memory_limit2GiMémoire par instance ; minimum 512 Mio (PHP 8.x).
min_instance_count00 active la mise à l'échelle à zéro ; définissez 1 pour éviter les démarrages à froid.
max_instance_count1Gardez à 1 sauf si le stockage partagé + l'affinité de session sont confirmés.
container_port80Apache écoute sur le port 80.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseEspoCRM se connecte à MySQL via TCP sur IP privée, et non via le socket.

Groupe 5 — Accès et contrôle d'entrée​

VariableValeur par défautDescription
ingress_settingsallAccès public à l'interface utilisateur du CRM.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer le trafic RFC 1918 (y compris l'IP privée Cloud SQL) via le VPC.
enable_iapfalseExiger la connexion Google devant EspoCRM.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCrée le bucket gcs-espocrm<tenant-prefix>-espocrm-data. Non monté par défaut, sauf si vous ajoutez une entrée gcs_volumes correspondante.
storage_buckets[{ name_suffix = "data" }]Définitions de bucket provisionnées lorsque create_cloud_storage est vrai.
enable_nfstrueMonte un volume Filestore partagé pour les pièces jointes téléchargées et les données d'exécution d'EspoCRM — persiste après les redémarrages par défaut.
nfs_mount_path/var/www/html/dataChemin de montage du conteneur pour le volume NFS.
gcs_volumes[]Pas de montage GCS Fuse par défaut ; le bucket gcs-espocrm<tenant-prefix>-espocrm-data reste non monté, sauf si vous ajoutez une entrée ici.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Moteur Cloud SQL. EspoCRM nécessite MySQL — ne sélectionnez pas PostgreSQL.
db_nameespocrmNom de la base de données MySQL. Immuable après le premier déploiement.
db_userespocrmUtilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe de la base de données généré (plage valide 16–64).

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseActive Redis comme backend de cache d'objets d'EspoCRM.
redis_host""Point de terminaison Redis. Laissez vide pour utiliser l'IP du serveur NFS (nécessite enable_nfs = true).
redis_port6379Port Redis.

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


5. Sorties​

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

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Manager secret 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_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état 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).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un redis_port/backup_retention_days hors plage, un environnement d'exécution gen1 avec des montages NFS/GCS, IAP sans identités autorisées. Une configuration invalide échoue la planification avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'au moment de l'apply ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typeMYSQL_8_0CritiqueEspoCRM ne prend en charge que MySQL ; la sélection de PostgreSQL interrompt le démarrage.
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données.
ESPOCRM_ADMIN_PASSWORD (auto-généré)Récupérer de Secret Manager ; modifier dans l'interface utilisateurCritiqueNe définit le mot de passe administrateur que lors de la première installation ; le perdre vous bloque jusqu'à la réinitialisation via la base de données.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans URI de sauvegarde valide échoue le job d'importation.
enable_nfstrueÉlevéLe désactiver fait passer le stockage des pièces jointes d'EspoCRM sur un disque de conteneur éphémère — les téléchargements sont perdus lorsqu'une instance est mise à l'échelle ou recyclée.
max_instance_count1 sauf si la sécurité est vérifiéeMoyenLes téléchargements sont sauvegardés par NFS par défaut, mais Cloud Run n'a pas d'affinité de session intégrée — vérifiez le comportement d'EspoCRM sous des sessions PHP concurrentes avant de passer à plus d'une instance.
enable_cloudsql_volumefalse (TCP sur IP privée)ÉlevéForcer le socket sans chemin de point d'entrée correspondant peut interrompre la connexion MySQL ; EspoCRM compose l'IP privée par conception.
ESPOCRM_SITE_URL (auto-dérivé)URL réelle du service / du domaine personnaliséÉlevéUne URL de site incorrecte rompt les liens absolus, la vérification de l'installateur et les redirections OAuth.
memory_limit2GiÉlevéEn dessous de 512 Mio, PHP 8.x tue le processus par manque de mémoire lors de l'installation/migration et sous charge.
cpu_limit1000mMoyenEn dessous de 1 vCPU, l'installation au premier démarrage et le traitement des plugins lourds sont ralentis.
enable_iapuniquement lorsque l'interface utilisateur publique n'est pas nécessaireMoyenIAP nécessite une connexion Google pour chaque requête, y compris les intégrations d'API.
min_instance_count1 pour la productionMoyenLa mise à l'échelle à zéro (0) ajoute un délai de démarrage à froid et, sans volume partagé, supprime les téléchargements locaux lors de la mise à l'échelle.
application_versionÉpingler en productionMoyenlatest correspond à un tag épinglé en interne, mais l'épinglage explicite évite les mises à niveau surprises lors du redéploiement.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, entrée 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 à EspoCRM partagée avec la variante GKE est décrite dans EspoCRM_Common.

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