Aller au contenu principal

Moodle sur Google Cloud Run

Moodle sur Google Cloud Run

Moodle est le système de gestion de l'apprentissage (LMS) open source le plus populaire au monde, utilisé par les universités, les écoles, les entreprises et les fournisseurs de formation en ligne du monde entier. Ce module déploie Moodle sur Cloud Run v2 en s'appuyant sur le socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud que Moodle utilise 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 du socle App_CloudRun plutôt que de les répéter ici.


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

L'exécution de Moodle dans votre propre projet GCP coûte environ 83,61 $/mois en frais Google Cloud ; les frais de module de RAD sont de 110 crédits uniques (ou 99 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD mesure à l'heure en crédits dans un projet géré par RAD. Vous pouvez également consulter le guide GKE pour la cible de déploiement alternative ; dans tous les cas, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits, une fois99 crédits, une fois (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google Cloud~83,61 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~67 crédits/jour, mesuré à l'heure par RAD au prix catalogue plus marge

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

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

RessourceUS$/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 2 GiB (scaleToZero)13,16 $
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Serveur de fichiers NFS/cache (petite VM)13,43 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Total83,61 $

Comparaison​

  • Il n'existe pas de SaaS géré officiel vérifié pour Moodle à comparer, donc la base de référence honnête est un VPS nu : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte également 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous.
  • RAD n'est pas censé être moins cher qu'un VPS en termes monétaires, et ne l'est généralement pas — pour un système de gestion de l'apprentissage d'une institution, le véritable argument est ce que RAD gère pour vous (sauvegardes, correctifs, secrets, surveillance) plutôt que le prix affiché.
  • Dans tous les cas, il s'agit du système de gestion de l'apprentissage d'une institution, donc le coût d'exécution ci-dessus est ce qui génère réellement la facture, pas les frais de module — et ce coût d'exécution est celui que vous pouvez mettre en pause (voir ci-dessous).

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

C'est le titre pour un projet géré par RAD. La suppression d'un projet géré par RAD commence par délier sa facturation, puis demande à Google de supprimer complètement 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, sera utilisable après sa restauration, de sorte que 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.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google d'annuler la suppression du projet et de rattacher son compte de facturation, puis vous demande d'exécuter la 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é l'application et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer Moodle complètement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits.

La suppression ne permet d'économiser de l'argent que si Moodle reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet ci-dessus, cela représente environ 4 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données et la VM de fichier/cache partagée ; elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

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

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est 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 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 ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

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

CapacitéService Google CloudNotes
CalculCloud Run v2Service PHP 8.3/Apache, 1 vCPU / 2 GiB par défaut, autoscaling basé sur les requêtes
Base de donnéesCloud SQL pour PostgreSQL 15Requis — Moodle ne prend pas en charge MySQL dans ce déploiement
Fichiers partagésFilestore (NFS)Répertoire Moodle moodledata partagé entre toutes les instances ; obligatoire
Stockage d'objetsCloud StorageUn bucket de données et tout bucket supplémentaire défini par l'utilisateur
Cache et sessionsRedisActivé par défaut ; requis pour la cohérence des sessions PHP multi-instances
SecretsSecret ManagerMot de passe cron, mot de passe SMTP et mot de passe de base de données générés automatiquement
PlanificateurCloud SchedulerJob cron provisionné automatiquement (toutes les minutes) pour /admin/cron.php
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixe et MOODLE_DB_TYPE = "pgsql" est codé en dur ; la sélection de MySQL ou NONE interrompt le démarrage.
  • NFS est obligatoire. Le répertoire Moodle moodledata doit être un système de fichiers partagé inscriptible accessible à toutes les instances. enable_nfs est par défaut true et nécessite execution_environment = "gen2".
  • La sonde de démarrage est HTTP ciblant /health.php. Contrairement à certaines applications PHP qui émettent des redirections HTTP→HTTPS, Apache dans ce déploiement se lie sur le port 8080 sans redirection, donc une sonde HTTP vers /health.php renvoie directement 200.
  • Redis est activé par défaut. Sans un magasin de sessions partagé, les utilisateurs sont déconnectés lorsqu'une requête atteint une instance Cloud Run différente.
  • Un job Cloud Scheduler est provisionné automatiquement. Il se déclenche toutes les minutes vers /admin/cron.php en utilisant un mot de passe cron sécurisé, généré automatiquement et stocké dans Secret Manager.
  • Le mot de passe cron et le mot de passe SMTP sont générés automatiquement et stockés dans Secret Manager ; vous ne les 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 indiqués dans les Sorties du déploiement.

A. Cloud Run — le service Moodle​

Moodle s'exécute en tant que service Cloud Run v2 sans état. L'autoscaling basé sur les requêtes ajoute des instances sous charge et, avec min_instance_count = 0, se met à l'échelle à zéro entre les sessions (développement) ou maintient une instance chaude lorsqu'il est défini sur 1 (production).

  • Console : Cloud Run → sélectionnez le service Moodle pour les logs, les révisions, les métriques et la configuration.
  • CLI :
    gcloud run services list --region "$REGION" --project "$PROJECT"
    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT"
    gcloud run revisions list --service <service-name> --region "$REGION" --project "$PROJECT"
    # Stream recent logs:
    gcloud logging read \
    'resource.type="cloud_run_revision" AND resource.labels.service_name="<service-name>"' \
    --project "$PROJECT" --limit 50 --order asc

Voir App_CloudRun pour les détails sur la mise à l'échelle, la concurrence et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

Moodle stocke toutes les données de l'application (cours, utilisateurs, notes, journaux d'activité) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Chaque instance Cloud Run se connecte en privé via le sidecar Cloud SQL Auth Proxy sur un socket Unix, de sorte qu'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 et active l'extension pg_trgm pour la recherche en texte intégral de Moodle.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les flags et les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    # Open an interactive shell to inspect schema/data:
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"

