Aller au contenu principal

OpenEMR sur Google Cloud Run

OpenEMR sur Google Cloud Run

OpenEMR est le système de dossiers de santé électroniques (DSE) et de gestion de cabinet open source le plus largement adopté au monde, utilisé par plus de 100 000 professionnels de la santé dans plus de 100 pays. Ce module déploie OpenEMR 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 qu'OpenEMR utilise et sur la façon de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingestion 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 OpenEMR sur RAD, et comment cela se compare​

Pour un petit cabinet, le module Cloud Run d'OpenEMR sur RAD coûte environ 181 $ US par mois, sans licence par utilisateur. Un fournisseur commercial de DSE facture généralement les mêmes fonctionnalités par professionnel par mois, avec l'implémentation et l'hébergement en sus. Les chiffres sont au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 181 $ US ne représentent plus que quelques dollars par mois. 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éploiement300 crédits (30 $ US au prix de la recharge)270 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 buildIdentique
Coût de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 113 crédits par jour, soit environ 3 390 par mois (environ 339 $ 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 maintenu en réserve

10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins avec 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 de fonctionnement par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (valeur par défaut du module)Par mois
Cloud Run, 2x vCPU / 4 Gio (alwaysOn)110,42 $ US
Cloud SQL pour MySQL, 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
Totalenviron 181 $ US
  • Cloud SQL et Cloud Run coûtent le même prix en africa-south1 (Johannesburg) ; la VM coûte environ 10 % de plus.
  • Ce module maintient au moins une instance en cours d'exécution par défaut (min_instance_count est au moins 1), de sorte que la ligne Cloud Run ci-dessus ne se réduit pas entre les requêtes.
  • Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 $ US par mois à elle seule.

Comment cela se compare​

  • Aucun SaaS commercial OpenEMR vérifié n'est nommé ici. La plupart des offres OpenEMR hébergées sont de petits revendeurs régionaux sans liste de prix publique et actuelle, donc cette comparaison se fait avec un serveur nu à la place.
  • Un VPS nu dimensionné près de l'empreinte propre d'OpenEMR de 2 vCPU / 4 Gio — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $/mois, ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) à environ 49 $/mois — semble moins cher en espèces que l'un ou l'autre des chiffres RAD ci-dessus.
  • La différence réside dans ce qui est géré pour vous. Les données des patients se trouvent dans Cloud SQL avec des sauvegardes quotidiennes et sept jours de récupération à un point dans le temps ; les secrets vivent dans Secret Manager ; les journaux et la surveillance proviennent de Google Cloud. Sur un VPS nu, les sauvegardes, les correctifs du système d'exploitation, les mises à niveau de la base de données et la journalisation des accès sont votre propre travail.
  • RAD n'est pas l'option la moins chère en termes d'argent — un VPS nu l'est généralement — mais pour un système de dossiers de santé, qui corrige le serveur et qui peut voir les sauvegardes n'est pas un détail à négliger.
  • Si OpenEMR doit rester actif sans mise à l'échelle à zéro, ou fonctionner à côté d'autres charges de travail Kubernetes, consultez plutôt le guide GKE — environ 150 $ US par mois dans votre propre projet, ou 3 360 crédits (environ 269-336 $ US) par mois dans un projet géré par RAD.

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

Si OpenEMR fonctionne dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, un environnement de démonstration, une activité saisonnière — que de faire fonctionner OpenEMR 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 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 commence par la dissociation de sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà dissociée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un seul module, cela ne détruit pas Cloud SQL, aucune 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 rétablir le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 339 $ US par mois pour le maintenir en fonctionnement. Déployez OpenEMR, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en aurez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et le temps pendant lequel OpenEMR a été réellement 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 et de démonstration conviennent). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes d'OpenEMR sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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 apporté des modifications à OpenEMR que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. 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 façon : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes. 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, la façon 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) : 300 crédits (30,00 $ US), car RAD recrée le projet et les services partagés avant OpenEMR. La suppression ne permet d'économiser de l'argent que si OpenEMR resterait inutilisé pendant environ 6 jours ou plus, à la fois dans votre propre projet (environ 6,03 $ US par jour) et dans un projet géré par RAD (113 crédits par jour).
  • La majeure partie du coût de fonctionnement est généralement la base de données et la 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 d'OpenEMR alors que quelque chose d'autre partage le projet n'économise que la partie calcul d'OpenEMR.
  • Conservez les données en premier. Les sauvegardes sont écrites 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.
  • 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 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 cabinets 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 Google Cloud de l'API Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle.


