Aller au contenu principal

Moodle sur GKE Autopilot

Moodle sur GKE Autopilot

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 GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par Moodle et sur la manière 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 GKE — Workload Identity, ingress, autoscaling, 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_GKE plutôt que de les répéter ici.


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

L'exécution de Moodle dans votre propre projet GCP coûte environ 149,81 $/mois en frais Google Cloud ; les frais de module de RAD sont de 175 crédits uniques (ou 157,5 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 facture à l'heure en crédits dans un projet géré par RAD. Si un coût d'exécution inférieur est plus important que la cible de déploiement, consultez le guide Cloud Run pour l'option à moindre coût ; sinon, 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 module175 crédits, une fois157,5 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 pour le temps de build à la minuteIdem
Coût d'exécution Google Cloud~149,81 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~146 crédits/jour, mesuré à l'heure par RAD au prix catalogue plus marge

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

RessourceUS$/mois (prix catalogue Google, us-central1)
Pod GKE Autopilot, 2x vCPU / 4 GiB79,35 $
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 $
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total149,81 $

Comparaison​

  • Il n'existe pas de SaaS géré officiel vérifié pour Moodle à comparer, donc la 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 le 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 dissocier sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, aucune VM ou la ressource de calcul une par une : tout le projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà dissocié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 une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — il s'agit d'une vérification, pas d'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 affirme que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé 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 purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 175 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 ; ils 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.

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

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Moodle fonctionne comme une charge de travail web PHP 8.3/Apache adossée à PostgreSQL. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods PHP 8.3/Apache, 2 vCPU / 4 GiB par défaut, autoscalés horizontalement
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 tous les réplicas ; 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 ; revient à l'IP de l'hôte NFS si aucun hôte Redis n'est donné
SecretsSecret ManagerMot de passe cron, mot de passe SMTP et mot de passe de base de données générés automatiquement
PlanificateurCloud SchedulerTâche cron provisionnée automatiquement (toutes les minutes) contre /admin/cron.php
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré

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é et inscriptible accessible à tous les réplicas. enable_nfs utilise par défaut true.
  • Redis est activé par défaut. Avec plus d'un réplica, un cache partagé est nécessaire pour maintenir la cohérence de la session PHP et de l'état de l'application Moodle entre les pods.
  • L'affinité de session est ClientIP. Moodle s'appuie sur les sessions PHP, donc les requêtes d'un navigateur sont épinglées à un pod.
  • Le domaine personnalisé est activé par défaut (enable_custom_domain = true) afin que wwwroot de Moodle se résolve en une adresse stable plutôt qu'en une IP de pod transitoire.
  • Une tâche Cloud Scheduler est provisionnée automatiquement. Elle 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 vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Moodle​

Les pods Moodle sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. L'autoscaling horizontal des pods dimensionne le déploiement entre le nombre minimum et maximum de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Moodle pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

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. Les pods l'atteignent 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 de l'application 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 indicateurs 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_GKE.

C. Filestore (NFS) et Cloud Storage​

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

  • 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
    # Confirm the NFS share is mounted inside a pod:
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- df -h | grep nfs

Voir App_GKE 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'IP de l'hôte NFS est utilisée comme point de terminaison Redis — ce qui convient pour le développement. Pour la production avec plusieurs réplicas, définissez redis_host sur une 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 la fondation. Les trois sont injectés dans les pods au moment de l'exécution ; le texte en 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_GKE pour l'intégration et la rotation de Secret Store CSI.

F. Cloud Scheduler​

Un job Cloud Scheduler est provisionné automatiquement à chaque déploiement pour piloter la file d'attente des tâches internes 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, la charge de travail est exposée via une IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements. enable_custom_domain utilise par défaut true afin que wwwroot de Moodle soit toujours résolvable en une adresse stable.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

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

H. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read \
    'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application Moodle​

  • Configuration de la base de données lors du premier déploiement. Deux jobs d'initialisation s'exécutent avant le démarrage de l'application. 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é. La disponibilité/vivacité utilise /health.php, qui renvoie HTTP 200 lorsque PHP est opérationnel. La sonde de démarrage autorise jusqu'à 10 minutes 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 5). 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. config.php de Moodle résout wwwroot à partir de la variable d'environnement APP_URL, en revenant à GKE_SERVICE_URL. Les domaines personnalisés nécessitent enable_custom_domain = true (la valeur par défaut) pour produire une URL stable.
  • 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 comme 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_GKE avec son comportement et ses valeurs par défaut standards.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail 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{}Étiquettes appliquées à 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.
