Aller au contenu principal

MongoDB sur GKE Autopilot

MongoDB sur GKE Autopilot

MongoDB est la base de données de documents NoSQL la plus populaire au monde, utilisée par des organisations de toutes tailles pour la gestion de contenu, les pipelines de données IoT, les backends mobiles et les magasins de fonctionnalités IA/ML où les schémas relationnels sont trop rigides. Ce module déploie MongoDB sur GKE Autopilot sur la base 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 MongoDB 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 base App_GKE plutôt que de les répéter ici.


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

L'exécution de MongoDB dans votre propre projet GCP coûte environ 96,70 $/mois en frais Google Cloud ; les frais de module de RAD sont de 75 crédits uniques (ou 67,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 mesure à l'heure en crédits dans un projet géré par RAD. 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 module75 crédits, une fois67,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 à la minute pour le temps de buildIdem
Coût d'exécution Google Cloud~96,70 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~106 crédits/jour, mesurés à l'heure par RAD au prix catalogue plus marge

Pourquoi les deux colonnes diffèrent. Le chiffre du projet géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la base partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

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)
Pod GKE Autopilot, 1x vCPU / 2 Gio39,68 $
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total96,70 $

Comment cela se compare​

  • Le service géré de MongoDB, Atlas, a un niveau partagé M0 gratuit et son niveau dédié le moins cher (M10, 2 vCPU/2 Go) coûte environ 57 $/mois (source : https://www.mongodb.com/pricing), géré par le projet lui-même sans infrastructure à exploiter — la comparaison qui importe ici est moins le prix affiché que de savoir si vous voulez le cloud du fournisseur ou votre propre projet GCP avec RAD le gérant.
  • L'exécuter vous-même sur un VPS nu reste l'option la moins chère en espèces — Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go est également 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) est 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 — mais le prix de RAD n'est jamais destiné à battre un VPS, seulement à remplacer le temps d'administration qu'un VPS nécessite encore.
  • Dans tous les cas, il s'agit de la couche de base de données de documents d'une application, 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 délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, 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 de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce qu'il faut : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que 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 à 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 la 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 MongoDB purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 75 crédits.

La suppression ne permet d'économiser de l'argent que si MongoDB 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 2 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données ; elle ne s'arrête que si rien d'autre dans le projet ne l'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 d'abord : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits 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, afin que personne ne reçoive de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

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

1. Vue d'ensemble​

MongoDB s'exécute en tant que StatefulSet sur GKE Autopilot. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE Autopilot (StatefulSet)1 vCPU / 2 Gio par défaut, mode nœud unique
Stockage persistantPersistent Disk (SSD PVC)standard-rwo StorageClass, 20 Gio par défaut, monté à /data/db
SecretsSecret ManagerMot de passe root MongoDB auto-généré
Images de conteneursArtifact RegistryImage officielle mongo mise en miroir dans le registre du projet
RéseauVPC / GKE ServiceClusterIP par défaut pour l'accès interne au cluster ; passer à LoadBalancer uniquement si un accès externe au protocole filaire brut est requis

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

  • Pas de Cloud SQL. MongoDB est son propre moteur de base de données ; Cloud SQL n'est pas provisionné et enable_cloudsql_volume est codé en dur à false.
  • Le PVC basé sur SSD est essentiel. Sans PVC StatefulSet, toutes les données sont perdues à chaque redémarrage de pod. stateful_pvc_enabled = true sélectionne automatiquement un StatefulSet.
  • Mode nœud unique uniquement. min_instance_count et max_instance_count sont tous deux fixés à 1. Les ensembles de répliques MongoDB nécessitent une clé d'authentification supplémentaire et une configuration rs.initiate() qui dépassent le cadre de ce module.
  • Le mot de passe root est auto-généré. MONGO_INITDB_ROOT_PASSWORD est généré et stocké dans Secret Manager lors du premier déploiement ; vous ne le définissez jamais en texte clair.
  • Sondes TCP sur le port 27017. MongoDB utilise son propre protocole filaire binaire, pas HTTP — les sondes HTTP échouent toujours.
  • fsGroup 999 est codé en dur. L'image officielle de MongoDB exécute mongod en tant que UID/GID 999 ; Kubernetes change automatiquement le propriétaire du montage PVC à ce GID.

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

A. GKE Autopilot — le StatefulSet MongoDB​