Le nom de l'instance, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_CloudRun.

C. Filestore (NFS) et Cloud Storage​

Le répertoire moodledata de Moodle est écrit sur un partage Filestore (NFS) monté dans chaque instance Cloud Run afin que toutes les instances voient les mêmes fichiers téléchargés, les mêmes supports de cours et les mêmes soumissions d'utilisateurs. Un bucket de données Cloud Storage dédié est également provisionné ; le compte de service se voit accorder l'accès automatiquement.

Les montages de volume NFS nécessitent execution_environment = "gen2" (la valeur par défaut).

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

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

D. Cache Redis​

Redis prend en charge la gestion des sessions PHP et le cache d'application de Moodle. Lorsqu'aucun hôte Redis externe n'est configuré et que NFS est activé, l'adresse IP de l'hôte NFS est utilisée comme point de terminaison Redis — adapté au développement. Pour la production avec plusieurs instances, définissez redis_host sur une adresse IP d'instance Cloud Memorystore.

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

E. Secret Manager​

Le mot de passe cron de Moodle et le mot de passe SMTP sont générés automatiquement par Moodle_Common et stockés en tant que secrets Secret Manager. Le mot de passe de la base de données est généré et géré par le socle. Les trois sont injectés dans les instances Cloud Run au moment de l'exécution ; le texte clair n'apparaît jamais dans les fichiers de configuration.

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

Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Après le déploiement, mettez à jour le secret du mot de passe SMTP avec votre véritable identifiant SMTP :

echo -n "your-smtp-password" | \
gcloud secrets versions add <smtp-password-secret> --data-file=- --project "$PROJECT"

Voir App_CloudRun pour les détails de rotation.

F. Cloud Scheduler​

Un job Cloud Scheduler est provisionné automatiquement à chaque déploiement pour piloter la file d'attente de tâches interne de Moodle. Il se déclenche toutes les minutes et s'authentifie à l'aide du MOODLE_CRON_PASSWORD généré automatiquement.

  • Console : Cloud Scheduler → Jobs.
  • CLI :
    gcloud scheduler jobs list --project "$PROJECT"
    gcloud scheduler jobs describe <job-name> --location "$REGION" --project "$PROJECT"
    # Manually trigger a cron run:
    gcloud scheduler jobs run <job-name> --location "$REGION" --project "$PROJECT"

