Aller au contenu principal

Apache Superset sur GKE Autopilot

Apache Superset sur GKE Autopilot

Apache Superset est une plateforme open source d'exploration et de visualisation de données à laquelle font confiance des organisations du monde entier. Ce module déploie Superset 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 utilisés par Superset et sur la manière de les explorer et de les opérer 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.


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

Le module Superset sur GKE Autopilot de RAD coûte environ 129,18 $ US par mois dans un projet Google Cloud que vous possédez, avec des frais de module uniques de 175 crédits (17,50 $ US, ou 157,5 crédits dans un projet géré par RAD, soit 10 % de moins). GKE convient à Superset qui doit être placé à côté d'autres charges de travail Kubernetes ou exécuter un pod plus grand en continu ; pour le coût le plus bas, le module Cloud Run exécute le même Superset pour environ 83,31 $ US par mois à la place, avec des frais de module inférieurs pour correspondre. Si vous n'avez besoin de Superset qu'occasionnellement — un cycle de reporting, un essai analytique — 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é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 pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 129,18 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 137 crédits par jour, environ 4 110 par mois (environ 411 $ 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

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, 2x vCPU / 2 Gio72,16 $ 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 de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total129,18 $ US

Comment cela se compare​

  • Preset, la société d'hébergement géré fondée par le créateur de Superset, facture 20 $/utilisateur/mois facturés annuellement (ou 25 $/utilisateur/mois mensuellement) sur son plan Professionnel pour un nombre illimité d'utilisateurs et d'espaces de travail, après un niveau Starter gratuit pour jusqu'à 5 utilisateurs (source : preset.io/pricing). Une équipe de cinq analystes sur Preset Professional coûte 100-125 $/mois avant tout ajout ; le chiffre de RAD pour un projet propre est un coût d'infrastructure fixe qui ne varie pas avec les effectifs.
  • 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 — moins cher, mais Superset a également besoin d'une base de données gérée, de ses propres sauvegardes et de la surcharge de cluster partagé que vous géreriez alors manuellement.
  • La licence de Superset est gratuite dans les deux cas — la comparaison ici est entre l'hébergement géré par siège (Preset) et l'infrastructure fixe (RAD), et non le coût du logiciel.

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

Si Superset 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 invoqué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 créé des tableaux de bord ou enregistré des ensembles de données 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 que la fenêtre de restauration de 30 jours est passée, l'alternative est de supprimer Superset purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (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.

La suppression ne permet d'économiser de l'argent que si Superset reste inutilisé assez 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 4,31 $ US par jour), cela représente environ 5 jours ou plus, ou environ 2 jours ou plus dans un projet géré par RAD (137 crédits par jour). La majeure partie du coût d'exécution ici est la base de données et le pod GKE ; ils ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de Superset 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 reçoit 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 ; preset.io/pricing pour les plans Superset hébergés de Preset.

1. Vue d'ensemble​

Superset s'exécute comme une charge de travail web Python/Gunicorn. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods Python/Gunicorn, 2 vCPU / 2 Gio par défaut, autoscaling horizontal
Base de donnéesCloud SQL pour PostgreSQL 15Requis — stocke les tableaux de bord, les graphiques, les jeux de données et les paramètres utilisateur
Stockage d'objetsCloud StorageUn bucket de données dédié provisionné automatiquement
Cache et requêtes asynchronesRedisDésactivé par défaut ; fortement recommandé pour les déploiements multi-utilisateurs en production
SecretsSecret ManagerSUPERSET_SECRET_KEY et mot de passe de base de données auto-générés
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré

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

  • PostgreSQL 15 est requis. Superset l'utilise comme base de données de métadonnées pour tous les tableaux de bord, graphiques, jeux de données et définitions de rôles. MySQL n'est pas pris en charge.
  • SUPERSET_SECRET_KEY est auto-généré. Une clé aléatoire de 50 caractères est générée et stockée dans Secret Manager. Elle signe les sessions Flask — sa rotation invalide toutes les sessions utilisateur actives. Traitez-la comme immuable après le premier déploiement.
  • L'initialisation en deux phases s'exécute automatiquement. Un job db-init crée la base de données et l'utilisateur PostgreSQL ; puis un job app-init exécute les migrations de schéma et crée l'utilisateur admin. Les deux s'exécutent à chaque déploiement mais sont idempotents.
  • L'affinité de session est ClientIP. Les sessions Flask de Superset bénéficient d'un routage persistant afin que les requêtes du même navigateur atteignent le même pod.
  • Redis est désactivé par défaut. Sans Redis, les workers Celery n'ont pas de broker ; l'exécution de requêtes asynchrones et la mise en cache des tableaux de bord ne sont pas disponibles. Activez-le pour la production.
  • La sonde de santé cible /health — le point de terminaison de disponibilité Gunicorn de Superset.

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