application_display_nameMoodle LMSNom convivial affiché dans la console.
application_descriptionMoodle Learning Management System on GKE AutopilotAnnotation de description de la charge de travail.
descriptionMoodle LMS - Online learning and course management platformTransmis à Moodle_Common comme son entrée description ; distinct de application_description ci-dessus.
application_version4.5.1Tag de version de l'image du 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_limit2000mCPU par pod ; 2 vCPU recommandés pour Moodle.
memory_limit4GiMémoire par pod ; 4 GiB recommandés (évite les OOM PHP lors des importations).
min_instance_count0Réplicas minimum. Définir sur 1 pour la production afin de maintenir les tâches planifiées en cours d'exécution.
max_instance_count5Réplicas maximum (plafond de l'autoscaler).
container_port8080Moodle/Apache écoute sur le port 8080.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions de socket Unix.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Remplacez 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.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service est exposé.
session_affinityClientIPRoutage persistant requis pour les sessions PHP Moodle.
workload_typenullSe résout automatiquement en StatefulSet lorsque le stockage par pod est activé.
network_tags['nfsserver']Tags de nœud/pod ; nfsserver est requis pour la connectivité NFS.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enablednullActiver les modèles PVC pour le stockage persistant par pod.
stateful_pvc_size10GiTaille de stockage par PVC.
stateful_pvc_mount_path/dataChemin du conteneur où le PVC est monté.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalsePlafonner les comptes CPU/mémoire/objets de l'espace de noms.
quota_memory_requests / quota_memory_limits""Doit utiliser des unités binaires (4Gi, 8192Mi) — les entiers nus sont lus comme des octets et bloquent toute planification.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau de nœuds.
pdb_min_available1Augmenter min_instance_count au-dessus de 1 si vous avez besoin d'une marge d'éviction.
enable_topology_spreadfalseRépartir les pods entre les zones.

Groupe 10 — 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[]Politiques d'alerte métrique facultatives.

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

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

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

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

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfstrueVolume Filestore partagé pour Moodle moodledata (garder activé — requis pour tous les déploiements).
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur ; injecté comme MOODLE_DATA_DIR.
nfs_volume_namenfs-data-volumeNom de volume Kubernetes pour le montage NFS.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner le bucket de données.
storage_buckets[{ name_suffix = "data" }]Buckets GCS supplémentaires à provisionner.
gcs_volumes[]Montages de volume GCS Fuse pour les thèmes ou les plugins.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 15 — 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 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRESFixé à PostgreSQL — ne pas modifier.
application_database_namegkeappNom de la base de données. Immuable après le premier déploiement.
application_database_usergkeappUtilisateur de l'application. Immuable après le premier déploiement.
db_namemoodleAlias de nom de base de données spécifique à Moodle ; maintenir la cohérence avec application_database_name.
db_usermoodleAlias d'utilisateur spécifique à Moodle ; maintenir la cohérence avec application_database_user.
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 17 — Sauvegarde et maintenance​

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 18 — 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 exécuter des extensions PostgreSQL supplémentaires ou des données d'amorçage. Voir App_GKE.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôtes personnalisés + certificat géré (requis pour un wwwroot Moodle correct).
application_domains[]Noms d'hôtes à servir.
reserve_static_iptrueIP externe stable sur les redéploiements.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google devant Moodle.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder.
iap_oauth_client_id / iap_oauth_client_secret""Requis lorsque l'IAP est activé (sensible).
iap_support_email""Affiché sur l'écran de consentement OAuth.

Groupe 21 — Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor (WAF) au backend Ingress.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
cloud_armor_policy_namedefault-waf-policyNom de la politique.

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 Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsMappage des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Moodle.
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_portPoint de terminaison de la base de données (via le proxy d'authentification) / 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_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.
initialization_jobs / db_import_job / nfs_setup_jobNoms des jobs de configuration et (facultatifs) d'importation/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).
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
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_typePOSTGRESCritiqueMoodle 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 réplicas et les téléchargements sont perdus au redémarrage du pod.
application_database_name / db_namedéfini une fois, maintenir la cohérenceCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données et détruit les données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide échoue le job d'importation.
quota_memory_requests / _limitsunités binairesCritiqueLes entiers nus sont des octets et bloquent toute planification de pod.
enable_redistrueÉlevéAvec >1 réplica, les caches isolés par pod entraînent une incohérence de session PHP.
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_limit4GiÉlevéTrop peu de mémoire provoque des OOM PHP lors des importations de cours ou des téléchargements de fichiers volumineux.
session_affinityClientIPÉlevéSans persistance, les connexions Moodle multi-réplicas perdent l'état de la session.
min_instance_count1 pour la productionÉlevé0 peut laisser le job cron de Cloud Scheduler sans pod à livrer pendant les périodes de mise à l'échelle à zéro.
enable_custom_domaintrue (par défaut)ÉlevéSans URL stable, wwwroot de Moodle se résout en une IP de pod transitoire, rompant les liens absolus et les chemins de fichiers.
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 rompt l'installation.
enable_iap / enable_cloud_armoractiver pour l'interface d'administrationMoyenL'interface utilisateur d'administration est autrement accessible publiquement.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
pdb_min_available vs min_instance_countlaisser une margeMoyen1/1 peut bloquer les mises à niveau de nœuds (un seul pod ne peut pas être évincé).

Pour le comportement de la fondation référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. 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.