Aller au contenu principal

Tandoor sur Google Cloud Run

Tandoor sur Google Cloud Run

Tandoor Recipes est un gestionnaire de recettes et un planificateur de repas auto-hébergé, open source et sous licence AGPL-3.0, avec un backend API REST Python/Django et un frontend Vue 3 intégré. Ce module déploie Tandoor sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Tandoor 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 Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Coût de Tandoor sur RAD et comparaison​

Le module Cloud Run de Tandoor sur RAD coûte environ 68,61 $ US par mois dans un projet Google Cloud que vous possédez, avec les frais de module facturés une seule fois en crédits RAD. Pour le coût d'exécution le plus bas, il reste sur Cloud Run ; GKE Autopilot ne vaut la peine que s'il doit coexister avec d'autres charges de travail Kubernetes — voir le guide GKE pour cette option, à environ 91,31 $ US par mois à la place. Si vous n'avez besoin de Tandoor qu'occasionnellement — pour planifier des repas pour une saison, l'essayer avant de vous engager — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de payer pour qu'il reste inactif. Voir Mettez-le en pause gratuitement, ci-dessous. Les chiffres sont ceux du 8 octobre 2026 ; les sources sont listées à la fin de cette section.

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éploiement40 crédits (4 $ US au prix de la recharge)36 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 d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 68,61 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 61 crédits par jour, soit environ 1 830 par mois (environ 183 $ 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 détenu 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 et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas un deuxième ensemble de ces éléments.

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

Ressource (module par défaut)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
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Total68,61 $ US

Comparaison​

  • Tandoor n'a pas de SaaS commercial hébergé propre — il est distribué uniquement en tant que logiciel open source auto-hébergé, Docker-first, pour les foyers et les petits groupes qui le gèrent eux-mêmes.
  • Une comparaison auto-gérée : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte le même prix de 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — toutes ces machines sont plus puissantes que ce dont Tandoor a besoin (1 vCPU / 1 Gio) ; une instance plus petite avec un vCPU partagé le ferait fonctionner confortablement, plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau que Cloud SQL géré, Secret Manager et la surveillance de RAD couvrent pour vous.
  • La majeure partie du coût d'exécution de RAD dans votre propre projet est l'instance PostgreSQL gérée, et non la puissance de calcul propre à Tandoor — la même base de données dont Tandoor aurait besoin sur un VPS nu, mais non gérée là-bas.

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

Si Tandoor s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL ou la ressource de calcul un par un : 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, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression 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 des recettes et des plans de repas que vous souhaitez conserver, 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.

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

Dans votre propre projet, ou une fois la fenêtre de restauration de 30 jours passée, l'alternative est de supprimer Tandoor purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 40 crédits (4,00 $ US) dans votre propre projet, ou 36 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Tandoor reste inutilisé suffisamment longtemps pour que le coût de ce redéploiement soit inférieur à son propre coût d'exécution quotidien — par rapport au total du projet propre ci-dessus (environ 2,29 $ US par jour), cela représente environ 2 jours ou plus, ou environ 1 jour ou plus dans un projet géré par RAD (61 crédits par jour). La majeure partie du coût d'exécution ici est 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 Tandoor alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

Conservez d'abord les données : 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 la 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 dispose de 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 ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration. Il n'existe pas de SaaS commercial hébergé actuellement vérifié pour Tandoor, donc aucun prix concurrent n'est mentionné.

1. Vue d'ensemble​

Tandoor s'exécute comme un conteneur tout-en-un unique sur Cloud Run v2 — nginx s'exécute à l'intérieur du conteneur et proxyse vers gunicorn via un socket Unix, donc aucun sidecar ou entrée additional_services n'est nécessaire. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur tout-en-un unique (nginx + gunicorn), 1 vCPU / 1 Gio par défaut, autoscaling sans serveur ; mise à l'échelle à zéro prise en charge
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — Tandoor n'a pas de moteur de secours de production pris en charge
Stockage d'objetsCloud StorageUn bucket data dédié provisionné automatiquement et monté à /opt/recipes/mediafiles (images de recettes)
CacheRedis (facultatif)Vraiment facultatif — Django revient au cache en mémoire locale si non défini ; pas de worker Celery/tâche en arrière-plan
SecretsSecret ManagerSECRET_KEY Django auto-générée et mot de passe superutilisateur initial ; mot de passe de la base de données
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est obligatoire. Tandoor_Common corrige database_type = "POSTGRES_15" et DB_ENGINE = django.db.backends.postgresql. Le boot.sh de Tandoor interroge pg_isready avant de continuer — pas de connexion paresseuse — donc la base de données doit être accessible au démarrage du conteneur.
  • Variables d'environnement Postgres discrètes, pas un DSN. Tandoor lit directement POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_HOST / POSTGRES_PORT / POSTGRES_DB. Les valeurs DB_* standard de la plateforme sont aliassées sur ces noms via les variables de la fondation db_*_env_var_name. Aucun encodage d'URL ou point d'entrée personnalisé n'est nécessaire.
  • SECRET_KEY et le mot de passe du superutilisateur sont générés automatiquement et stockés dans Secret Manager. SECRET_KEY ne doit jamais être renouvelé après le premier démarrage sans fenêtre de maintenance — le renouveler invalide toutes les sessions actives et tous les jetons signés (par exemple, les liens de réinitialisation de mot de passe) en cours.
  • Pas de credential admin fixe/codé en dur. Contrairement à l'autre module de gestion de recettes de ce catalogue (Mealie, qui fournit un changeme@example.com/MyPassword non documenté et non configurable), Tandoor dispose d'un job d'initialisation create-superuser qui amorce un véritable credential unique à partir de Secret Manager à chaque déploiement.
  • La mise à l'échelle à zéro est activée par défaut (min_instance_count = 0, cpu_always_allocated = false). Tandoor n'a pas de worker en arrière-plan ou de planificateur de tâches — son scraping d'importation d'URL de recettes s'exécute de manière synchrone dans la requête déclenchante — donc la facturation basée sur les requêtes n'a pas besoin de dérogation.
  • Redis est vraiment facultatif et désactivé par défaut. CACHES['default'] ne passe à Redis que si REDIS_HOST est défini ; sinon, le cache en mémoire locale intégré de Django est utilisé. Il n'y a pas de worker Celery ou de file d'attente à maintenir au chaud.
  • Le stockage des images de recettes est monté GCS par défaut. Tandoor_Common déclare une entrée gcs_volumes montant le bucket data (gcs-<application_name><tenant_prefix>-data) à /opt/recipes/mediafiles, de sorte que les images de recettes téléchargées persistent entre les révisions au lieu de vivre sur un disque de conteneur éphémère. Un gcs_volumes fourni par l'opérateur remplace cette valeur par défaut.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms des services et des ressources sont indiqués dans les Sorties du déploiement.

A. Cloud Run — le service Tandoor​

Tandoor s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement à la charge des requêtes entre le nombre minimum et maximum d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le 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"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

Tandoor stocke toutes les données de l'application (recettes, plans de repas, listes de courses, utilisateurs) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé via le Cloud SQL Auth Proxy sur un socket Unix (bien que l'alias db_host_env_var_name utilisé par le POSTGRES_HOST de Tandoor se résolve en l'IP privée brute sur Cloud Run — voir le tableau des pièges). Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application, et un second job amorce le compte superutilisateur.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les drapeaux, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Cloud Storage​

Un bucket data Cloud Storage dédié est provisionné automatiquement pour les images de recettes et monté dans le conteneur à /opt/recipes/mediafiles (MEDIA_ROOT de Tandoor) via GCS FUSE. Des buckets supplémentaires peuvent être déclarés via storage_buckets ; la fourniture de votre propre gcs_volumes remplace le montage par défaut.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour les options GCS Fuse et CMEK.

D. Redis (cache facultatif)​

Redis est désactivé par défaut. Tandoor n'a pas de worker Celery ou de file d'attente en arrière-plan — l'activation de Redis ne fait que basculer le backend de cache de Django de la mémoire locale vers une instance Redis partagée, utile pour les déploiements multi-instances qui nécessitent un cache partagé.

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

E. Secret Manager​

Deux secrets d'application sont générés automatiquement et stockés dans Secret Manager : le SECRET_KEY de Django (signature cryptographique pour les sessions, les jetons CSRF, les liens de réinitialisation de mot de passe) et DJANGO_SUPERUSER_PASSWORD (la connexion superutilisateur initiale). Le mot de passe de la base de données est géré séparément par la fondation.

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

Voir App_CloudRun pour les détails d'injection et de rotation.

F. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être ajoutés ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.

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

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

Les logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte facultatives.

  • Console : Logging → Explorateur de logs ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Tandoor​

  • Configuration de la base de données au premier déploiement. Le job d'initialisation db-init s'exécute à l'aide de postgres:15-alpine. Il se connecte via le Cloud SQL Auth Proxy et crée de manière idempotente la base de données et l'utilisateur de l'application et accorde les privilèges. Le job peut être réexécuté en toute sécurité.
  • Amorçage du superutilisateur. Le job d'initialisation create-superuser dépend de db-init. Il applique les migrations Django (idempotent — un filet de sécurité, puisque boot.sh migre également à chaque démarrage de conteneur du service principal, mais le job d'initialisation peut s'exécuter avant que ce premier démarrage ne soit terminé) puis exécute python manage.py createsuperuser --noinput, lisant DJANGO_SUPERUSER_USERNAME / DJANGO_SUPERUSER_EMAIL / DJANGO_SUPERUSER_PASSWORD de l'environnement. Il vérifie d'abord l'existence d'un compte, de sorte que la réapplication du module ne génère pas d'erreur sur une instance déjà amorcée.
  • Migrations à chaque démarrage. Le boot.sh de Tandoor applique les migrations Django à chaque démarrage de conteneur (idempotent), de sorte que la mise à niveau de application_version applique automatiquement les modifications de schéma.
  • SECRET_KEY est immuable après le premier démarrage. Généré une fois et écrit dans Secret Manager. Le renouveler invalide toutes les sessions actives et tous les jetons signés en cours (par exemple, les liens de réinitialisation de mot de passe). Ne le renouvelez que pendant une fenêtre de maintenance planifiée.
  • Chemin de santé. La sonde de démarrage cible /accounts/login/ — la vue de connexion publique et non authentifiée de Django — car Tandoor n'a pas de point de terminaison de santé/info dédié. Elle ne renvoie 200 qu'une fois que l'application s'est connectée à Postgres et a appliqué les migrations, ce qui en fait un véritable signal de disponibilité. La sonde de vivacité cible le même chemin via HTTP : Cloud Run rejette purement et simplement les sondes de vivacité de type TCP ("Cloud Run ne prend actuellement pas en charge les sockets TCP dans la sonde de vivacité" — TCP est uniquement pour la sonde de démarrage), donc Tandoor_CloudRun remplace la valeur par défaut de vivacité TCP de Tandoor_Common par une valeur HTTP.
  • Connectez-vous avec le credential généré. Récupérez DJANGO_SUPERUSER_PASSWORD de Secret Manager et connectez-vous à /accounts/login/ avec le admin_username configuré (par défaut admin).
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

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 Tandoor sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec leur comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails auxquels sont accordés l'accès au projet et les alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nametandoorNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameTandoorNom lisible par l'homme affiché dans la console.
application_descriptionTandoor recipe manager on Cloud RunDescription du service.
application_versionlatestTandoor publie une véritable balise latest — passe directement comme balise d'image.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltTandoor utilise directement l'image officielle — aucune build personnalisée n'est nécessaire.
container_image""Laisser vide pour la valeur par défaut du module (vabene1111/recipes).
cpu_limit1000mCPU par instance.
memory_limit1GiMémoire par instance. Gunicorn de Tandoor (3 workers) + nginx + django-vite OOM-crash-loop à 512 Mio — 1 Gio est le minimum.
min_instance_count0Mise à l'échelle à zéro par défaut.
max_instance_count1Augmenter pour le trafic concurrent.
container_port80Nginx de Tandoor écoute sur le port 80 (TANDOOR_PORT).
cpu_always_allocatedfalseFacturation basée sur les requêtes — pas de worker en arrière-plan à maintenir au chaud.
enable_cloudsql_volumetrueCloud SQL Auth Proxy pour les connexions socket.
enable_image_mirroringtrueMettre en miroir l'image Tandoor dans Artifact Registry.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallIngress public par défaut.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. DB_ENGINE, ALLOWED_HOSTS, PGSSLMODE, DJANGO_SUPERUSER_USERNAME/EMAIL sont définis automatiquement — ne les remplacez pas ici sauf si vous savez ce que vous modifiez.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

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

Groupe 8 — CI/CD et Binary Authorization​

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, enable_binary_authorization.

Groupe 9 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner un équilibreur de charge HTTPS global + WAF Cloud Armor.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS définis dans storage_buckets.
storage_buckets[]Buckets GCS supplémentaires au-delà du bucket data auto-provisionné.
gcs_volumes[]Vide signifie que la valeur par défaut du module s'applique (le bucket data à /opt/recipes/mediafiles) ; toute entrée ici remplace entièrement cette valeur par défaut.
enable_nfsfalseNFS est désactivé par défaut.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixé par Tandoor_Common ; non transféré.
application_database_nametandoorNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_usertandoorUtilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).
db_host_env_var_namePOSTGRES_HOSTNom de la variable d'environnement de l'hôte Postgres de Tandoor.
db_user_env_var_namePOSTGRES_USERNom de la variable d'environnement de l'utilisateur Postgres de Tandoor.
db_password_env_var_namePOSTGRES_PASSWORDNom de la variable d'environnement du mot de passe Postgres de Tandoor.
db_name_env_var_namePOSTGRES_DBNom de la variable d'environnement de la base de données Postgres de Tandoor.
db_port_env_var_namePOSTGRES_PORTNom de la variable d'environnement du port Postgres de Tandoor.
admin_usernameadminNom d'utilisateur du superutilisateur initial (DJANGO_SUPERUSER_USERNAME).
admin_emailadmin@techequity.cloudE-mail du superutilisateur initial (DJANGO_SUPERUSER_EMAIL).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser la paire de jobs intégrée db-init + create-superuser.
cron_jobs[]Non utilisé — Tandoor n'a pas de tâches récurrentes planifiées par la plateforme.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /accounts/login/ délai de 30sSonde de démarrage — passe une fois que la connectivité Postgres et les migrations réussissent.
liveness_probeHTTP /accounts/login/ délai de 30sSonde de vivacité — HTTP, car Cloud Run ne prend pas en charge les sondes de vivacité TCP.
startup_probe_configHTTP /accounts/login/Sonde structurée alternative transmise directement à la fondation.
health_check_configTCPSonde de vivacité structurée alternative transmise directement à la fondation.
uptime_check_config{ enabled=false }Vérification de la disponibilité de Cloud Monitoring ; activer explicitement pour l'activer.
alert_policies[]Politiques d'alerte métrique.