Les pods Superset 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 le nombre minimum et maximum de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Superset 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 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​

Superset stocke toutes les métadonnées (tableaux de bord, graphiques, jeux de données, utilisateurs, rôles, connexions de base de données) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les pods se connectent en privé via le sidecar Cloud SQL Auth Proxy sur un socket Unix, de sorte qu'aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init crée la base de données et l'utilisateur de l'application, et le job app-init exécute superset db upgrade pour appliquer le schéma.

  • 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"
    # Open an interactive shell to inspect schema/data:
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, le nom de la base de données, l'utilisateur et le secret Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.

C. Cloud Storage​

Un bucket Cloud Storage dédié est provisionné automatiquement pour les exportations de données Superset, les sorties de graphiques et les fichiers de rapport. Le compte de service de la charge de travail se voit accorder l'accès automatiquement.

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

D. Cache Redis et moteur de requêtes asynchrones​

Redis sert de backend de mise en cache et de broker Celery pour Superset. Lorsqu'il est activé, il alimente l'exécution SQL asynchrone, le préchauffage du cache du tableau de bord et les rapports planifiés. Sans Redis, toutes les requêtes s'exécutent de manière synchrone et bloquent les workers Gunicorn.

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

E. Secret Manager​

Le SUPERSET_SECRET_KEY et le mot de passe de la base de données sont stockés en tant que secrets Secret Manager et injectés dans les pods au moment de l'exécution ; le texte en clair n'apparaît jamais dans la configuration.

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

Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. 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 de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements.

  • 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 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. Une vérification de disponibilité facultative par rapport à /health et des politiques d'alerte facultatives sont disponibles (désactivées par défaut).

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

  • Configuration de la base de données au premier déploiement. Le job db-init crée la base de données et l'utilisateur Superset de manière idempotente avant le démarrage de l'application. Il s'exécute avec postgres:15-alpine et arrête le sidecar Cloud SQL Auth Proxy via quitquitquit à la fin.
  • Migrations de schéma à chaque déploiement. Le job app-init exécute superset db upgrade à chaque déploiement, appliquant automatiquement toutes les modifications de schéma Flask-AppBuilder et Superset en attente. Ce job crée ou met à jour ensuite l'utilisateur admin avec superset fab create-admin, et exécute enfin superset init pour charger les rôles et permissions par défaut.
  • Séquence de démarrage. Le job app-init dépend de la réussite de db-init. Son délai d'attente de 30 minutes permet de gérer les migrations lentes lors du premier lancement sur des schémas grands ou complexes. La sonde de démarrage autorise jusqu'à 180 secondes (60 s de délai initial, 12 seuils d'échec à des intervalles de 10 s) pour que le pool de workers Gunicorn démarre.
  • Clé secrète Flask. SUPERSET_SECRET_KEY signe les sessions Flask et chiffre les identifiants de connexion à la base de données stockés dans les métadonnées de Superset. La modifier après le premier déploiement invalide toutes les sessions et rend les identifiants stockés illisibles. La clé est auto-générée sous forme de chaîne aléatoire de 50 caractères dans Secret Manager.
  • Requêtes asynchrones et rapports planifiés. Les workers Celery de Superset utilisent Redis comme broker et backend de résultats. Sans Redis, les requêtes asynchrones et les rapports planifiés ne sont pas disponibles. Configurez enable_redis = true et fournissez redis_host pour la production.
  • Chemin de santé. Les sondes de disponibilité/vivacité ciblent /health, qui renvoie HTTP 200 lorsque le pool de workers Gunicorn est prêt.
  • Connexion administrateur. Les identifiants administrateur sont définis via les variables d'environnement SUPERSET_ADMIN_USERNAME, SUPERSET_ADMIN_EMAIL et SUPERSET_ADMIN_PASSWORD. Le mot de passe prend par défaut la valeur de SUPERSET_SECRET_KEY lorsqu'il n'est pas explicitement défini.

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 Superset 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(requis)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[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namesupersetNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameApache SupersetNom convivial affiché dans la console.
application_description(défini)Annotation de description de la charge de travail.
application_versionlatestTag de version de l'image Superset ; épingler à une version spécifique pour la production.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_resources{ cpu_limit = "2000m", memory_limit = "2Gi" }CPU et mémoire par pod ; 2 vCPU / 2 Gio minimum pour Superset.
container_port8088Superset/Gunicorn écoute sur le port 8088.
container_image_sourcecustomcustom construit le Dockerfile intégré (requis pour psycopg2) ; prebuilt utilise une image existante.
min_instance_count1Réplicas minimum. Garder ≥ 1 pour éviter les retards de démarrage à froid.
max_instance_count5Réplicas maximum (plafond de l'autoscaler).
timeout_seconds600Délai d'expiration de la requête ; étendu pour les requêtes SQL de longue durée.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy pour les connexions socket.
enable_vertical_pod_autoscalingfalseLaisser Autopilot ajuster automatiquement les demandes de ressources.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. SUPERSET_SECRET_KEY est injecté automatiquement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerComment le service est exposé.
session_affinityClientIPRoutage persistant recommandé pour les sessions Flask de Superset.
workload_typenullSe résout automatiquement en StatefulSet lorsque le stockage par pod est activé.
network_tags['nfsserver']Tags de nœud/pod pour les règles de pare-feu.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enablednullActiver les modèles PVC dans un StatefulSet. Superset ne nécessite pas de stockage par pod.
stateful_pvc_size10GiTaille de stockage pour chaque PVC lorsqu'il est activé.
stateful_pvc_mount_path/dataChemin de montage du conteneur pour le PVC.
stateful_pvc_storage_classstandard-rwoKubernetes StorageClass pour les PVC.

Groupe 8 — Quota de ressources​

VariableValeur par défautDescription
enable_resource_quotafalsePlafonner les comptes de CPU/mémoire/objets de l'espace de noms.
quota_memory_requests / quota_memory_limits""Doit utiliser des unités binaires (4Gi, 8192Mi) — les entiers nus sont lus comme des octets et bloquent toute planification.

Groupe 9 — Politiques de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgetfalseProtéger la disponibilité pendant les mises à niveau des nœuds.
pdb_min_available1Augmenter min_instance_count au-dessus de 1 si vous avez besoin d'une marge d'éviction.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configHTTP /health, 60 s de délai, 12 échecsPermet jusqu'à 180 s pour l'initialisation du pool de workers Gunicorn.
health_check_configHTTP /health, 60 s de délaiSonde de vivacité.
uptime_check_configdésactivé, /healthVérification de disponibilité Cloud Monitoring.
alert_policies[]Politiques d'alerte métriques facultatives.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le pipeline intégré d'initialisation de base de données en deux phases + initialisation d'application.
cron_jobs[]CronJobs récurrents — utiles pour le préchauffage du cache ou la génération de rapports.
additional_services[]Services GKE sidecar ou auxiliaires (par exemple, workers Celery).

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_nfsfalseVolume Filestore partagé. Superset ne nécessite pas de NFS — l'état réside dans PostgreSQL.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur si NFS est activé.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner le bucket de données.
storage_buckets / gcs_volumes(défini)Buckets supplémentaires / montages GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 15 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseActiver Redis pour Celery et la mise en cache. Fortement recommandé pour la production.
redis_host""Nom d'hôte ou IP Redis. Requis lorsque enable_redis = true.
redis_port"6379"Port Redis (chaîne dans la variante GKE).
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — ne pas modifier. Superset nécessite PostgreSQL.
application_database_namesuperset_dbNom de la base de données. Immuable après le premier déploiement.
application_database_usersuperset_userUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption de service.

Groupe 17 — Sauvegarde et maintenance​

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

Groupe 18 — Scripts SQL personnalisés​

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

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.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google devant Superset.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder.
iap_oauth_client_id / iap_oauth_client_secret""Requis lorsque IAP est activé (sensible).
iap_support_email""Affiché sur l'écran de consentement OAuth.

Groupe 21 — 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é.
cloud_armor_policy_name(défini)Nom de la politique.

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.
stage_service_cluster_ipsMappage des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Superset.
database_instance_nameNom de l'instance Cloud SQL.
database_nameNom de la base de données de l'application.
database_userUtilisateur de la base de données de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe de la base de données.
database_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_jobs / db_import_jobNoms des jobs de configuration et d'importation (facultatif).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD.
github_repository_url / github_repository_owner / github_repository_nameDétails du dépôt GitHub.
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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
SUPERSET_SECRET_KEY (auto-généré)immuable après le premier déploiementCritiqueLa modification de la clé invalide toutes les sessions actives et rend les identifiants de connexion à la base de données stockés dans les métadonnées de Superset définitivement illisibles.
database_typePOSTGRES_15CritiqueSuperset nécessite PostgreSQL ; la modification interrompt le démarrage.
enable_cloudsql_volumetrueCritiqueLa désactivation supprime le sidecar Auth Proxy ; toutes les connexions PostgreSQL échouent.
application_database_name / _userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit tous les tableaux de bord et métadonnées.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
quota_memory_requests / _limitsunités binairesCritiqueLes entiers nus sont des octets et bloquent toute planification de pod.
enable_redistrue pour la productionÉlevéSans Redis, les workers Celery n'ont pas de broker ; les requêtes asynchrones et les rapports planifiés ne sont pas disponibles.
redis_hostdéfini explicitementÉlevéRequis lorsque enable_redis = true ; vide, les workers Celery échouent au démarrage.
container_resources.memory_limit2Gi minimumÉlevéEn dessous de 1 Gio, les workers Gunicorn sont tués par manque de mémoire pendant l'exécution des requêtes.
container_resources.cpu_limit2000mÉlevéEn dessous de 1000m, le job de migration d'initialisation de l'application peut expirer dans sa fenêtre de 30 minutes.
min_instance_count1Élevé0 provoque une mise à l'échelle à zéro ; les requêtes asynchrones soumises pendant le démarrage à froid sont perdues.
session_affinityClientIPÉlevéSans persistance, l'état de la session Flask est perdu entre les requêtes sur les déploiements multi-réplicas.
startup_probe_config.failure_threshold12 ou plusÉlevéUne réduction excessive entraîne la suppression des pods par GKE avant que Superset ne termine les migrations de base de données.
application_versionépingler à une version spécifiqueMoyenlatest déclenche des mises à niveau incontrôlées qui peuvent introduire des changements d'API incompatibles.
enable_iap / enable_cloud_armoractiver pour la productionMoyenSans eux, le formulaire de connexion Superset est publiquement accessible.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
pdb_min_available vs min_instance_countlaisser de la margeMoyen1/1 peuvent bloquer les mises à niveau des nœuds.

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

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