Aller au contenu principal

Azimutt sur GKE Autopilot

Azimutt sur GKE Autopilot

Azimutt est un explorateur de schémas de base de données open source de nouvelle génération et un outil ERD (diagramme d'entité-relation) pour les bases de données réelles, construit avec Elixir/Phoenix. Il permet aux équipes d'explorer, de documenter et de concevoir de grands schémas (des milliers de tables), de rechercher parmi les colonnes et les relations, et de partager des diagrammes. Ce module déploie Azimutt sur GKE Autopilot sur la base 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 qu'Azimutt utilise 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 — veuillez vous référer au guide de la fondation App_GKE plutôt que de les répéter ici.


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

Le module GKE Autopilot d'Azimutt sur RAD coûte environ 136 US$ par mois dans un projet que vous possédez, sans frais de licence pour le logiciel lui-même. RAD facture des frais de module uniques de 175 crédits (17,50 US$ au prix de la recharge) dans un projet que vous possédez, et de 157,5 crédits (10 % de moins) dans un projet géré par RAD. GKE convient à Azimutt qui doit rester opérationnel en continu ou s'adapter à travers les pods ; pour le coût le plus bas, le module Cloud Run exécute le même Azimutt pour environ 89 US$ par mois. Les chiffres sont ceux du 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, un besoin saisonnier — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les quelque 136 US$ par mois deviennent presque nuls. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement175 crédits (17,50 US$ au prix de la recharge)157,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 136 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 135 crédits par jour, soit environ 4 050 par mois (environ 405 US$ au prix de la recharge ; estimé à partir des prix catalogue de 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

10 crédits coûtent 1 US$ pour une recharge ponctuelle, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données est partagée par toutes les applications du projet, donc une deuxième application n'en ajoute pas une deuxième.

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, 2x vCPU / 4 Gio79,35 US$
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Frais de gestion de cluster GKE0 US$ si c'est votre seul cluster Autopilot/zonal sur le compte de facturation, sinon environ 73 US$ (partagés entre toutes les applications GKE du projet)
Totalenviron 136 US$

Comment cela se compare​

  • Aucun concurrent SaaS de marque n'est une correspondance exacte pour Azimutt, donc la comparaison honnête est un simple serveur auto-géré. En exécutant le même logiciel open source vous-même, un Hetzner CPX22 (2 vCPU/4 Go, environ 24 $/mois) ou un DigitalOcean 2 vCPU/4 Go Droplet (également 24 $/mois) est à peu près de la même forme ; un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois.
  • RAD n'est pas moins cher qu'un VPS nu en termes d'argent, et n'essaie pas de l'être. Ce que RAD ajoute pour un prix similaire est une base de données gérée, Secret Manager pour les identifiants, et une surveillance qui serait autrement votre propre travail à configurer, patcher et sauvegarder.
  • Le temps de l'administrateur est le coût réel qu'un VPS ne montre pas. Les correctifs de sécurité, les sauvegardes et les mises à niveau de version sur un serveur nu sont un travail que quelqu'un doit continuer à faire ; les services gérés de RAD absorbent cela.

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

Si Azimutt s'exécute dans un projet géré par RAD pour vous, vous avez une option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — préparation à une certification, démonstration, besoin saisonnier — qu'à une exécution continue d'Azimutt.

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.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement. Google ne le supprime pas immédiatement : il conserve le projet, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne détruit pas la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet s'arrête simplement, et rien n'est facturé entre-temps.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, seul le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). 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 ne survivent pas. Tout ce qu'Azimutt écrit dans un bucket de sauvegarde à l'intérieur du projet est très probablement perdu dès que vous supprimez le projet, même si le projet lui-même est récupérable pendant 30 jours — la suppression logicielle de Cloud Storage est explicitement désactivée pour ce bucket. Quiconque a personnalisé le déploiement et souhaite conserver ce travail doit copier 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​

C'est la solution de repli pour un projet que vous possédez, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est passée : supprimez le déploiement et redéployez-le lorsque vous en aurez à nouveau besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 175 crédits (17,50 US$) dans votre propre projet, ou 157,5 crédits dans un projet géré par RAD, car RAD reconstruit les ressources à partir de zéro. La suppression permet d'économiser de l'argent une fois qu'Azimutt resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 4 jours ou plus dans votre propre projet (4,55 US$/jour) ou 2 jours ou plus dans un projet géré par RAD (135 crédits/jour).
  • La majeure partie du coût d'exécution est généralement l'infrastructure partagée. La base de données ne s'arrête que lorsque rien d'autre dans le projet ne l'utilise, donc la suppression d'Azimutt alors qu'une autre application partage le projet n'économise que la partie calcul d'Azimutt.
  • Conservez vos données en premier. Tout ce qu'Azimutt écrit dans un bucket de sauvegarde à l'intérieur du déploiement est supprimé avec lui — copiez la dernière sauvegarde (vers Google Drive, ou un bucket que vous conservez) avant de supprimer si vous voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous. Vous saisissez à nouveau les paramètres lorsque vous redéployez.

Sessions de lab et environnements gérés​

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

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

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais de RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Azimutt s'exécute comme une seule charge de travail web Elixir/Phoenix écoutant sur le port 4000. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods Phoenix, autoscalés horizontalement ; facturés pour le CPU/mémoire demandé
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — Azimutt ne prend pas en charge MySQL ou d'autres moteurs
Stockage de fichiersCloud Filestore (NFS)Optionnel, désactivé par défaut (enable_nfs = false) : Azimutt écrit les téléchargements dans son propre répertoire de travail éphémère, jamais sur ce montage (voir ci-dessous)
Stockage d'objetsCloud StorageUn bucket est provisionné (disponible pour un adaptateur de fichiers compatible S3)
SecretsSecret ManagerSECRET_KEY_BASE Phoenix auto-généré ; mot de passe de la base de données
Build d'imageCloud Build + Artifact RegistryWrapper léger FROM ghcr.io/azimuttapp/azimutt, mis en miroir dans Artifact Registry
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé optionnel + certificat géré

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; la sélection de tout autre moteur interrompt le démarrage. Toutes les données du projet Azimutt résident dans Postgres.
  • Azimutt se connecte à Postgres via la boucle de rappel du proxy d'authentification (pas de SSL). Ecto ne peut pas analyser le DSN du socket Cloud SQL, donc sur GKE, le point d'entrée construit DATABASE_URL contre 127.0.0.1 (le sidecar Cloud SQL Auth Proxy, qui termine TLS) avec DATABASE_ENABLE_SSL=false. enable_cloudsql_volume = true est requis.
  • container_port et les sondes doivent être 4000. Sur GKE, la plateforme n'injecte pas automatiquement PORT, donc le point d'entrée par défaut PORT=4000 ; le port du service et les sondes doivent correspondre ou le pod ne deviendra jamais Ready même si l'application est saine.
  • NFS est désactivé par défaut (enable_nfs = false) car rien dans ce module n'y écrit — FILE_STORAGE_ADAPTER reste local, donc les téléchargements atterrissent sur le disque éphémère du pod, que NFS soit monté ou non. Les données du projet elles-mêmes (schémas, diagrammes, mises en page, utilisateurs) résident dans Postgres et ne sont pas affectées.
  • SECRET_KEY_BASE est généré automatiquement et stocké dans Secret Manager. Le faire pivoter après le premier démarrage déconnecte toutes les sessions actives ; ne le faites pivoter que pendant une fenêtre de maintenance.
  • Un minimum de 1 réplica est maintenu (min_instance_count = 1) — GKE ne prend pas en charge la mise à l'échelle à zéro, gardant Azimutt toujours accessible.
  • Les migrations s'exécutent automatiquement à chaque démarrage (/app/bin/migrate && /app/bin/server) ; prévoyez un temps supplémentaire lors du premier démarrage.
  • application_version = "latest" correspond à la balise main d'Azimutt. Épinglez à une version spécifique en production.
  • L'inscription est ouverte par défaut. Restreignez l'accès après avoir créé votre premier compte.

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

Les pods Azimutt sont planifiés sur Autopilot, qui facture le CPU/mémoire que les pods demandent réellement. L'autoscaling horizontal des pods dimensionne le déploiement entre le nombre minimal et maximal de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Azimutt pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'adresse IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl logs -n "$NAMESPACE" deploy/<service-name> | grep cloud-entrypoint # resolved DB wiring

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

Azimutt stocke toutes les données de l'application (schémas, diagrammes, mises en page, utilisateurs, sources) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Les pods y accèdent via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1 (TLS terminé par le proxy, donc DATABASE_ENABLE_SSL=false). Lors du premier déploiement, un job d'initialisation crée la base de données et le rôle de l'application ; Azimutt exécute ensuite ses propres migrations Ecto au démarrage.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, 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 sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes et la rotation des mots de passe, voir App_GKE.

C. Cloud Filestore (NFS) et Cloud Storage​

NFS est désactivé par défaut (enable_nfs = false) ; s'il est activé, il est monté à nfs_mount_path, mais il n'est pas connecté au chemin de stockage d'Azimutt — avec le FILE_STORAGE_ADAPTER = local par défaut, Azimutt écrit toujours les téléchargements dans son propre répertoire de travail éphémère plutôt que sur ce montage. Un bucket Cloud Storage est également provisionné (disponible si vous passez Azimutt à un adaptateur de fichiers compatible S3). Les données du projet elles-mêmes (schémas, diagrammes, mises en page, utilisateurs) résident dans Postgres et ne sont pas affectées dans les deux cas.

  • Console : Filestore → Instances ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    kubectl get pvc -n "$NAMESPACE"

Voir App_GKE pour le provisionnement NFS, les options CMEK et les montages GCS Fuse.

D. Secret Manager​

Le SECRET_KEY_BASE de Phoenix est généré automatiquement et stocké dans Secret Manager (utilisé pour signer et chiffrer les cookies de session). 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" --filter="name~secret-key-base"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

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

E. Cloud Build et Artifact Registry​

L'image d'Azimutt est un wrapper léger construit FROM ghcr.io/azimuttapp/azimutt ; Cloud Build produit l'image wrappée et elle est mise en miroir dans Artifact Registry (enable_image_mirroring = true). Comme il s'agit d'une image reconstruite/mise en miroir, App_GKE définit imagePullPolicy = Always afin que les nœuds ne servent jamais une couche mise en cache obsolète.

  • Console : Cloud Build → Historique ; Artifact Registry → Dépôts.
  • CLI :
    gcloud builds list --project "$PROJECT" --limit 5
    gcloud artifacts docker images list <region>-docker.pkg.dev/$PROJECT/<repo> --include-tags

F. Réseau et ingress​

Par défaut, la charge de travail est exposée via une adresse IP externe de Cloud Load Balancing (service_type = LoadBalancer). Un domaine personnalisé avec un certificat géré par Google peut être activé, et une adresse IP statique peut être réservée afin que l'adresse survive aux redéploiements. session_affinity = ClientIP maintient un client lié à un pod.

  • 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 des adresses IP statiques.

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 tests de disponibilité et des stratégies d'alerte optionnels sont disponibles. Les lignes cloud-entrypoint affichent le chemin DATABASE_URL résolu, PHX_HOST et PORT.

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

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute db-init.sh en utilisant postgres:15-alpine. Il crée de manière idempotente le rôle d'application (LOGIN CREATEDB) et la base de données, accorde ALL sur la base de données et le schéma public, et ALTER le propriétaire du schéma — Azimutt a besoin de tous les droits DDL car il exécute ses propres migrations. Le job signale ensuite au sidecar Auth Proxy de s'arrêter (/quitquitquit) afin que le pod du job se termine. Peut être réexécuté en toute sécurité.
  • Les migrations s'exécutent au démarrage. La commande du conteneur est /app/bin/migrate && /app/bin/server, donc Ecto applique les migrations en attente à chaque démarrage avant que le point d'accès Phoenix ne se lie. La mise à niveau de application_version applique automatiquement les modifications de schéma.
  • Le câblage de la base de données d'exécution est composé par le point d'entrée. Sur GKE, DATABASE_URL est construit contre la boucle de rappel du proxy d'authentification (127.0.0.1) avec DATABASE_ENABLE_SSL=false, et PORT est défini par défaut à 4000 (GKE ne l'injecte pas automatiquement). PHX_HOST est dérivé de l'URL de service injectée.
  • SECRET_KEY_BASE est stable et effectivement immuable. Le faire pivoter invalide chaque cookie de session actif — tous les utilisateurs sont déconnectés. Ne le faites pivoter que pendant une fenêtre de maintenance.
  • Chemin de santé. La sonde de démarrage cible la racine Phoenix / et la sonde de vivacité /health, toutes deux avec un délai initial de 60 secondes. La sonde de vivacité est mise en miroir dans la vérification de santé de la passerelle, qui nécessite un 200 littéral, elle ne doit donc pas pointer vers /. Les sondes et container_port doivent toutes deux être 4000 ou le pod ne deviendra jamais Ready.
  • Configuration initiale. Accédez au service via son adresse IP externe de LoadBalancer (ou son domaine personnalisé) et créez le premier compte Azimutt via la page d'inscription. L'inscription est ouverte par défaut — restreignez l'accès par la suite.
  • Inspecter l'exécution du job d'initialisation :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<job-name>

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 Azimutt 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.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

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 autorisés à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameazimuttNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameAzimuttNom lisible par l'homme affiché dans l'interface utilisateur de la plateforme.
application_versionlatestTag d'image Azimutt ; latest correspond au tag main. Épinglez à une version en production.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
min_instance_count1Réplicas minimum ; GKE ne prend pas en charge la mise à l'échelle à zéro.
max_instance_count5Réplicas maximum.
container_port4000Phoenix écoute sur le port 4000 ; les sondes et le port du service doivent correspondre.
enable_cloudsql_volumetrueSidecar Auth Proxy pour la connexion DB 127.0.0.1 ; requis.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service Kubernetes est exposé.
workload_typenullDéploiement par défaut ; se résout automatiquement en StatefulSet si stateful_pvc_enabled = true.
session_affinityClientIPRoutage persistant pour qu'un client reste sur un pod.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enablednullLaisser vide — Azimutt est basé sur NFS et stocke les données du projet dans Postgres.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau des nœuds.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /, délai de 60s, fenêtre d'échec de 30 × 15sSonde de démarrage ; laisser le temps pour les migrations au premier démarrage. Doit cibler le port 4000.
liveness_probeHTTP /health, délai de 60sSonde de vivacité ; également la vérification de santé de la passerelle, qui nécessite un 200 littéral.
startup_probe_config / health_check_configHTTP /, sondes d'infrastructure au niveau App_GKESondes structurées.
uptime_check_configdésactivé, chemin /Test de disponibilité optionnel de Cloud Monitoring.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

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

