Aller au contenu principal

Tandoor sur GKE Autopilot

Tandoor sur GKE Autopilot

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

Ce guide se concentre sur les services cloud utilisés par 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 GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


Coût de Tandoor sur RAD et comparaison​

Le module Tandoor sur GKE Autopilot de RAD coûte environ 91,31 $ US par mois dans un projet Google Cloud que vous possédez, avec des frais de module uniques de 75 crédits (7,50 $ US, ou 67,5 crédits dans un projet géré par RAD, soit 10 % de moins). GKE convient à Tandoor qui doit coexister avec d'autres charges de travail Kubernetes ; pour un coût minimal, le module Cloud Run exécute le même Tandoor pour environ 68,61 $ US par mois, avec des frais de module inférieurs en conséquence. 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 valables au 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éploiement75 crédits (7,50 $ US au prix de la recharge)67,5 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 91,31 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 115 crédits par jour, environ 3 450 par mois (environ 345 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
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

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

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

10 crédits coûtent 1 $ US pour 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 ceux-ci.

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

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 1x vCPU / 0,5 Gio34,29 $ 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
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total91,31 $ 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 ménages 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 — plus de machine que ce dont le pod Tandoor de 1 vCPU / 0,5 Gio a besoin, plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous.
  • La majeure partie du coût d'exécution de RAD dans votre propre projet est l'instance PostgreSQL gérée et les frais de cluster GKE partagés, et non le propre pod de Tandoor — la base de données serait également nécessaire 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 lorsque 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étruit 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 posséder le projet (pas un projet dont RAD ne gère que la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google affirme que la plupart des services sont 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) — 75 crédits (7,50 $ US) dans votre propre projet, ou 67,5 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 compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet propre ci-dessus (environ 3,04 $ US par jour), cela représente environ 3 jours ou plus, ou environ 1 jour ou plus dans un projet géré par RAD (115 crédits par jour). La majeure partie du coût d'exécution ici est la base de données et les frais de cluster partagés ; ils ne s'arrêtent que si rien d'autre dans le projet ne les 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 obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés retournent 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. Aucun SaaS commercial hébergé actuellement vérifié n'existe pour Tandoor, donc aucun prix concurrent n'est mentionné.

1. Vue d'ensemble​

Tandoor fonctionne comme une seule charge de travail web tout-en-un — nginx s'exécute à l'intérieur du conteneur et proxyfie vers gunicorn via un socket Unix, donc aucun sidecar ou additional_services n'est nécessaire. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods à conteneur unique (nginx + gunicorn), 1 vCPU / 512 Mio par défaut, mise à l'échelle horizontale automatique
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 (pour les images de recettes)
CacheRedis (facultatif)Vraiment facultatif — Django revient au cache en mémoire locale lorsqu'il n'est pas défini ; pas de worker Celery/en arrière-plan
SecretsSecret ManagerSECRET_KEY Django auto-généré et mot de passe superutilisateur initial ; mot de passe de la base de données
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré

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.
  • Variables d'environnement Postgres discrètes, pas un DSN. Tandoor lit POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_HOST / POSTGRES_PORT / POSTGRES_DB directement. Les valeurs DB_* standard de la plateforme sont aliasées sur ces noms via les variables de la fondation db_*_env_var_name — sur GKE, cela se résout en la boucle de rappel 127.0.0.1 du sidecar Cloud SQL Auth Proxy.
  • 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.
  • Pas de credential admin fixe/codé en dur. Contrairement à l'autre module de gestion de recettes de ce catalogue (Mealie), Tandoor a un job d'initialisation create-superuser qui amorce un credential réel et unique à partir de Secret Manager à chaque déploiement.
  • service_type = LoadBalancer et une IP statique réservée par défaut. Tandoor est une interface utilisateur interactive pilotée par navigateur, il obtient donc une véritable IP externe — pas ClusterIP (qui ne convient qu'aux services internes).
  • NFS est désactivé par défaut. Tandoor stocke toutes les données de l'application dans PostgreSQL et les images de recettes dans un bucket GCS auto-monté.
  • Redis est vraiment facultatif et désactivé par défaut. Il n'y a pas de worker Celery ou de file d'attente à maintenir au chaud — l'activation de Redis n'affecte que le backend de cache de Django.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Tandoor​

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

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

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

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 gérée de Cloud SQL pour PostgreSQL 15. Les pods y accèdent en privé via le sidecar Cloud SQL Auth Proxy via un socket Unix. 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 indicateurs et 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, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.

C. Cloud Storage​

Un bucket data Cloud Storage dédié est provisionné automatiquement pour les images de recettes. Le compte de service de la charge de travail se voit accorder l'accès, et le bucket est monté par défaut à /opt/recipes/mediafiles (le MEDIA_ROOT de Tandoor) via le pilote CSI GCS Fuse, de sorte que les images téléchargées persistent après les redémarrages des pods.

  • 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_GKE pour les options CMEK et les montages GCS Fuse.

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.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    # Confirm REDIS_HOST injected into the running pod:
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep REDIS_HOST

E. Secret Manager​

Deux secrets d'application sont générés automatiquement et stockés dans Secret Manager : le SECRET_KEY et le DJANGO_SUPERUSER_PASSWORD de Django. 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_GKE pour l'intégration et la rotation de Secret Store CSI.

F. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe Cloud Load Balancing avec une adresse statique réservée. Un domaine personnalisé avec un certificat géré par Google peut être activé.

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

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

G. Cloud Logging et Monitoring​

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

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

3. Comportement de l'application Tandoor​

  • Configuration de la base de données lors du premier déploiement. Le job d'initialisation db-init 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 execute_on_apply de GKE ne fait que déterminer si Terraform attend le job, et non si le pod sous-jacent est planifié avant le premier démarrage du déploiement principal) 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.
  • Migrations à chaque démarrage. Le boot.sh de Tandoor applique les migrations Django à chaque démarrage de conteneur (idempotent).
  • SECRET_KEY est immuable après le premier démarrage. 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).
  • Chemin de santé. La sonde de démarrage cible /accounts/login/ — la vue de connexion publique et non authentifiée de Django. La sonde de vivacité utilise plutôt une simple vérification TCP (écoute de port), de sorte qu'un hoquet transitoire de la base de données ne fasse pas basculer un pod déjà sain.
  • 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).

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_GKE avec son comportement et ses valeurs par défaut standard.