G. Réseau et ingress​

Par défaut, Moodle est accessible via l'URL run.app gérée par Cloud Run. Un équilibreur de charge HTTPS facultatif avec Cloud Armor et un domaine personnalisé peut être activé. La définition de application_domains injecte automatiquement MOODLE_REVERSE_PROXY = "true" et ENABLE_REVERSE_PROXY = "TRUE" afin que Moodle génère des URL HTTPS correctes derrière l'équilibreur de charge.

  • Console : Cloud Run → sélectionnez le service → Réseau ; Services réseau → Équilibrage de charge (si vous utilisez Cloud Armor).
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT" \
    --format="value(status.url)"
    gcloud compute forwarding-rules list --project "$PROJECT" # if LB is enabled

Voir App_CloudRun pour les domaines personnalisés, Cloud CDN et les détails des IP statiques.

H. Cloud Logging et Monitoring​

Les sorties stdout/stderr des instances Cloud Run sont acheminées vers Cloud Logging ; les métriques de requêtes et les métriques Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des règles d'alerte facultatifs sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read \
    'resource.type="cloud_run_revision" AND resource.labels.service_name="<service-name>"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application Moodle​

  • Configuration de la base de données au premier déploiement. Deux jobs d'initialisation s'exécutent avant que le service Cloud Run ne devienne actif. Le job db-init crée la base de données et l'utilisateur Moodle, active l'extension pg_trgm et accorde les privilèges (idempotent, peut être réexécuté en toute sécurité). Le job nfs-init crée les sous-répertoires Moodle requis (filedir, temp, cache, localcache) sur le partage NFS et définit la propriété www-data.
  • Planification cron automatique. Un job Cloud Scheduler se déclenche toutes les minutes en ciblant /admin/cron.php?password=<MOODLE_CRON_PASSWORD>. Cela pilote toutes les tâches planifiées de Moodle : sauvegardes de cours, notifications par e-mail, traitement des badges et achèvements d'activités. Le job est toujours créé et ne peut pas être désactivé.
  • Chemin de santé. Les sondes de démarrage et de vivacité utilisent HTTP /health.php, qui renvoie HTTP 200 lorsque PHP est opérationnel. La sonde de démarrage autorise jusqu'à 10 minutes (failure_threshold = 20, period_seconds = 30) pour la création du schéma au premier démarrage et l'enregistrement des plugins.
  • E-mail sortant SMTP. Les paramètres SMTP sont injectés en tant que variables d'environnement. Remplacez les valeurs par défaut à l'aide de environment_variables (voir Groupe 6). Le mot de passe SMTP est généré automatiquement et stocké dans Secret Manager ; mettez à jour le secret avec votre véritable identifiant après le déploiement.
  • Résolution wwwroot. Le config.php de Moodle résout wwwroot à partir de la variable d'environnement APP_URL, en revenant à CLOUDRUN_SERVICE_URL. Lorsque application_domains est défini, MOODLE_REVERSE_PROXY et ENABLE_REVERSE_PROXY sont automatiquement définis sur "true" / "TRUE" afin que Moodle génère des URL HTTPS correctes derrière l'équilibreur de charge.
  • Mise à l'échelle à zéro. min_instance_count = 0 est la valeur par défaut ; la première requête après l'inactivité démarrera à froid le conteneur PHP/Apache. Définissez min_instance_count = 1 en production pour éliminer la latence de démarrage à froid pour les étudiants.
  • Connexion administrateur. Le nom d'utilisateur et l'e-mail de l'administrateur initial sont configurables via environment_variables. Le mot de passe administrateur est défini lors de la première installation de Moodle via admin/cli/install_database.php.

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 Moodle sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement et ses valeurs par défaut standards.

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 pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namemoodleNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameMoodle LMSNom convivial affiché dans la console.
descriptionMoodle LMS - Online learning and course management platformAnnotation de description du service.
application_version4.5.1Tag de version de l'image conteneur ; incrémenter pour déployer une nouvelle version.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance. Augmenter à 2000m pour la production avec des étudiants simultanés.
memory_limit2GiMémoire par instance ; 2 GiB offrent une marge pour PHP avec OPcache.
cpu_always_allocatedfalseValeur par défaut de démarrage à froid axée sur les coûts (facturation basée sur les requêtes, associée à min_instance_count = 0). Le cron Moodle intégré au conteneur s'arrête, mais Moodle prend officiellement en charge le cron externe — Cloud Scheduler pilote admin/cli/cron.php pendant que le service se met à l'échelle à zéro, il n'y a donc pas de perte de fonctionnalité. Définir true avec min_instance_count >= 1 pour restaurer un fonctionnement continu toujours actif.
min_instance_count0Instances actives minimales. Définir sur 1 pour éliminer la latence de démarrage à froid.
max_instance_count3Nombre maximal d'instances concurrentes.
container_port8080Moodle/Apache écoute sur le port 8080.
execution_environmentgen2Requis pour les montages de volume NFS.
timeout_seconds300Durée maximale de la requête ; augmenter jusqu'à 3600 pour les téléchargements de fichiers volumineux.
enable_image_mirroringfalseDésactivé — Moodle utilise un Dockerfile personnalisé sans image pré-construite externe.