1. Vue d'ensemble​

OpenEMR s'exécute comme un conteneur Apache/PHP 8.3 FPM sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Apache/PHP, 2 vCPU / 4 Gio par défaut, autoscaling basé sur les requêtes
Base de donnéesCloud SQL pour MySQL 8.0Requis — OpenEMR ne prend pas en charge PostgreSQL
Documents patientFilestore (NFS)Répertoire sites/ avec les documents patient, le cache de session et l'état de l'application partagés entre toutes les instances (gen2 requis)
Stockage d'objetsCloud StorageUn bucket de données à usage général
Stockage de sessionRedisActivé par défaut ; revient à l'adresse IP du serveur NFS si aucun hôte Redis n'est spécifié
SecretsSecret ManagerMot de passe administrateur (OE_PASS) et mot de passe de base de données (MYSQL_PASS) générés automatiquement
IngestionURL 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. La sélection de PostgreSQL ou NONE interrompt le démarrage.
  • NFS est obligatoire et nécessite gen2. Le répertoire sites/ d'OpenEMR — contenant sqlconf.php, les documents patient, les caches Twig/Smarty et les fichiers téléchargés — doit se trouver sur un volume NFS partagé monté via l'environnement d'exécution gen2 de Cloud Run.
  • La sonde de démarrage est TCP, pas HTTP. Le trafic de santé de Cloud Run arrive sur HTTP simple. La pile Apache/PHP d'OpenEMR peut ne pas encore servir HTTP pendant la phase d'installation du premier démarrage, de sorte qu'une sonde HTTP expirerait. Une sonde TCP vérifie uniquement que le port est ouvert et permet à l'installateur de terminer.
  • L'installation au premier démarrage est automatisée et lente. Lors du premier déploiement, deux jobs d'initialisation s'exécutent — nfs-init (configuration du répertoire NFS et restauration de sauvegarde facultative) et db-init (création de l'utilisateur et de la base de données MySQL) — après quoi le conteneur lui-même exécute auto_configure.php pour installer le schéma de la base de données. Cela peut prendre 5 à 20 minutes.
  • Le mot de passe administrateur d'OpenEMR est généré automatiquement et stocké dans Secret Manager ; vous ne le définissez jamais en texte clair.
  • min_instance_count est par défaut à 1. La mise à l'échelle à zéro n'est pas recommandée pour les systèmes DSE cliniques — les démarrages à froid ajoutent une latence que les cliniciens peuvent interpréter comme une défaillance du système.
  • max_instance_count est par défaut à 1. N'augmentez qu'après avoir confirmé que le partage de session Redis est opérationnel ; plusieurs instances sans Redis entraînent une perte de session PHP.
  • cpu_always_allocated est par défaut à true. La configuration initiale d'OpenEMR (effacement du cache Twig, vérification de la base de données de la mise en page de connexion et un passage récursif de durcissement des permissions de fichiers) est un travail en arrière-plan non lié à une seule requête entrante. Sous la facturation basée sur les requêtes (false), Cloud Run réduit le CPU à près de zéro entre les requêtes, de sorte que cette configuration unique peut prendre de nombreuses minutes ou ne jamais se terminer — confirmé en direct : la séquence de démarrage identique est passée de bloquée à une page de connexion entièrement rendue en moins de 15 secondes une fois que cela a été défini true. Ne passez à false qu'une fois que vous avez vérifié que l'instance a dépassé le premier démarrage.

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 OpenEMR​

OpenEMR s'exécute en tant que service Cloud Run v2. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements échelonnés. Le service nécessite l'environnement d'exécution gen2 pour la prise en charge des volumes NFS.

  • 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​

OpenEMR stocke toutes les données cliniques dans une instance Cloud SQL pour MySQL 8.0 gérée. Le service se connecte en privé via le proxy d'authentification Cloud SQL sur un socket Unix (pas d'IP publique). Lors du premier déploiement, le job Cloud Run db-init crée la base de données et l'utilisateur de l'application ; le job nfs-init prépare le répertoire NFS sites/.

  • 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. Filestore (NFS) et Cloud Storage​

