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édez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 40 crédits (4 $ US au prix de la recharge) | 36 crédits (10 % de moins) |
| Builds | Inclus 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 build | Idem |
| Coût d'exécution Google Cloud | Facturé 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 quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD 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 SSD | 51,02 $ US |
| Cloud NAT et réseau | 5,00 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ US |
| Total | 68,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 Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur 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ées | Cloud SQL pour PostgreSQL 15 | Obligatoire — Tandoor n'a pas de moteur de secours de production pris en charge |
| Stockage d'objets | Cloud Storage | Un bucket data dédié provisionné automatiquement et monté à /opt/recipes/mediafiles (images de recettes) |
| Cache | Redis (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 |
| Secrets | Secret Manager | SECRET_KEY Django auto-générée et mot de passe superutilisateur initial ; mot de passe de la base de données |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL 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_Commoncorrigedatabase_type = "POSTGRES_15"etDB_ENGINE = django.db.backends.postgresql. Leboot.shde Tandoor interrogepg_isreadyavant 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 valeursDB_*standard de la plateforme sont aliassées sur ces noms via les variables de la fondationdb_*_env_var_name. Aucun encodage d'URL ou point d'entrée personnalisé n'est nécessaire. SECRET_KEYet le mot de passe du superutilisateur sont générés automatiquement et stockés dans Secret Manager.SECRET_KEYne 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/MyPasswordnon documenté et non configurable), Tandoor dispose d'un job d'initialisationcreate-superuserqui 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 siREDIS_HOSTest 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_Commondéclare une entréegcs_volumesmontant le bucketdata(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. Ungcs_volumesfourni 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-inits'exécute à l'aide depostgres: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-superuserdépend dedb-init. Il applique les migrations Django (idempotent — un filet de sécurité, puisqueboot.shmigre é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écutepython manage.py createsuperuser --noinput, lisantDJANGO_SUPERUSER_USERNAME/DJANGO_SUPERUSER_EMAIL/DJANGO_SUPERUSER_PASSWORDde 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.shde Tandoor applique les migrations Django à chaque démarrage de conteneur (idempotent), de sorte que la mise à niveau deapplication_versionapplique automatiquement les modifications de schéma. SECRET_KEYest 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), doncTandoor_CloudRunremplace la valeur par défaut de vivacité TCP deTandoor_Commonpar une valeur HTTP. - Connectez-vous avec le credential généré. Récupérez
DJANGO_SUPERUSER_PASSWORDde Secret Manager et connectez-vous à/accounts/login/avec leadmin_usernameconfiguré (par défautadmin). - 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é
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe 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
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | tandoor | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | Tandoor | Nom lisible par l'homme affiché dans la console. |
application_description | Tandoor recipe manager on Cloud Run | Description du service. |
application_version | latest | Tandoor publie une véritable balise latest — passe directement comme balise d'image. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
container_image_source | prebuilt | Tandoor 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_limit | 1000m | CPU par instance. |
memory_limit | 1Gi | Mémoire par instance. Gunicorn de Tandoor (3 workers) + nginx + django-vite OOM-crash-loop à 512 Mio — 1 Gio est le minimum. |
min_instance_count | 0 | Mise à l'échelle à zéro par défaut. |
max_instance_count | 1 | Augmenter pour le trafic concurrent. |
container_port | 80 | Nginx de Tandoor écoute sur le port 80 (TANDOOR_PORT). |
cpu_always_allocated | false | Facturation basée sur les requêtes — pas de worker en arrière-plan à maintenir au chaud. |
enable_cloudsql_volume | true | Cloud SQL Auth Proxy pour les connexions socket. |
enable_image_mirroring | true | Mettre en miroir l'image Tandoor dans Artifact Registry. |
Groupe 5 — Contrôle d'accès et d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Ingress public par défaut. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Acheminer uniquement le trafic RFC 1918 via VPC. |
enable_iap | false | Exiger la connexion Google. |
iap_authorized_users / iap_authorized_groups | [] | Qui peut accéder via IAP. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
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_delay | 30 | Secondes à attendre après la création du secret avant de continuer. |
secret_rotation_period | 2592000s | Fréquence de notification de rotation de Secret Manager. |
Groupe 7 — Sauvegarde et restauration
| Variable | Valeur par défaut | Description |
|---|---|---|
backup_schedule | 0 2 * * * | Cron de sauvegarde automatisée (UTC). |
backup_retention_days | 7 | Rétention ; augmenter pour la production/conformité. |
enable_backup_import / backup_source / backup_file / backup_format | options de restauration | Restaurer à 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
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_cloud_armor | false | Provisionner 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_cdn | false | Activer 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
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Cré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_nfs | false | NFS est désactivé par défaut. |
manage_storage_kms_iam / enable_artifact_registry_cmek | false | Options CMEK. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Fixé par Tandoor_Common ; non transféré. |
application_database_name | tandoor | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
application_database_user | tandoor | Utilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
db_host_env_var_name | POSTGRES_HOST | Nom de la variable d'environnement de l'hôte Postgres de Tandoor. |
db_user_env_var_name | POSTGRES_USER | Nom de la variable d'environnement de l'utilisateur Postgres de Tandoor. |
db_password_env_var_name | POSTGRES_PASSWORD | Nom de la variable d'environnement du mot de passe Postgres de Tandoor. |
db_name_env_var_name | POSTGRES_DB | Nom de la variable d'environnement de la base de données Postgres de Tandoor. |
db_port_env_var_name | POSTGRES_PORT | Nom de la variable d'environnement du port Postgres de Tandoor. |
admin_username | admin | Nom d'utilisateur du superutilisateur initial (DJANGO_SUPERUSER_USERNAME). |
admin_email | admin@techequity.cloud | E-mail du superutilisateur initial (DJANGO_SUPERUSER_EMAIL). |
enable_auto_password_rotation / rotation_propagation_delay_sec | désactivé | Rotation du mot de passe de la base de données. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
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é
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /accounts/login/ délai de 30s | Sonde de démarrage — passe une fois que la connectivité Postgres et les migrations réussissent. |
liveness_probe | HTTP /accounts/login/ délai de 30s | Sonde de vivacité — HTTP, car Cloud Run ne prend pas en charge les sondes de vivacité TCP. |
startup_probe_config | HTTP /accounts/login/ | Sonde structurée alternative transmise directement à la fondation. |
health_check_config | TCP | Sonde 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
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Tandoor ne nécessite pas Redis ; laisser false sauf si vous intégrez une instance externe. |
redis_host | "" | Point de terminaison Redis. |
redis_port | 6379 | Port Redis. |
Groupe 22 — VPC Service Controls et Audit Logging
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer 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_logging | false | Logs 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.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL run.app par défaut du service. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison / port de la base de données. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | Statut de surveillance, canaux, vérifications de disponibilité. |
initialization_jobs | Noms des jobs de configuration (db-init, create-superuser). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | Statut et détails CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | Statut VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Audit 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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
SECRET_KEY (auto-généré) | Ne jamais renouveler après le premier démarrage | Critique | 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. |
application_database_name / application_database_user | Définir une fois | Critique | Immuable 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_import | false sauf restauration | Critique | L'activation sans backup_file valide fait échouer le job d'importation. |
Chemin startup_probe | /accounts/login/ | Critique | Pointer 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_name | gcs-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 connexion | Moyen | Sans 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_redis | false sauf si nécessaire | Faible | Tandoor n'a pas de worker en arrière-plan ; Redis n'affecte que le backend de cache de Django. |
ingress_settings | all pour une application publique | Moyen | Définir sur internal bloque l'accès du navigateur sauf si associé à IAP ou à un chemin réseau privé. |
memory_limit | 1Gi | É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.
Guides connexes
- Lab pratique : Tandoor sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Tandoor sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Tandoor Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.