Groupe 5 — Réseau​

VariableValeur par défautDescription
ingress_settingsall"all" autorise le trafic Internet public. Utiliser "internal-and-cloud-load-balancing" lorsque Cloud Armor est devant.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via le connecteur VPC.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Remplacer les valeurs par défaut SMTP auto-injectées ici (par exemple, MOODLE_SMTP_HOST, MOODLE_ADMIN_EMAIL).
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.

Groupe 7 — Sauvegarde et récupération​

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

Groupe 8 — CI/CD et intégration GitHub​

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.

Groupe 9 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécuter du SQL à partir d'un bucket GCS après le provisionnement. Utilisez ceci pour installer des extensions PostgreSQL supplémentaires ou des données d'amorçage. Voir App_CloudRun.

Groupe 10 — Sécurité, stockage et images​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher un WAF Cloud Armor + équilibreur de charge HTTPS.
application_domains[]Noms de domaine personnalisés ; active également MOODLE_REVERSE_PROXY = "true".
enable_cdnfalseActiver Cloud CDN sur l'équilibreur de charge.
create_cloud_storagetrueProvisionner le bucket de données.
storage_buckets[{ name_suffix = "data" }]Buckets GCS supplémentaires à provisionner.

Groupe 11 — Système de fichiers (NFS) et Cloud Storage​

VariableValeur par défautDescription
enable_nfstrueVolume Filestore partagé pour Moodle moodledata (garder activé — requis pour tous les déploiements).
nfs_mount_path/mnt/nfsChemin du conteneur où le partage NFS est monté ; injecté comme MOODLE_DATA_DIR.
gcs_volumes[]Montages de volume GCS Fuse pour les thèmes ou les plugins.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixé à PostgreSQL 15 — ne pas modifier.
db_namemoodleNom de la base de données. Immuable après le premier déploiement.
db_usermoodleUtilisateur de la base de données de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré.
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.