Le répertoire sites/ d'OpenEMR est écrit sur un partage Filestore (NFS) monté dans le service à /var/www/localhost/htdocs/openemr/sites. Ce répertoire contient sqlconf.php (qui signale la fin de l'installation), les documents téléchargés par les patients et les caches de modèles Twig/Smarty. Toutes les instances doivent partager le même montage NFS. Un bucket Cloud Storage à usage général est également provisionné.

  • Console : Filestore → Instances ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    # Inspect the nfs-init job execution logs:
    gcloud run jobs executions list --job nfs-init --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour le montage NFS, GCS Fuse et CMEK.

D. Stockage de session Redis​

Redis prend en charge le stockage de session PHP d'OpenEMR. Lorsque redis_host est laissé vide et que NFS est activé, l'instance Redis colocalisée du serveur NFS est utilisée automatiquement. Dans les déploiements multi-instances, un stockage de session partagé est requis pour éviter la perte de session.

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

E. Secret Manager​

Le mot de passe administrateur d'OpenEMR (OE_PASS) et le mot de passe de la base de données MySQL (MYSQL_PASS) 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"
    # Retrieve the admin password to log in for the first time:
    gcloud secrets versions access latest \
    --secret=<admin_password_secret_id> --project "$PROJECT"

L'ID secret du mot de passe administrateur est exposé comme sortie admin_password_secret_id. Voir App_CloudRun pour les détails d'injection et de rotation.

F. Réseau et ingestion​

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'ingestion et de sortie VPC contrôlent le trafic vers/depuis le service.

  • 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 politiques 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