VariableValeur par défautDescription
enable_nfsfalseDésactivé par défaut : rien dans ce module n'écrit sur le montage NFS. Azimutt stocke les téléchargements avec FILE_STORAGE_ADAPTER = local sur le disque éphémère du conteneur ; les téléchargements durables nécessitent l'adaptateur s3 d'Azimutt_Common, que l'activation de NFS n'a jamais fourni. Les données du projet résident dans PostgreSQL.
nfs_mount_path/opt/azimutt/storageChemin de montage à l'intérieur du conteneur.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 15 — Cache et file d'attente Redis​

VariableValeur par défautDescription
enable_redisfalseDésactivé par défaut — Azimutt utilise PostgreSQL (Oban) pour les jobs en arrière-plan, pas Redis.
redis_host""Point de terminaison Redis (uniquement si une fonctionnalité en aval le requiert).

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
application_database_nameazimuttNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_userazimuttUtilisateur de la base de données de l'application. Immuable après le premier déploiement.

Toutes les autres entrées suivent le comportement standard d'App_GKE.

Groupes 19-22 — Domaine personnalisé, IAP, Cloud Armor, VPC-SC​

Comportement standard d'App_GKE — enable_custom_domain, reserve_static_ip, enable_iap, enable_cloud_armor, enable_vpc_sc, enable_audit_logging. Voir App_GKE.


