Aller au contenu principal

Directus sur Cloud Run

Directus sur Cloud Run

Directus est une plateforme open source de CMS headless et de Backend-as-a-Service (BaaS) qui enveloppe toute base de données SQL avec des API REST et GraphQL auto-générées et une application d'administration sans code. Ce module déploie Directus sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Directus 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 à chaque application Cloud Run — 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 du socle App_CloudRun plutôt que de les répéter ici.


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

Le module Cloud Run de Directus sur RAD coûte environ 82,03 $ US par mois sans licence d'hébergement séparée. Cela se compare à 499 $ US par mois (facturé annuellement) ou 599 $ US par mois (facturé mensuellement) pour le plan Team hébergé de Directus Cloud. Un serveur auto-géré est moins cher en espèces, mais vous gérez alors vous-même la base de données, les sauvegardes, les correctifs de sécurité et les mises à niveau. GKE Autopilot convient aux instances Directus qui doivent rester actives en permanence ou s'adapter à plusieurs pods ; pour le coût le plus bas, ce module Cloud Run vous offre déjà l'option la moins chère — consultez le guide GKE si vous avez besoin de l'autre option. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour des études, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les 82,03 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11 $ US au prix de la recharge)99 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 82,03 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 $ US au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve

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

10 crédits coûtent 1 $ US lors d'une recharge ponctuelle, et moins avec un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas de deuxième base de données.

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