MongoDB s'exécute en tant que StatefulSet à pod unique sur Autopilot, qui provisionne les nœuds à la demande et facture le CPU et la mémoire que le pod demande réellement. Autopilot doit provisionner un nœud, attacher le PVC et extraire l'image avant que mongod ne démarre — la sonde de démarrage permet jusqu'à ~8 minutes pour s'adapter à cela.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez le StatefulSet MongoDB pour l'état du pod, les événements et l'utilisation des ressources. Kubernetes Engine → Services et Ingress affiche l'IP ClusterIP ou l'IP externe du LoadBalancer.
  • CLI :
    kubectl get statefulset,pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<statefulset-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" <pod-name> # events and probe status

Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail StatefulSet sont gérés.

B. Persistent Disk — PVC SSD​

Les données MongoDB résident sur un PVC SSD Persistent Disk (StorageClass standard-rwo) monté à /data/db à l'intérieur du conteneur. Le PVC est provisionné automatiquement par GKE lors de la création du StatefulSet et persiste indépendamment des redémarrages de pod, des mises à jour continues et des évictions de nœuds.

  • Console : Kubernetes Engine → Stockage → PersistentVolumeClaims pour voir le PVC et son volume lié. Compute Engine → Disques pour voir le Persistent Disk sous-jacent.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    kubectl describe pvc -n "$NAMESPACE" <pvc-name> # capacity, access mode, status
    # Check disk usage inside the running pod:
    kubectl exec -n "$NAMESPACE" <pod-name> -- df -h /data/db

La taille du PVC est définie au moment du déploiement par stateful_pvc_size (par défaut 20Gi). La taille du PVC ne peut pas être diminuée après la création. Provisionnez au moins 2 à 3 fois le volume de données initial attendu pour éviter le crash No space left on device.

C. Secret Manager — mot de passe root​

Le mot de passe root de MongoDB (MONGO_INITDB_ROOT_PASSWORD) est auto-généré lors du premier déploiement et stocké en tant que secret Secret Manager. Il est injecté dans le pod via le pilote CSI du Secret Store et n'apparaît jamais en texte clair.

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

Pour récupérer le mot de passe root pour une connexion mongosh :

ROOT_PASS=$(gcloud secrets versions access latest \
--secret=<resource-prefix>-mongo-root-password --project "$PROJECT")
kubectl exec -n "$NAMESPACE" <pod-name> -- \
mongosh --username admin --password "$ROOT_PASS" --authenticationDatabase admin

Voir App_GKE pour l'intégration et la rotation du Secret Store CSI.

D. Artifact Registry — image de conteneur​

L'image officielle mongo est mise en miroir dans l'Artifact Registry du projet avant le déploiement afin que les pods ne tirent jamais directement de Docker Hub. L'URI de l'image mise en miroir est signalé dans la sortie container_image.

  • Console : Artifact Registry → sélectionnez le dépôt.
  • CLI :
    gcloud artifacts docker images list \
    <region>-docker.pkg.dev/$PROJECT/<registry-repo> --project "$PROJECT"

E. Réseau et ingress​

Par défaut, le service Kubernetes MongoDB est ClusterIP — MongoDB est un backend de base de données destiné à être consommé par d'autres charges de travail au sein du cluster (par exemple, RocketChat), et ClusterIP fournit déjà un accès inter-espaces de noms au sein du cluster via DNS, donc aucun LoadBalancer n'est nécessaire. Passez à LoadBalancer uniquement si un accès externe au protocole filaire MongoDB brut (port 27017) est réellement requis.

  • Console : Kubernetes Engine → Services et Ingress ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc -n "$NAMESPACE"
    # Get the LoadBalancer external IP:
    kubectl get svc -n "$NAMESPACE" <service-name> \
    -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