Groupe 16 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseTandoor ne nécessite pas Redis ; laisser false sauf si vous intégrez une instance externe.
redis_host""Point de terminaison Redis.
redis_port6379Port Redis.

Groupe 22 — VPC Service Controls et Audit Logging​

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_loggingfalseLogs d'audit Cloud détaillés.

5. Sorties​

Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init, create-superuser).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledAudit logging et statut CMEK.

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

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

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource.

ParamètreValeur judicieuseRisqueConséquence si incorrect
SECRET_KEY (auto-généré)Ne jamais renouveler après le premier démarrageCritiqueLe renouveler invalide toutes les sessions actives et tous les jetons signés (par exemple, les liens de réinitialisation de mot de passe) en cours.
application_database_name / application_database_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_file valide fait échouer le job d'importation.
Chemin startup_probe/accounts/login/CritiquePointer la sonde vers un point de terminaison authentifié/admin renvoie 401/403 et la révision ne devient jamais prête — Tandoor n'a pas d'autre point de terminaison de santé non authentifié.
Formule gcs_volumes bucket_namegcs-tandoor<tenant_prefix>-dataÉlevéUn préfixe erroné monte un bucket inexistant, laissant le pod bloqué à Init.
DJANGO_SUPERUSER_PASSWORD (auto-généré)Récupérer de Secret Manager avant la première connexionMoyenSans le récupérer, vous ne pouvez pas vous connecter — il n'y a pas de credential de secours comme le défaut fixe de Mealie.
db_ssl_mode (PGSSLMODE, défini en interne)require sur Cloud RunÉlevéL'alias db_host_env_var_name se résout en l'IP privée brute de Cloud SQL sur Cloud Run (pas un socket), qui rejette le TCP non chiffré — ce module code en dur require dans son câblage, donc cela ne devrait pas nécessiter d'attention manuelle, mais ne le remplacez pas par disable.
enable_redisfalse sauf si nécessaireFaibleTandoor n'a pas de worker en arrière-plan ; Redis n'affecte que le backend de cache de Django.
ingress_settingsall pour une application publiqueMoyenDéfinir sur internal bloque l'accès du navigateur sauf si associé à IAP ou à un chemin réseau privé.
memory_limit1GiÉlevéConfirmé en direct : Tandoor OOM-crash-loops à 512 Mio (workers gunicorn SIGKILLed). Gen2 applique également son propre minimum de 512 Mio quel que soit le mode de facturation.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Tandoor partagée avec la variante GKE est décrite dans Tandoor_Common.

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