3. Comportement de l'application OpenEMR​

  • Deux jobs d'initialisation s'exécutent à chaque déploiement.

    JobObjectifImage
    nfs-initPrépare la structure de répertoire NFS sites/, définit la propriété à l'UID 1000 (Apache) et restaure éventuellement une sauvegarde lorsque backup_uri est définigoogle-cloud-cli:alpine
    db-initCrée la base de données MySQL et l'utilisateur de l'applicationmysql:8.0-debian

    Inspectez les jobs et leurs exécutions :

    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job nfs-init --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job db-init --project "$PROJECT" --region "$REGION"
  • L'installation du schéma au premier démarrage prend 5 à 20 minutes. Une fois les jobs d'initialisation terminés, le conteneur de service exécute auto_configure.php pour installer le schéma de la base de données OpenEMR et créer le compte administrateur. Pendant cette phase, un serveur web PHP intégré temporaire sert HTTP 200 sur le chemin de la sonde de démarrage, empêchant l'instance d'être tuée pendant l'exécution de l'installateur.

  • La sonde de démarrage est TCP. La sonde de démarrage Cloud Run utilise par défaut TCP sur le port 80 pour éviter les fausses défaillances pendant la phase d'installation du premier démarrage, lorsque Apache/PHP peut ne pas encore servir de réponses HTTP.

  • Mises à niveau tenant compte de la version. Lors des déploiements ultérieurs, le script de démarrage compare la version de l'image à la version stockée sur NFS et exécute automatiquement les scripts de mise à niveau appropriés (fsupgrade-N.sh).

  • Connexion administrateur. Le nom d'utilisateur administrateur initial est admin. Le mot de passe est généré automatiquement et stocké dans Secret Manager — récupérez-le avec :

    gcloud secrets versions access latest \
    --secret=<admin_password_secret_id> --project "$PROJECT"

    Si le compte administrateur est verrouillé après des tentatives de connexion échouées, utilisez l'utilitaire /root/unlock_admin.sh <new_password> depuis le conteneur en cours d'exécution.

  • Considérations HIPAA. OpenEMR stocke des informations de santé protégées (PHI). Pour les déploiements réglementés par la HIPAA, activez enable_iap ou enable_cloud_armor pour restreindre l'accès, définissez enable_audit_logging = true et augmentez backup_retention_days à au moins 90.


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 OpenEMR sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)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 auxquels sont accordés l'accès au projet et les alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameopenemrNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameOpenEMRNom convivial affiché dans la console.
description(défini)Description du service.
application_version7.0.4Tag de version de l'image OpenEMR ; incrémentez pour déployer une nouvelle version.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure sans déployer le conteneur.
cpu_limit2000mCPU par instance ; 2 vCPU recommandés pour les charges de travail cliniques concurrentes.
memory_limit4GiMémoire par instance ; 4 Gio recommandés. Moins de 2 Gio provoque des OOM kills sous charge clinique.
cpu_always_allocatedtrueAllouer le CPU en permanence (facturation basée sur l'instance), pas seulement pendant les requêtes. La configuration en arrière-plan au premier démarrage d'OpenEMR (effacement du cache Twig, vérification de la disposition de la base de données, passage de durcissement des permissions) nécessite un CPU continu ; sous la facturation basée sur les requêtes (false), il se réduit à près de zéro et peut rester bloqué pendant de nombreuses minutes ou ne jamais se terminer.
min_instance_count1Instances minimales. Maintenez ≥ 1 pour éviter les retards de démarrage à froid pour les utilisateurs cliniques.
max_instance_count1N'augmentez qu'après avoir confirmé que le partage de session Redis est opérationnel.
container_port80OpenEMR/Apache écoute sur le port 80.
execution_environmentgen2Doit rester gen2 pour la prise en charge des volumes NFS.
timeout_seconds300Durée maximale de la requête. Augmentez pour la génération de rapports ou les téléchargements de fichiers volumineux.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.
max_revisions_to_retain7Nombre d'anciennes révisions à conserver.

Groupe 5 — Accès et contrôle d'ingestion​

VariableValeur par défautDescription
ingress_settingsallQuels réseaux peuvent atteindre le service. Utilisez internal-and-cloud-load-balancing pour les déploiements HIPAA précédés d'un équilibreur de charge.
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy. Recommandé pour un accès réservé au personnel clinique.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les valeurs de base MYSQL_* et OE_* sont définies automatiquement. Ajouts courants : PHP_MEMORY_LIMIT, SMTP_HOST, SMTP_PORT.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager. À utiliser pour les valeurs sensibles telles que les identifiants SMTP.
secret_propagation_delay / secret_rotation_period(défini)Attente de réplication / cadence de rotation.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC). Ne pas désactiver pour les déploiements réglementés par la HIPAA.
backup_retention_days7Rétention ; augmentez à 30–90 pour la production/conformité.
enable_backup_importfalseRestaurer à partir d'une sauvegarde lors du déploiement.
backup_sourcegcsSource d'importation : gcs ou gdrive.
backup_uri""URI GCS (gs://bucket/path) ou ID de fichier Google Drive. Lorsqu'il est défini, injecté dans nfs-init comme BACKUP_FILEID.
backup_formatsqlFormat de fichier de sauvegarde : sql, tar, gz, tgz, tar.gz ou zip.

Groupe 8 — CI/CD et autorisation binaire​

Intégration standard de Cloud Build / Cloud Deploy d'App_CloudRun — 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 — Instance NFS et SQL personnalisé​

VariableValeur par défautDescription
nfs_instance_name / nfs_instance_base_name(défini)Instance NFS existante / nom de base pour une instance intégrée.
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootoffExécuter SQL à partir d'un bucket GCS après le provisionnement.

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

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner l'équilibreur de charge HTTPS global + Cloud Armor WAF.
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge.
admin_ip_ranges[]CIDR autorisés à un 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_nfstrueDoit rester true. OpenEMR nécessite NFS pour le répertoire sites/.
nfs_mount_path/var/www/localhost/htdocs/openemr/sitesChemin de montage. Doit correspondre au répertoire des sites OpenEMR.
create_cloud_storage / storage_buckets / gcs_volumes(défini)Bucket de données / buckets supplémentaires / montages GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Fixe — ne pas modifier. OpenEMR nécessite MySQL.
db_nameopenemrNom de la base de données. Immuable après le premier déploiement.
db_useropenemrUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotation / rotation_propagation_delay_secoffRotation du mot de passe de la base de données.
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 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 la séquence intégrée nfs-init / db-init.
cron_jobs[]Jobs Cloud Run récurrents invoqués selon un calendrier.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP sur le port 80, 12 échecs × 10sSonde de démarrage TCP. Évite les échecs de sonde HTTP pendant la phase d'installation du premier démarrage.
liveness_probeHTTP GET /interface/login/login.php, 10 échecs × 30sLa page de connexion renvoie HTTP 200 uniquement lorsque la pile complète est opérationnelle.
uptime_check_configdésactivéTest de disponibilité Cloud Monitoring. Activez explicitement une fois le service accessible.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Stockage de session Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis pour le stockage de session PHP.
redis_host""Laissez vide pour utiliser l'IP du serveur NFS ; définissez explicitement pour une instance Memorystore dédiée.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC. Nécessite que organization_id soit défini explicitement. Recommandé pour les environnements HIPAA.
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 (DATA_READ, DATA_WRITE). Recommandé pour la conformité HIPAA.

5. Sorties​

Retournées 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 par défaut run.app 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 (si activé).
admin_password_secret_idID du secret Secret Manager pour le mot de passe administrateur d'OpenEMR (OE_PASS).
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 (MYSQL_PASS).
database_host / database_portPoint de terminaison / port de la base de données.
nfs_server_ipIP interne du serveur NFS (sensible).
nfs_instance_tagsTags réseau de l'instance NFS.
nfs_mount_pathChemin de montage NFS à l'intérieur du conteneur.
nfs_share_pathChemin de partage NFS sur le serveur.
nfs_setup_jobNom du job de configuration NFS.
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 la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration.
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_configurationStatut 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_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
enable_nfstrueCritiqueOpenEMR ne peut pas fonctionner sans NFS. Le répertoire sites/, sqlconf.php et les documents des patients résident tous sur NFS. La désactivation entraîne un échec immédiat au démarrage.
nfs_mount_path/var/www/localhost/htdocs/openemr/sitesCritiqueDoit correspondre au chemin du répertoire des sites OpenEMR. Une non-concordance signifie que nfs-init prépare le mauvais emplacement et que le conteneur ne trouve jamais un sqlconf.php configuré.
execution_environmentgen2Critiquegen1 ne prend pas en charge les montages NFS ; le service ne démarre pas.
database_typeMYSQL_8_0CritiqueOpenEMR nécessite MySQL ; PostgreSQL ou NONE interrompt l'installateur et tous les appels de base de données PHP.
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 toutes les données des patients.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide échoue le job d'importation et peut corrompre le répertoire des sites NFS.
backup_schedule0 2 * * *CritiqueLa désactivation des sauvegardes pour un DSE contenant des informations de santé protégées (PHI) est une violation de la conformité HIPAA.
startup_probeTCP (par défaut)ÉlevéUne sonde HTTP échoue pendant la phase d'installation au premier démarrage lorsque Apache n'a pas encore complètement démarré, ce qui entraîne le redémarrage du conteneur par Cloud Run avant la fin de la configuration.
enable_redistrueÉlevéPlusieurs instances avec des magasins de sessions PHP isolés entraînent une perte de session et des échecs de connexion pour les utilisateurs cliniques.
redis_host"" (NFS) ou expliciteÉlevéUn hôte Redis inaccessible provoque des échecs de session PHP et empêche toutes les connexions.
memory_limit≥ 4GiÉlevéLa génération de PDF et les rapports de facturation d'OpenEMR sont gourmands en mémoire. Moins de 2 Gio provoque des arrêts OOM en cours de requête.
min_instance_count1ÉlevéLa mise à l'échelle à zéro ajoute une latence de démarrage à froid et risque un accès clinique manqué.
cpu_always_allocatedtrueÉlevéLa configuration au premier démarrage d'OpenEMR (effacement du cache Twig, vérification de la disposition de la base de données, passage de durcissement des permissions) est un travail de fond, non lié à une requête. Avec la facturation basée sur les requêtes (false), le CPU est étranglé à presque zéro entre les requêtes, de sorte que le premier démarrage peut prendre de nombreuses minutes ou ne jamais se terminer — confirmé en direct : un démarrage identique est passé de bloqué à une page de connexion rendue en moins de 15 secondes une fois true.
backup_retention_days7 (augmenter pour la production)MoyenLes environnements réglementés par HIPAA devraient conserver au moins 90 jours.
enable_iap / enable_cloud_armoractiver pour la santéMoyenL'interface d'administration d'OpenEMR et les dossiers des patients sont accessibles publiquement sans ces contrôles.
enable_audit_loggingtrue pour HIPAAMoyenHIPAA exige la journalisation d'audit de l'accès aux PHI.

Pour le comportement fondamental 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 à OpenEMR partagée avec la variante GKE est décrite dans OpenEMR_Common.

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