Groupe 1 — Projet et identité​

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

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriété.

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_versionlatestTandoor publie une véritable balise latest.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltTandoor utilise directement l'image officielle.
container_image""Laissez vide pour la valeur par défaut du module (vabene1111/recipes).
min_instance_count0Réplicas minimum.
max_instance_count1Réplicas maximum.
container_port80Le nginx de Tandoor écoute sur le port 80.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions socket.
enable_image_mirroringtrueMettre en miroir l'image Tandoor dans Artifact Registry avant le déploiement.

Groupe 5 — 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.
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 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerTandoor est une interface utilisateur web interactive, il est donc exposé en externe par défaut.
workload_typeDeploymentSans état — pas de PVC nécessaire.
session_affinityNoneAucune exigence de session persistante (contrairement aux applications fortement basées sur WebSocket).
termination_grace_period_seconds30Secondes à attendre après SIGTERM avant SIGKILL.
enable_network_segmentationfalseCréer des ressources Kubernetes NetworkPolicy.

Groupe 7 — Sauvegarde et maintenance / StatefulSet​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
stateful_pvc_enablednullNon nécessaire — Tandoor est sans état (toutes les données dans Postgres + GCS facultatif).

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalseCréer un ResourceQuota Kubernetes dans l'espace de noms de l'application.
quota_cpu_requests / quota_cpu_limits""Total des requêtes/limites CPU autorisées sur tous les pods.
quota_memory_requests / quota_memory_limits""Doit utiliser des suffixes d'unité binaire (par exemple 4Gi, 8192Mi) — les entiers nus sont traités comme des octets et bloquent la planification.

Groupe 9 — Politiques de fiabilité et SQL personnalisé​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau des nœuds.
pdb_min_available1Nombre minimal de pods disponibles pendant les perturbations volontaires.
enable_custom_sql_scriptsfalseExécuter du SQL à partir d'un bucket GCS après le provisionnement.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configHTTP /accounts/login/Réussit une fois que la connectivité Postgres et les migrations ont réussi.
health_check_configTCPUne simple vérification d'écoute de port.
uptime_check_configdésactivéVérification de disponibilité Cloud Monitoring facultative.
alert_policies[]Politiques d'alerte métrique facultatives.

Groupe 11 — Stockage et jobs​

VariableValeur par défautDescription
initialization_jobs[]Laissez 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.
additional_services[]Non nécessaire — aucun sidecar/routeur nginx requis.

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

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

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

VariableValeur par défautDescription
enable_nfsfalseNFS est désactivé par défaut.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS supplémentaires au-delà du bucket data auto-provisionné.
storage_buckets[]Buckets supplémentaires à provisionner.
gcs_volumes[]Laissez vide pour utiliser la valeur par défaut du module (le bucket data monté à /opt/recipes/mediafiles via le pilote CSI) ; une valeur fournie par l'opérateur la remplace.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
max_images_to_retain7Nombre maximal d'images récentes d'Artifact Registry à conserver.

Groupe 16 — 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.
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.
admin_emailadmin@techequity.cloudE-mail du superutilisateur initial.
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.

Groupe 17 — Importation de sauvegarde​

VariableValeur par défautDescription
enable_backup_import / backup_source / backup_file / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

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

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôtes personnalisés + certificat géré.
application_domains[]Noms d'hôtes à servir.
reserve_static_iptrueIP externe stable sur les redéploiements — recommandé pour toute application web.

Groupe 21 — Redis et Cloud Armor​

VariableValeur par défautDescription
enable_cloud_armorfalseAttacher une politique Cloud Armor (WAF) au backend Ingress.
admin_ip_ranges[]CIDR autorisés à un accès privilégié.
enable_cdnfalseActiver Cloud CDN sur le backend Ingress GKE.

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Tandoor.
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 Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port.
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État et canaux de surveillance.
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 / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
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.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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

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

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_GKE, 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 renommer recrée la base de données/l'utilisateur et détruit toutes les données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_file valide fait échouer le job d'importation.
Chemin startup_probe_config/accounts/login/CritiqueTandoor n'a pas d'autre point de terminaison de santé non authentifié ; pointer la sonde ailleurs renvoie 401/403 et le pod ne devient jamais Prêt.
service_typeLoadBalancerÉlevéClusterIP (le bug de copier-coller trouvé sur de nombreux modules antérieurs) rend une application web interactive inaccessible depuis un navigateur.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers nus sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy est requis pour la connectivité PostgreSQL.
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)prefer sur GKEFaibleLa boucle de rappel du sidecar Cloud SQL Auth Proxy est déjà en texte clair ; la couche commune de ce module définit correctement les valeurs par défaut, donc cela ne devrait pas nécessiter d'attention manuelle.
enable_pod_disruption_budgettrueMoyenLa désactivation permet à GKE d'expulser tous les pods simultanément pendant la maintenance.
reserve_static_iptrueMoyenSans cela, l'IP du LoadBalancer peut changer lors du redéploiement, rompant les URL mises en favoris.

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