Ressource (par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 Gio (scaleToZero)11,58 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 82,03 $ US

Comparaison​

OptionPar moisQui l'exécute
Directus Cloud, plan Team499 $ US (annuel) – 599 $ US (mensuel)Directus
RAD, Cloud Run, votre propre projetEnviron 82,03 $ USAutomatisation de RAD, dans votre projet
RAD, Cloud Run, un projet géré par RADEnviron 96 $ USRAD
  • Le plan Team de Directus Cloud est tarifé par projet, et non par utilisateur, et commence à plusieurs fois le coût du projet propre à RAD pour le même Directus Core open source — le niveau Core gratuit de Directus est auto-hébergé, ce que RAD automatise pour vous.
  • Un serveur bon marché est bon marché jusqu'à ce que quelque chose tombe en panne : la base de données de RAD est Cloud SQL avec des sauvegardes quotidiennes et une récupération à un instant précis, et les secrets résident dans Secret Manager. Sur votre propre serveur, ou un VPS nu, chacune de ces tâches est un travail que vous faites vous-même.

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

Si Directus s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Directus dont vous n'avez besoin qu'occasionnellement — pour des études, une démo, une activité saisonnière — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, la VM NFS ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 201 $ US par mois pour le maintenir en fonctionnement. Déployez Directus, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et les heures pendant lesquelles Directus a été réellement actif.
  • Ce que cela nécessite. Vous devez posséder le projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démo). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : les sauvegardes nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé les données et que vous souhaitez les conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 $ US), et environ une heure, car RAD recrée le projet et les services partagés avant Directus. La suppression permet d'économiser de l'argent une fois que Directus resterait inutilisé pendant environ 4 jours ou plus dans votre propre projet (environ 2,73 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (67 crédits par jour).
  • Supprimez tout ce que Directus utilise. La majeure partie du coût de fonctionnement est la base de données et la VM NFS/cache. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc les supprimer alors que quelque chose d'autre partage le projet n'économise que la partie calcul de Directus.
  • Conservez d'abord vos données. Les sauvegardes nocturnes de la base de données sont écrites dans un bucket à l'intérieur du déploiement, et ce bucket est supprimé avec lui. Avant de supprimer, copiez la dernière sauvegarde sur Google Drive, ou dans un bucket que vous conservez.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez les paramètres à nouveau lorsque vous déployez.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose de Directus 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 retournent au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute Directus pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

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

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimations de crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes et la fenêtre de pause/restauration. Tarification Directus Cloud pour les chiffres du plan Team ;

1. Vue d'ensemble​

Directus s'exécute en tant que conteneur Node.js sur Cloud Run entièrement géré. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Sans serveur, s'adapte automatiquement à zéro entre les requêtes
Base de donnéesCloud SQL pour PostgreSQL 15Requis — Directus code en dur DB_CLIENT = "pg"
Fichiers partagésFilestore (NFS)Actifs et médias téléchargés partagés entre toutes les instances
Stockage d'objetsCloud StorageUn bucket de téléchargement dédié ; GCS est le pilote de stockage Directus par défaut
CacheRedisActivé par défaut ; utilise l'IP de l'hôte NFS par défaut si aucun hôte explicite n'est défini
SecretsSecret ManagerKEY, SECRET, ADMIN_PASSWORD et URL de connexion REDIS auto-générés
IngressCloud Load BalancingHTTPS via NEG sans serveur + domaine personnalisé facultatif et certificat géré

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

  • PostgreSQL 15 est requis. Directus code en dur DB_CLIENT = "pg". Le passage à MySQL ou NONE empêche le démarrage.
  • GCS est le pilote de stockage de fichiers par défaut. Directus_Common injecte automatiquement STORAGE_GCS_DRIVER, STORAGE_GCS_BUCKET et STORAGE_LOCATIONS = "gcs", de sorte que tous les téléchargements vont vers le bucket Cloud Storage dédié.
  • L'auto-migration et le bootstrap s'exécutent à chaque démarrage. AUTO_MIGRATE = "true" applique toutes les migrations de schéma de base de données en attente au démarrage. BOOTSTRAP = "true" initialise l'utilisateur admin et les collections système au premier démarrage — les deux sont idempotents.
  • La mise à l'échelle à zéro est la valeur par défaut (min_instance_count = 0). Directus utilise des sessions basées sur Redis, de sorte que les démarrages à froid sont acceptables pour les déploiements non critiques en termes de latence. Définissez min_instance_count = 1 pour éliminer les démarrages à froid en production.
  • La KEY et le SECRET de Directus sont générés automatiquement et stockés dans Secret Manager. Leur rotation après le premier déploiement invalide toutes les sessions actives et les JWT.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT, REGION et SERVICE_NAME sont définis. Le nom du service et les autres identifiants sont signalés dans les Sorties du déploiement.

A. Service Cloud Run — la charge de travail Directus​

Directus s'exécute en tant que service Cloud Run unique. Chaque nouveau déploiement crée une nouvelle révision ; la gestion du trafic contrôle quelle révision reçoit le trafic.

  • Console : Cloud Run → sélectionnez le service pour voir les révisions, les répartitions de trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe "$SERVICE_NAME" --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service "$SERVICE_NAME" --project "$PROJECT" --region "$REGION"
    # Stream live logs:
    gcloud run services logs tail "$SERVICE_NAME" --project "$PROJECT" --region "$REGION"
    # Verify the health endpoint manually:
    curl -sf "$(gcloud run services describe "$SERVICE_NAME" --project "$PROJECT" --region "$REGION" --format='value(status.url)')/server/ping"

Voir App_CloudRun pour l'autoscaling, la concurrence, les environnements d'exécution et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

Directus stocke toutes les données de l'application dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les instances se connectent par défaut via TCP (connecteur Cloud SQL, pas de socket Unix par défaut sur Cloud Run). Un job db-init s'exécute à chaque apply (idempotent) et crée la base de données de l'application, l'utilisateur, accorde les privilèges et installe l'extension uuid-ossp.

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

Les actifs téléchargés sont écrits sur un partage Filestore (NFS) monté sur chaque instance afin que tous les réplicas voient les mêmes fichiers. Un bucket de téléchargement Cloud Storage dédié est également provisionné ; Directus est configuré pour utiliser GCS comme pilote de stockage principal via STORAGE_GCS_DRIVER = "gcs".

  • Console : Filestore → Instances pour le partage NFS ; Cloud Storage → Buckets pour le bucket de téléchargement.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<uploads-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 mise en cache des réponses API et l'état de limitation de débit de Directus. Lorsqu'aucun hôte Redis explicite n'est configuré et que NFS est activé, l'IP de l'hôte NFS est utilisée comme point de terminaison Redis par défaut. L'URL de connexion Redis complète (y compris tout mot de passe d'authentification) est stockée en tant que secret Secret Manager et injectée en tant que variable d'environnement REDIS.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    # Confirm REDIS is injected into the Cloud Run service environment:
    gcloud run services describe "$SERVICE_NAME" --project "$PROJECT" --region "$REGION" \
    --format='yaml(spec.template.spec.containers[0].env)'

E. Secret Manager​

Quatre secrets sont générés et stockés automatiquement : KEY (chiffrement des données), SECRET (signature JWT), ADMIN_PASSWORD (compte administrateur initial) et REDIS (URL de connexion Redis lorsque Redis est activé). Le mot de passe de la base de données est géré séparément par le socle.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    # Retrieve the admin password:
    gcloud secrets versions access latest --secret=<prefix>-admin-password --project "$PROJECT"
    # Retrieve the DB password:
    gcloud secrets versions access latest --secret=<database_password_secret> --project "$PROJECT"

Le nom database_password_secret se trouve dans les Sorties. Voir App_CloudRun pour le modèle d'injection de secrets.

F. Réseau et ingress​

Le service Cloud Run est précédé d'un groupe de points de terminaison réseau sans serveur attaché à un équilibreur de charge Cloud global. HTTPS est géré automatiquement. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée.

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

Voir App_CloudRun pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

G. Cloud Logging et Monitoring​

Les sorties stdout/stderr des conteneurs sont acheminées vers Cloud Logging. Les métriques Cloud Run et les tests de disponibilité facultatifs sont acheminés vers Cloud Monitoring.

  • Console : Logging → Explorateur de logs ; 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 Directus​

  • Configuration de la base de données au premier déploiement. Un job db-init s'exécute à chaque apply (execute_on_apply = true). Il crée l'utilisateur de la base de données Directus avec le mot de passe généré, crée la base de données directus, installe l'extension uuid-ossp et accorde tous les privilèges. Le job est idempotent.
  • Bootstrap au premier démarrage. BOOTSTRAP = "true" initialise l'utilisateur administrateur initial et les collections système Directus au premier démarrage. L'e-mail de l'administrateur est par défaut admin@example.com — remplacez-le via environment_variables = { ADMIN_EMAIL = "you@example.com" } avant le premier déploiement.
  • Migrations à chaque démarrage. AUTO_MIGRATE = "true" fait en sorte que Directus exécute database migrate:latest à chaque démarrage d'instance, de sorte que la mise à niveau application_version applique automatiquement les modifications de schéma.
  • Sonde de santé. La sonde de démarrage cible /server/ping avec un délai initial de 30 secondes et un seuil d'échec généreux (failure_threshold = 10, period_seconds = 20) pour tenir compte de la configuration de la base de données au premier démarrage. La sonde de vivacité cible également /server/ping.
  • Connexions de base de données TCP par défaut. Contrairement à la variante GKE (qui utilise un socket Unix via le sidecar Auth Proxy), la variante Cloud Run se connecte à Cloud SQL via TCP en utilisant le connecteur Cloud SQL (enable_cloudsql_volume = false par défaut). Le trafic sortant ne transite que vers des IP privées (vpc_egress_setting = "PRIVATE_RANGES_ONLY").
  • Rotation de KEY et SECRET. La rotation du secret KEY invalide immédiatement toutes les sessions utilisateur actives. La rotation de SECRET invalide tous les JWT émis. Ne faites jamais pivoter l'un ou l'autre sans une fenêtre de maintenance planifiée et une notification client.
  • Connexion administrateur. Récupérez le mot de passe administrateur généré à partir de Secret Manager (voir §2.E). L'e-mail administrateur par défaut est admin@example.com sauf s'il est remplacé.

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

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service Cloud Run 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. Ne pas modifier après le premier déploiement.
support_users[]E-mails autorisés à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriété.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namedirectusNom de base des ressources. Ne pas modifier après le premier déploiement — intégré dans les ID de secrets Secret Manager.
display_nameDirectus CMSNom convivial affiché dans la console.
application_version11.1.0Tag de version de l'image Directus ; incrémenter pour déployer une nouvelle version. Épingler à un tag spécifique — éviter latest en production.
descriptionDirectus - Open Source Headless CMS and Backend-as-a-ServiceAnnotation de description du service.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure (Cloud SQL, stockage, secrets) sans déployer le service Cloud Run.
cpu_limit1000mvCPU par instance ; 1 vCPU convient aux charges de travail légères.
memory_limit1GiMémoire par instance ; par défaut 1 Gio pour une utilisation légère/typique (observé ~150 Mio) — augmenter à 2 Gio pour la production ou les grands schémas/transformations d'images.
cpu_always_allocatedfalseFacturation basée sur les requêtes — sûr pour le mode requête/réponse par défaut de Directus. Définir true uniquement si vous activez les abonnements en temps réel/WebSocket ou les flux planifiés qui doivent s'exécuter sans requête entrante.
min_instance_count0Instances minimales. Définir 1 pour éliminer les démarrages à froid en production.
max_instance_count1Plafond de concurrence maximal. Augmenter pour le trafic de production.
container_port8055Port d'écoute par défaut de Directus.
execution_environmentgen2Environnement d'exécution Cloud Run de deuxième génération (recommandé).
enable_cloudsql_volumefalseConnexion TCP par défaut ; définir true pour activer le socket Unix via le sidecar Auth Proxy.

Groupe 5 — Ingress et IAP​

VariableValeur par défautDescription
ingress_settingsall"all" (public) ou "internal-and-cloud-load-balancing" (privé).
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic de plage privée via le connecteur VPC.
enable_iapfalseExiger la connexion Google devant Directus.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder lorsque IAP est activé.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables(valeurs par défaut SMTP)Paramètres supplémentaires non secrets. La valeur par défaut inclut des variables d'espace réservé SMTP. Remplacez ADMIN_EMAIL ici avant le premier déploiement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

Groupe 7 — 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_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement. Définir enable_backup_import = false immédiatement après une restauration réussie.

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 et NFS​

VariableValeur par défautDescription
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_pathexécuter SQL depuis GCSVoir App_CloudRun.
nfs_instance_name / nfs_instance_base_nameréférences à l'instance Filestore partagéeDéfinir lorsque l'instance Filestore n'a pas été créée par le même déploiement Services_GCP.

Groupe 10 — Cloud Armor, domaines et CDN​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor (WAF) au backend de l'équilibreur de charge.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
application_domains[]Noms d'hôtes personnalisés — activer pour la production avec un vrai nom DNS.
enable_cdnfalseActiver Cloud CDN via l'équilibreur de charge.

Groupe 11 — Cloud Storage et NFS​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner des buckets supplémentaires au-delà du bucket de téléchargement auto-provisionné.
storage_buckets[{ name_suffix = "data", location = "" }]Buckets GCS supplémentaires, en plus du bucket de téléchargement auto-provisionné de Directus_Common.
enable_nfstrueVolume Filestore partagé pour les actifs téléchargés (garder activé pour les instances multiples).
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
gcs_volumes[]Buckets GCS à monter via le pilote CSI GCS Fuse.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Directus nécessite PostgreSQL. Ne pas modifier.
db_namedirectusNom de la base de données PostgreSQL. Ne pas modifier après le premier déploiement.
db_userdirectusUtilisateur de l'application. Ne pas modifier après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré fourni par Directus_Common.
cron_jobs[]Jobs Cloud Run récurrents (par exemple, purge du cache, synchronisation des données).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe/server/ping, HTTP, délai de 30s, failure_threshold=10, période=20sSonde de démarrage Cloud Run. Permet jusqu'à ~230 s pour les migrations au premier démarrage.
liveness_probe/server/ping, HTTP, délai de 15sInstance redémarrée après 3 échecs consécutifs.
uptime_check_configdésactivé par défaut, chemin /Test de disponibilité Cloud Monitoring facultatif.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis pour la mise en cache et la limitation de débit.
redis_host""Laisser vide pour utiliser l'IP de l'hôte NFS ; définir explicitement pour une instance Memorystore dédiée.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible). L'URL de connexion complète est stockée dans Secret Manager.

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). Utiliser vpc_sc_dry_run = true en premier.
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 localocaliser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlL'URL HTTPS publique pour atteindre Directus.
service_locationRégion où le service est déployé.
stage_servicesURL de service par étape Cloud Deploy (lorsque le déploiement multi-étapes est activé).
load_balancer_ipIP externe du frontend de l'équilibreur de charge.
load_balancer_urlURL HTTPS via l'équilibreur de charge (lorsqu'un domaine personnalisé ou une IP statique est utilisé).
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_hostHôte de la base de données (sensible — renvoyé comme (sensitive) dans la sortie du plan).
database_portPort de la base de données.
storage_bucketsBuckets Cloud Storage créés.
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 / uptime_check_namesÉtat de la surveillance, canaux et tests de disponibilité.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD.
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15CritiqueDirectus nécessite PostgreSQL ; passer à MySQL ou NONE empêche le démarrage et orpheline la base de données existante.
application_namedéfini une foisCritiqueIntégré dans les ID de secrets Secret Manager (KEY, SECRET, ADMIN_PASSWORD). Le modifier recrée tous les secrets — toutes les sessions actives et les JWT sont immédiatement invalidés.
tenant_iddéfini une foisCritiqueLe modifier après le premier déploiement orpheline l'instance Cloud SQL et génère une nouvelle base de données vide ainsi que de nouvelles KEY/SECRET, invalidant toutes les sessions.
KEY / SECRET secretsauto-générés, ne jamais les faire pivoter sans raisonCritiqueFaire pivoter KEY déconnecte tous les utilisateurs. Faire pivoter SECRET invalide tous les jetons d'API. Ne faire pivoter que pendant une fenêtre de maintenance planifiée.
ADMIN_EMAIL variable d'environnementune vraie adresse e-mailÉlevéLa valeur par défaut admin@example.com crée le compte administrateur avec un e-mail facile à deviner. À remplacer via environment_variables = { ADMIN_EMAIL = "you@example.com" } avant le premier déploiement.
enable_nfstrueÉlevéSans NFS partagé, les ressources téléchargées écrites par une instance sont invisibles pour les autres et perdues lors de la réduction d'échelle (sauf si GCS est utilisé exclusivement).
enable_redistrue pour multi-instanceÉlevéSans Redis, chaque instance a un cache isolé ; la limitation de débit est par instance et le cache Directus ne fonctionne pas correctement entre les réplicas.
redis_host"" (NFS) ou expliciteÉlevéPas de point de terminaison Redis valide si Redis est activé, NFS est désactivé et aucun hôte n'est défini.
startup_probe.failure_threshold10 lors du premier déploiementÉlevéTrop faible : les migrations Directus peuvent prendre 1 à 3 minutes sur une base de données vierge ; l'instance est tuée avant la fin des migrations.
enable_backup_importfalse après restaurationÉlevéLaisser true relance l'importation à chaque apply, écrasant les données en direct avec la sauvegarde obsolète.
memory_limit2GiÉlevéTrop peu de mémoire provoque des arrêts OOM (Out Of Memory) lors du chargement du schéma ou de la transformation d'images.
min_instance_count1 pour la productionMoyen0 en production provoque des démarrages à froid de 20 à 40 secondes lors de la première requête API après une période d'inactivité.
max_instance_countadapter au traficMoyen1 bloque la mise à l'échelle horizontale et provoque la mise en file d'attente des requêtes sous charge.
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é.
enable_vpc_sc + vpc_sc_dry_runcommencer avec vpc_sc_dry_run = trueCritiqueL'activation de l'application sans le compte de service dans le niveau d'accès bloque simultanément Cloud SQL, Secret Manager et Artifact Registry.

Pour le comportement du socle 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 d'images — voir App_CloudRun. La configuration d'application spécifique à Directus partagée avec la variante GKE est décrite dans Directus_Common.

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