La sortie mongodb_endpoint fournit l'URI de connexion prête à l'emploi (mongodb://<ip>:27017 pour LoadBalancer ou l'URI DNS intra-cluster pour ClusterIP).

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

F. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods (y compris les journaux de démarrage et de requête mongod) sont acheminées vers Cloud Logging. Les métriques GKE et Persistent Disk sont acheminées vers Cloud Monitoring.

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

  • Mode autonome uniquement. Ce module déploie une seule instance mongod. Les ensembles de répliques MongoDB (flux de modifications, transactions, réplication d'oplog) nécessitent des fichiers de clé d'authentification et une configuration rs.initiate() qui dépassent le cadre de ce module. max_instance_count est forcé à 1.
  • Initialisation au premier démarrage. Lors du tout premier démarrage avec un PVC vierge, MongoDB crée l'utilisateur root (MONGO_INITDB_ROOT_USERNAME, par défaut admin) et la base de données initiale (MONGO_INITDB_DATABASE, par défaut admin). Ces valeurs sont immuables après l'écriture du PVC — les modifier après le premier déploiement n'a aucun effet (le script d'initialisation ne s'exécute qu'une seule fois par répertoire de données).
  • Dimensionnement du cache WiredTiger. Le moteur de stockage WiredTiger de MongoDB définit par défaut son cache à environ (memory_limit − 1 GiB) × 0.5. Avec la limite par défaut 2Gi, le cache est d'environ 500 Mio, ce qui est suffisant pour le développement. Mettez à l'échelle le memory_limit à 4Gi–8Gi pour les charges de travail de documents en production.
  • Tolérance de la sonde de démarrage. GKE Autopilot doit provisionner un nœud, attacher le PVC et extraire l'image avant que mongod ne démarre. La sonde de démarrage permet jusqu'à ~8 minutes (failure_threshold = 45, vérification toutes les 10 secondes). Lors des redémarrages de pod ultérieurs sur un nœud chaud, le démarrage est beaucoup plus rapide.
  • Vidage du journal à l'arrêt. termination_grace_period_seconds est défini à 60 secondes (par défaut) afin que Kubernetes attende que mongod vide le journal d'écriture anticipée avant de tuer de force le processus — empêchant la corruption du journal.
  • Chaîne de connexion. Le format correct pour se connecter avec les informations d'identification root est :
    mongodb://<username>:<password>@<host>:<port>/<db>?authSource=admin
    Le paramètre authSource=admin est requis lors de la connexion à des bases de données non-administrateur avec le compte root.
  • Sondes de santé. Les sondes de démarrage et de vivacité utilisent toutes deux type = "TCP" sur le port 27017. MongoDB utilise son propre protocole filaire binaire — les sondes HTTP échouent toujours avec une erreur de protocole.
  • Pas de tâches planifiées. MongoDB ne nécessite pas de tâches cron côté plateforme. Les tâches au niveau de l'application (création d'index, index TTL) sont gérées depuis l'application ou via mongosh.

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 MongoDB 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_namemongodbNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameMongoDBNom convivial affiché dans la console.
application_description(défini)Annotation de description de la charge de travail.
application_version7.0Tag de version de l'image MongoDB ; incrémenter pour déployer une nouvelle version. Les mises à niveau majeures modifient le format sur disque — tester sur une réplique avant de mettre à niveau la production.
mongo_root_usernameadminNom d'utilisateur root (MONGO_INITDB_ROOT_USERNAME). Immuable après la première écriture du PVC.
mongo_initdb_databaseadminBase de données initiale créée au premier démarrage. Immuable après la première écriture du PVC.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par pod. Mettre à l'échelle à 2000m pour les charges de travail à forte agrégation.
memory_limit2GiMémoire par pod. Cache WiredTiger ≈ (limit − 1 GiB) × 0.5 ; mettre à l'échelle à 4Gi–8Gi pour la production.
min_instance_count1Réplicas minimum. Doit être 1 pour le mode nœud unique.
max_instance_count1Réplicas maximum. Forcé à 1 — les ensembles de répliques ne sont pas pris en charge par ce module.
container_port27017Port du protocole filaire MongoDB. Définit à la fois le port du service et le port d'écoute de mongod.
enable_image_mirroringtrueMettre en miroir l'image mongo dans Artifact Registry avant le déploiement.
enable_vertical_pod_autoscalingfalseLaisser Autopilot ajuster automatiquement les demandes de ressources.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. MONGO_INITDB_ROOT_USERNAME et MONGO_INITDB_DATABASE sont injectés automatiquement.
secret_environment_variables{}Références Secret Manager injectées comme variables d'environnement. Fournir MONGO_INITDB_ROOT_PASSWORD ici pour utiliser un mot de passe personnalisé au lieu de celui auto-généré.
secret_propagation_delay30Secondes à attendre après la création du secret du mot de passe root avant le démarrage du pod.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 6 — Backend et cluster GKE​