Groupe 13 — Jobs​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser les jobs intégrés db-init et nfs-init.
cron_jobs[]Jobs Cloud Run supplémentaires déclenchés par Cloud Scheduler (le job du planificateur cron Moodle est toujours créé séparément).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /health.php, 20 échecs × 30 sJusqu'à 10 minutes pour que Moodle termine la configuration du premier démarrage.
liveness_probeHTTP /health.php, délai initial de 120 sVérification de santé périodique après le démarrage.
uptime_check_configdésactivé, chemin /Test de disponibilité Cloud Monitoring facultatif.
alert_policies[]Règles d'alerte métrique facultatives.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis pour les sessions PHP et le cache d'application Moodle.
redis_host""Laisser vide pour utiliser l'IP de l'hôte NFS (développement uniquement) ; définir sur une IP Cloud Memorystore pour la production.
redis_port6379Port Redis (type chaîne).
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 organization_id).
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​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent 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 pour atteindre Moodle.
service_locationRégion du service Cloud Run.
stage_servicesURL des révisions de service spécifiques à l'étape (lorsque Cloud Deploy est activé).
load_balancer_ipIP de l'équilibreur de charge externe (lorsque Cloud Armor + domaine personnalisé est activé).
load_balancer_urlURL HTTPS via l'équilibreur de charge.
database_instance_nameNom de l'instance Cloud SQL.
database_nameNom de la base de données de l'application.
database_userUtilisateur 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_portHôte de la base de données (sensible) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
nfs_server_ipIP privée du serveur NFS Filestore (sensible).
nfs_instance_tagsTags réseau GCE sur l'instance NFS.
nfs_mount_pathChemin du conteneur où le partage NFS est monté.
nfs_share_pathChemin d'exportation sur le serveur NFS.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
uptime_check_namesNoms des tests de disponibilité Cloud Monitoring.
initialization_jobs / nfs_setup_jobNoms des jobs de configuration et d'initialisation NFS.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typePOSTGRES_15CritiqueMoodle nécessite PostgreSQL ; MOODLE_DB_TYPE = "pgsql" est codé en dur — tout autre moteur interrompt le démarrage.
enable_nfstrueCritiqueSans stockage NFS partagé, moodledata n'est pas partagé entre les instances et les téléchargements sont perdus au redémarrage.
execution_environmentgen2 (par défaut)CritiqueLes montages de volume NFS ne sont pas pris en charge dans la gen1 ; le service ne démarrera pas avec NFS activé.
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_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
enable_redistrueÉlevéSans magasin de sessions partagé, les utilisateurs sur les déploiements multi-instances sont déconnectés à chaque nouvelle instance.
redis_host"" (NFS) ou expliciteÉlevéPas de point de terminaison valide si Redis est activé mais NFS est désactivé et aucun hôte n'est défini.
memory_limit2GiÉlevéTrop peu de mémoire provoque des OOM PHP lors des importations de cours ou des téléchargements de fichiers volumineux.
min_instance_count / cpu_always_allocated1 / true pour la productionÉlevéLes deux par défaut 0 / false (démarrage à froid axé sur les coûts) : le service se met à l'échelle à zéro et le CPU est facturé uniquement par requête. 0 provoque des retards de démarrage à froid lors de la première requête après l'inactivité, y compris l'accès par minute de Cloud Scheduler à admin/cli/cron.php — Moodle prend officiellement en charge ce modèle de cron externe, de sorte que les tâches planifiées s'exécutent toujours correctement (pas de perte de fonctionnalité), juste avec une latence supplémentaire occasionnelle. Définir les deux sur 1 / true pour éliminer les démarrages à froid et restaurer un fonctionnement continu.
nfs_mount_path/mnt/nfsÉlevéDoit correspondre à MOODLE_DATA_DIR ; la modification après le premier déploiement déplace la racine des données et interrompt l'installation.
application_domains + MOODLE_REVERSE_PROXYdéfinis ensembleÉlevéSans les flags de proxy inverse, Moodle génère des URL HTTP derrière un équilibreur de charge HTTPS, ce qui rompt les liens et les connexions.
enable_cloud_armor / enable_iapactiver pour l'interface administrateurMoyenL'interface utilisateur administrateur est autrement accessible publiquement.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
max_revisions_to_retain7FaibleLes révisions conservées illimitées peuvent s'accumuler avec le temps.

Pour le comportement du socle référencé tout au long — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et cycle de vie des images — voir App_CloudRun. La configuration partagée spécifique à Moodle est décrite dans Moodle_Common.

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