5. Sorties​

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

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à chaque étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Azimutt.
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 DB (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_channelsStatut et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration et d'importation (optionnel).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationStatut 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_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit 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 la fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un réplica en lecture sans son primaire, IAP sans identités autorisées, un runtime gen1 avec des montages NFS/GCS, un database_type qui ne correspond pas à une extension activée, un redis_port/backup_retention_days hors plage, un quota_memory_* entier nu. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
SECRET_KEY_BASE (auto-généré)Ne jamais faire pivoter en dehors d'une fenêtre de maintenanceCritiqueLe faire pivoter invalide chaque cookie de session actif — tous les utilisateurs sont déconnectés.
application_database_name / application_database_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/le rôle et orpheline toutes les données Azimutt.
container_port4000CritiqueLe point d'entrée par défaut PORT=4000 sur GKE ; un port de service ou un port de sonde non concordant atteint un port mort et le pod ne devient jamais Ready.
enable_cloudsql_volumetrueCritiqueLe sidecar Auth Proxy fournit la connexion DB 127.0.0.1 ; le désactiver laisse Azimutt sans base de données et bloque le démarrage db-init.
enable_nfsfalseFaibleL'activer provisionne Filestore, mais n'a aucun effet sur Azimutt lui-même — FILE_STORAGE_ADAPTER n'est jamais pointé vers le montage NFS, donc les téléchargements atterrissent toujours sur le disque éphémère du pod, quel que soit ce paramètre (les données du projet elles-mêmes sont en sécurité dans Postgres).
min_instance_count1ÉlevéGKE exige min ≥ 1 ; la garde de validation rejette les valeurs invalides.
application_versionÉpinglez une versionÉlevélatest correspond à la balise roulante main ; un changement inattendu en amont peut casser un redéploiement.
session_affinityClientIPMoyenSans persistance, les sessions d'interface utilisateur rebondissent entre les pods.
enable_iap / domaine personnaliséRestreindre après le premier compteÉlevéL'inscription est ouverte par défaut ; laisser le LoadBalancer accessible publiquement permet à quiconque de créer un compte.
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_redisfalseFaibleAzimutt utilise Postgres/Oban, pas Redis — l'activer n'a aucun effet sur Azimutt lui-même.

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 à Azimutt partagée avec la variante Cloud Run est décrite dans Azimutt_Common.

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