VariableValeur par défautDescription
service_typeClusterIPClusterIP restreint l'accès à l'intérieur du cluster (suffisant pour les consommateurs intra-cluster via DNS) ; LoadBalancer expose le port 27017 avec une IP externe.
workload_typenullSe résout automatiquement en StatefulSet lorsque stateful_pvc_enabled = true.
session_affinityNoneAucune persistance de session requise pour les connexions au protocole filaire MongoDB.
gke_cluster_name""Nom du cluster GKE ; laisser vide pour la découverte automatique.
namespace_name""Espace de noms Kubernetes ; laisser vide pour la génération automatique.
termination_grace_period_seconds60Période de grâce pour mongod afin de vider le journal avant SIGKILL.
deployment_timeout1800Secondes pendant lesquelles Terraform attend le déploiement du StatefulSet (couvre le provisionnement du nœud + l'attachement du PVC).
enable_network_segmentationfalseCréer des ressources Kubernetes NetworkPolicy pour restreindre l'entrée/sortie.

Groupe 7 — StatefulSet et PVC​

VariableValeur par défautDescription
stateful_pvc_enablednullDéfinir true pour activer le StatefulSet basé sur PVC. Requis pour la durabilité des données.
stateful_pvc_size20GiTaille de stockage. Ne peut pas être diminuée après la création ; provisionner 2 à 3 fois le volume de données attendu.
stateful_pvc_mount_path/data/dbDoit correspondre à --dbpath de MongoDB. Ne pas modifier.
stateful_pvc_storage_classstandard-rwoSSD par défaut de GKE Autopilot. Utiliser premium-rwo pour les charges de travail à haut débit.
stateful_headless_servicenullCréer un service sans tête pour des entrées DNS de pod stables.
stateful_pod_management_policynullOrdre de création des pods OrderedReady ou Parallel.
stateful_update_strategynullRollingUpdate ou OnDelete.
stateful_fs_group0GID fsGroup (note : 999 est codé en dur dans le module pour MongoDB — cette variable n'a aucun effet).

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalseLimiter 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 la 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_available1Nombre minimum de pods disponibles pendant une interruption (pour MongoDB à nœud unique, 1 est la seule valeur sensée).
enable_topology_spreadfalseRépartir les pods sur les zones.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configTCP, délai 20s, failure_threshold 18Entrée de sonde TCP au niveau de la fondation sur le port 27017. La sonde de démarrage réelle du conteneur est codée en dur dans le module à failure_threshold = 45 (~8 minutes) pour couvrir le provisionnement du nœud GKE Autopilot + l'attachement du PVC + le tirage d'image — voir Section 3.
health_check_configTCP, délai 30s, failure_threshold 3Sonde de vivacité TCP sur le port 27017.
uptime_check_configdésactivéTest de disponibilité — désactivé par défaut car MongoDB est un service interne.
alert_policies[]Politiques d'alerte de métriques Cloud Monitoring facultatives.

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

VariableValeur par défautDescription
initialization_jobs[]Jobs Kubernetes exécutés avant le démarrage du pod MongoDB. Non requis pour MongoDB — aucun job d'amorçage de base de données n'est nécessaire.
cron_jobs[]CronJobs planifiés. MongoDB n'a pas de tâches planifiées côté plateforme requises.

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_nfsfalseNFS n'est pas requis pour MongoDB — utilisez plutôt le PVC du StatefulSet.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagefalseMongoDB ne nécessite pas de bucket GCS.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK pour le stockage et le registre.
max_images_to_retain7Images récentes à conserver dans Artifact Registry.

Groupe 17 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée mongodump (UTC). Vérifiez que le job de sauvegarde est actif — une sauvegarde manquée combinée à la suppression du PVC entraîne une perte de données permanente.
backup_retention_days7Rétention ; augmenter à 30–90 pour la production/conformité.

Groupe 19 — Domaine personnalisé et IP statique​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne l'ingress HTTPS de la passerelle (nom d'hôte <ip>.nip.io sans configuration lorsque application_domains est vide) — inhabituel pour un service de base de données non-HTTP ; le trafic mongodb:// réel est servi par le service LoadBalancer L4, pas par cet ingress HTTP(S).
application_domains[]Noms de domaine personnalisés.
reserve_static_iptrueIP externe stable sur les redéploiements.
network_tags["nfsserver"]Tags réseau de nœud/pod pour les règles de pare-feu.

Groupe 20 — Identity-Aware Proxy (IAP)​

IAP n'est pas recommandé pour MongoDB (une base de données, pas une application web). Restreignez plutôt l'accès via service_type = "ClusterIP" ou Kubernetes NetworkPolicy.

VariableValeur par défautDescription
enable_iapfalseNon recommandé pour MongoDB. Utilisez NetworkPolicy ou ClusterIP.

Groupe 21 — Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor au backend Ingress.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.

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_ipsCarte des ClusterIP pour les services spécifiques à l'étape (Cloud Deploy).
service_external_ipIP externe du LoadBalancer (lorsque le type de service est LoadBalancer).
mongodb_endpointURI de connexion MongoDB prêt à l'emploi (mongodb://...). Les déploiements ClusterIP renvoient l'URI DNS intra-cluster ; les déploiements LoadBalancer renvoient l'URI externe.
statefulset_nameNom du StatefulSet.
storage_bucketsBuckets Cloud Storage créés (vides par défaut pour MongoDB).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobsNoms des jobs d'initialisation exécutés.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD.
github_repository_url / github_repository_owner / github_repository_nameDétails du dépôt GitHub.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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 en cas d'erreur
stateful_pvc_enabledtrueCritiqueSans PVC, toutes les données MongoDB sont perdues à chaque redémarrage de pod, mise à jour progressive ou éviction de nœud.
stateful_pvc_mount_path/data/db (par défaut)CritiqueDoit correspondre à --dbpath de MongoDB. Le montage ailleurs entraîne l'écriture de mongod dans la couche éphémère — toutes les données sont perdues au redémarrage.
MONGO_INITDB_ROOT_PASSWORDauto-généré (par défaut)CritiqueMongoDB démarre sans authentification si la variable d'environnement est absente. Tout appelant à l'intérieur du cluster obtient un accès administrateur illimité. Ne jamais le supprimer ou l'effacer.
mongo_root_username / mongo_initdb_databasedéfini une foisCritiqueIntégré au répertoire de données lors de la première initialisation. La modification après l'existence du PVC entraîne un échec au démarrage.
quota_memory_requests / quota_memory_limitsunités binaires (4Gi)CritiqueLes entiers bruts sont lus comme des octets par Kubernetes, bloquant toute planification de pod.
stateful_pvc_size20Gi min, taille pour la charge de travailÉlevéUn disque plein provoque le crash de mongod avec No space left on device. Provisionner 2 à 3 fois le volume de données attendu. La taille ne peut pas être diminuée après la création.
memory_limit4Gi pour la productionÉlevéLe cache WiredTiger représente environ 50 % de (limit − 1 GiB). Un cache insuffisant entraîne des E/S disque excessives et une dégradation sévère des requêtes.
workload_typenull (StatefulSet automatique avec PVC)ÉlevéLa définition explicite de Deployment en même temps que stateful_pvc_enabled = true échoue au moment de la planification. MongoDB autonome nécessite StatefulSet pour une liaison PVC stable.
application_versiontester d'abord les mises à niveau majeuresÉlevéLes mises à niveau de version majeure de MongoDB modifient le format de stockage sur disque. La rétrogradation n'est pas prise en charge. Toujours tester par rapport à une réplique du PVC de production.
backup_scheduleactif et testéÉlevéMongoDB n'a pas de sauvegarde automatique intégrée en dehors du job mongodump de ce module. Une sauvegarde manquée combinée à la suppression du volume persistant lors de la destruction entraîne une perte de données permanente.
service_typeClusterIP pour les services de niveau DB (déjà la valeur par défaut)ÉlevéLoadBalancer expose le port 27017 avec une IP publique. Laissez la valeur par défaut ClusterIP en place, sauf si un accès externe est explicitement requis, et utilisez des règles de pare-feu ou NetworkPolicy si vous le modifiez.
termination_grace_period_seconds60 (par défaut)ÉlevéUne période de grâce trop courte risque une corruption du journal lors de l'arrêt si les écritures en cours n'ont pas été vidées.
cpu_limit2000m pour la productionMoyenLes pipelines d'agrégation et les constructions d'index sont gourmands en CPU. En dessous de 500m, les requêtes complexes se dégradent considérablement.
replica setautonome uniquementÉlevéCe module est à nœud unique. Les flux de modification, les transactions et la réplication oplog nécessitent un ensemble de répliques — utilisez un déploiement basé sur Helm pour les topologies multi-nœuds.
enable_iapfalse (par défaut)FaibleIAP n'est pas applicable aux services de base de données. Utilisez plutôt NetworkPolicy ou ClusterIP pour le contrôle d'accès.

Pour le comportement de base référencé partout — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir des images — voir App_GKE. MongoDB_GKE n'a pas de module Common séparé ; toute la configuration spécifique à MongoDB est autonome dans le module.

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