Aller au contenu principal

Kestra sur Google Cloud Run

Kestra sur Google Cloud Run

Kestra est une plateforme d'orchestration de données open source (Apache 2.0) pour la construction, la planification et la surveillance de pipelines ETL/ELT, de jobs batch et d'automatisation de workflows via des définitions de flux déclaratives basées sur YAML et un écosystème de plus de 500 plugins. Ce module déploie Kestra sur Cloud Run v2 en mode autonome, sur la base App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

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


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

Le module Cloud Run de Kestra sur RAD coûte environ 167 US$ par mois dans votre propre projet, plus des frais de module de 175 crédits (18 US$) une fois par déploiement — le coût de fonctionnement le plus élevé de ce groupe, car son ordonnanceur en mode autonome a besoin d'un CPU alloué en continu et ne peut pas se mettre à l'échelle à zéro. Si vous n'exécutez des pipelines que selon un calendrier plutôt que de manière continue, consultez la section "Mettez-le en pause gratuitement" ci-dessous pour arrêter de payer sans perdre vos définitions de flux. Kestra est également livré sous forme de module GKE, et ici le schéma habituel s'inverse : GKE est l'option la moins chère (environ 136 US$/mois), car la facturation des pods de GKE Autopilot convient mieux à une charge de travail toujours active que le CPU toujours alloué de Cloud Run — dans un projet géré par RAD, l'équilibre s'inverse, car le tarif journalier de 77 crédits de Cloud Run est inférieur aux 110 de GKE. Consultez le guide GKE si vous payez Google directement ; restez sur Cloud Run si RAD gère le projet pour vous.

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$)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 de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 167,44 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 107 crédits par jour, soit environ 3 210 par mois (environ 321 US$ au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve

10 crédits coûtent 1 US$ pour une recharge ponctuelle, moins sur un plan. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

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

Ressource (valeur par défaut du module)Par mois
Cloud Run, 2x vCPU / 4 GiB (alwaysOn)110,42 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$
Totalenviron 167,44 US$

Comment cela se compare​

  • Les offres commerciales de Kestra — Kestra Cloud et Kestra Enterprise Edition — ne publient pas de prix mensuel ; les deux pages vous demandent de contacter les ventes, nous ne citons donc pas un chiffre que nous n'avons pas pu vérifier.
  • L'empreinte de Kestra (2 vCPU, 4 GiB, serveur en mode autonome, plus une base de données PostgreSQL) se situe au-dessus d'un droplet Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go (environ 24 $/mois) et plus proche d'un GCP Compute Engine e2-standard-2 (environ 49 $/mois) — moins cher en espèces dans les deux cas, mais vous exécutez alors l'orchestrateur, PostgreSQL, les sauvegardes et les mises à niveau vous-même, sur un système dont d'autres pipelines dépendent pour rester opérationnels.
  • RAD vous offre deux façons de l'exécuter qui coûtent différemment pour la même raison : le mode autonome de Cloud Run a besoin d'un CPU alloué en continu pour exécuter son propre ordonnanceur, il ne peut donc pas se mettre à l'échelle à zéro comme les autres modules, tandis que la facturation des pods de GKE Autopilot est inférieure pour une charge de travail toujours active comme celle-ci.

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

Si Kestra s'exécute dans un projet géré par RAD pour vous et que vous prévoyez d'y revenir — une pause entre les cours, un creux saisonnier, ou simplement ne pas savoir si vous en aurez besoin le mois prochain — c'est la meilleure option, et cela ne coûte presque rien.

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 suppression d'un projet géré par RAD 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 de Kestra en tant que module unique, cela ne détruit pas le service Cloud Run/GKE, la base de données Cloud SQL et le réseau un par un — tout le projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google d'annuler la suppression du 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 gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi 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 que la plupart utilisent conviennent). Google indique que la plupart des services sont à 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. L'exportation nocturne de Kestra couvre sa base de données (définitions de flux, historique d'exécution) ; copiez-la d'abord si vous voulez un instantané restaurable au-delà des 30 jours du projet.

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 30 jours ci-dessus est passée, la solution de repli consiste à supprimer Kestra purement et simplement et à le redéployer plus tard.

  • Ce que coûte un redéploiement : les frais de module à nouveau (les builds sont inclus) — les frais de module indiqués ci-dessus.
  • Quand cela en vaut la peine : la suppression ne permet d'économiser de l'argent que si Kestra resterait inutilisé pendant environ 3 jours ou plus dans votre propre projet (environ 2 jours ou plus dans un projet géré par RAD). Le service Cloud Run toujours actif et la base de données représentent la majeure partie du coût de fonctionnement ici, donc la suppression de Kestra seul permet d'économiser toute la facture ci-dessus, à moins que quelque chose d'autre dans le projet ne partage la base de données.
  • Conservez d'abord les données. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du déploiement, et ce bucket 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.

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 interrompue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire remet 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 RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Google Cloud : supprimer et restaurer des projets pour le mécanisme de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.


1. Vue d'ensemble​

Kestra s'exécute comme un conteneur Java/JVM sur Cloud Run v2 en mode autonome (serveur, worker et ordonnanceur dans un seul conteneur). Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Java/JVM, 2 vCPU / 4 GiB par défaut, mode autonome à instance unique
Base de donnéesCloud SQL pour PostgreSQL 15Requis — stocke la file d'attente, le référentiel et l'historique d'exécution
Stockage d'objetsCloud StorageBucket GCS dédié pour les flux, les exécutions et les artefacts
SecretsSecret ManagerMot de passe administrateur Kestra et mot de passe de base de données auto-générés
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

Valeurs par défaut judicieuses à connaître dès le départ :

  • PostgreSQL 15 est obligatoire. Kestra utilise PostgreSQL pour sa file d'attente interne et son référentiel de flux. MySQL n'est pas pris en charge.
  • Le mode autonome exécute tous les composants dans un seul conteneur. Conservez max_instance_count = 1 pour éviter les conflits d'état de verrouillage de file d'attente entre les instances.
  • Le démarrage à froid de la JVM Java est lent. La sonde de démarrage par défaut autorise jusqu'à environ 14 minutes. Conservez min_instance_count = 1 en production afin que les déclencheurs planifiés ne soient jamais manqués.
  • Redis n'est pas utilisé. Kestra utilise PostgreSQL pour la mise en file d'attente en mode autonome.
  • Un pont de socket Unix est intégré. Le proxy d'authentification Cloud SQL crée un socket Unix, mais Java JDBC ne peut pas se connecter via des sockets Unix nativement. Le entrypoint.sh personnalisé utilise socat pour relier le socket à TCP 127.0.0.1:5432 de manière transparente.
  • Le mot de passe administrateur est auto-généré et stocké dans Secret Manager ; il n'est jamais défini en texte brut.
  • Un bucket de stockage GCS est toujours provisionné pour les flux, les exécutions et les artefacts ; son nom est injecté automatiquement comme KESTRA_STORAGE_GCS_BUCKET.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de service et de ressource sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Kestra​

Kestra s'exécute en tant que service Cloud Run v2. Étant donné que le mode autonome de Kestra combine le serveur, le worker et l'ordonnanceur en un seul processus, il s'exécute en tant qu'instance unique de longue durée. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

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

B. Cloud SQL pour PostgreSQL 15​

Kestra stocke tout l'état du workflow — définitions de flux, historique d'exécution, déclencheurs, espaces de noms et file d'attente de tâches interne — dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte via le proxy d'authentification Cloud SQL sur un socket Unix ; le entrypoint.sh relie ce socket à TCP afin que le pilote JDBC Java puisse se connecter (aucune IP publique n'est exposée). Lors du premier déploiement, un job d'initialisation crée la base de données Kestra, l'utilisateur et accorde les privilèges requis.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les flags 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> --project "$PROJECT"

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

C. Cloud Storage​

Un bucket Cloud Storage dédié est provisionné pour le backend de stockage d'artefacts GCS de Kestra. Toutes les exécutions de flux, les entrées/sorties de tâches et les objets de stockage internes y sont écrits. Le nom du bucket est injecté dans chaque instance sous le nom KESTRA_STORAGE_GCS_BUCKET. Des buckets supplémentaires ou des volumes GCS Fuse (nécessite l'environnement d'exécution gen2) peuvent être montés pour l'accès aux données de flux.

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

Voir App_CloudRun pour les options GCS Fuse et CMEK.

D. Secret Manager​

Le mot de passe administrateur de Kestra et le mot de passe de la base de données sont stockés dans Secret Manager et injectés dans le service au moment de l'exécution. Le texte brut n'apparaît jamais dans la configuration.

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

Le secret du mot de passe administrateur est nommé <resource_prefix>-admin-password. Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_CloudRun pour les détails d'injection et de rotation.

E. Réseau et ingress​

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

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

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les logs des conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring. Les sondes de santé ciblent le point de terminaison /health de Kestra. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles (le test de disponibilité est désactivé par défaut — activez-le pour la surveillance de production).

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

3. Comportement de l'application Kestra​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation (db-init) utilise postgres:15-alpine pour se connecter via le proxy d'authentification Cloud SQL et crée de manière idempotente la base de données et l'utilisateur Kestra, accorde les privilèges et réinitialise le schéma public afin que Flyway puisse appliquer toutes les migrations proprement sur une nouvelle instance Cloud SQL. Le job signale au proxy de s'arrêter proprement une fois terminé.
  • Migrations Flyway au démarrage. Kestra exécute des migrations de schéma basées sur Flyway à chaque démarrage. Le paramètre FLYWAY_DATASOURCES_POSTGRES_BASELINE_ON_MIGRATE=true empêche les échecs sur Cloud SQL, qui pré-remplit le schéma public avec des objets d'extension. La mise à niveau du application_version applique automatiquement les modifications de schéma.
  • Pont socket Unix vers TCP. Le proxy d'authentification Cloud SQL de Cloud Run crée un socket Unix à ${DB_HOST}/.s.PGSQL.5432. Java JDBC ne peut pas se connecter via un socket Unix nativement. Le entrypoint.sh personnalisé détecte ce socket, crée un lien symbolique à /tmp/cloudsql.sock (pour éviter les problèmes de séparateur de deux-points) et démarre un pont socat qui transfère le TCP 127.0.0.1:5432 vers le socket. Les variables JDBC DATASOURCES_POSTGRES_URL, DATASOURCES_POSTGRES_USERNAME et DATASOURCES_POSTGRES_PASSWORD sont ensuite assemblées à partir des variables d'environnement DB_* injectées par la plateforme avant le lancement de Kestra.
  • Point de terminaison de santé. Les sondes de démarrage et de vivacité ciblent GET /health sur le port 8080. La sonde de démarrage par défaut autorise jusqu'à environ 14 minutes pour le démarrage de la JVM. La sonde de démarrage au niveau de l'infrastructure est TCP (pas de chemin), donnant à la couche de routage de Cloud Run un simple signal de vivacité avant que la sonde d'application ne prenne le relais.
  • Connexion administrateur. Le nom d'utilisateur administrateur initial est admin. Le mot de passe est récupéré de Secret Manager (voir §2.D).
  • Déclencheurs planifiés. L'ordonnanceur interne de Kestra traite les déclencheurs définis par le flux (cron, intervalle, webhook). min_instance_count = 1 garantit qu'une instance chaude est toujours disponible. La mise à l'échelle à zéro (0) entraîne des fenêtres de déclenchement manquées pendant les démarrages à froid.

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

Groupe 1 — Projet et identité​

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

Groupe 2 — Environnement de déploiement​

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

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namekestraNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag de version de l'image Kestra ; incrémenter pour déployer une nouvelle version (par ex. 0.17.0).
display_nameKestra Data OrchestrationNom convivial affiché dans la console et l'interface utilisateur de la plateforme.
descriptionKestra Data Orchestration - ETL/ELT pipeline and workflow orchestration on Cloud RunDescription du service Cloud Run.
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.

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

VariableValeur par défautDescription
cpu_limit2000mCPU par instance ; 2 vCPU minimum recommandés pour Kestra JVM.
memory_limit4GiMémoire par instance ; 4 GiB recommandés (minimum 2 GiB).
container_port8080Port du serveur Kestra/Micronaut. Doit correspondre à MICRONAUT_SERVER_PORT.
min_instance_count1Instances minimales. Garder ≥ 1 pour ne jamais manquer les déclencheurs planifiés.
max_instance_count1Instances maximales. Garder à 1 pour le mode autonome afin d'éviter les conflits de file d'attente.
timeout_seconds300Durée maximale de la requête en secondes.
execution_environmentgen2gen2 est requis pour les montages de volume GCS Fuse.
enable_cloudsql_volumetrueSidecar du proxy d'authentification Cloud SQL — requis pour le pont JDBC de socket Unix.
enable_image_mirroringtrueMettre en miroir l'image Kestra dans Artifact Registry avant le déploiement.
cpu_always_allocatedtrueMaintenir le CPU alloué en permanence (recommandé pour l'ordonnanceur Kestra).
ingress_settingsallQuels réseaux peuvent atteindre le service : all, internal ou internal-and-cloud-load-balancing.
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
traffic_split[]Allocation de trafic entre les révisions pour les déploiements échelonnés.
max_revisions_to_retain7Combien d'anciennes révisions conserver.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les variables Kestra principales sont injectées automatiquement ; ne les écrasez pas ici.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret (0–300).
secret_rotation_period2592000sPériode de notification de rotation de Secret Manager.
enable_auto_password_rotationfalseRotation automatisée du mot de passe de la base de données sans interruption de service.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer le service.

Groupe 7 — Sauvegarde et restauration​

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

Groupe 8 — CI/CD et Binary Authorization​

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

Groupe 9 — NFS et SQL personnalisé​

VariableValeur par défautDescription
enable_nfsfalseProvisionner un partage Cloud Filestore (NFS) et le monter dans le service. Nécessite gen2.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootdésactivéExécuter du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Domaine, CDN, Cloud Armor et rétention d'images​

VariableValeur par défautDescription
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge HTTPS externe.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS. Nécessite enable_cloud_armor = true.
enable_cloud_armor / admin_ip_rangesdésactivéAttacher une politique WAF / restreindre l'accès privilégié.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner des buckets supplémentaires dans storage_buckets. Le bucket de stockage Kestra est toujours créé.
storage_buckets[]Buckets GCS supplémentaires au-delà du bucket de stockage intégré.
gcs_volumes[]Buckets GCS à monter via GCS Fuse (nécessite gen2).
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
db_namekestraNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_userkestraUtilisateur de l'application. Immuable après le premier déploiement.
database_typePOSTGRES_15Moteur Cloud SQL. Kestra nécessite PostgreSQL.
database_password_length32Longueur du mot de passe généré (16–64).
enable_cloudsql_volumetrueRequis pour le pont JDBC de socket Unix.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré. Fournir une liste non vide pour le remplacer entièrement.
cron_jobs[]Jobs Cloud Run récurrents déclenchés par Cloud Scheduler.
additional_services[]Services Cloud Run supplémentaires déployés aux côtés du service Kestra principal.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /health, délai 30s, période 20s, 40 échecsSonde de démarrage de l'application — autorise jusqu'à ~14 minutes pour le démarrage de la JVM.
liveness_probeHTTP /health, délai 180s, période 30s, 5 échecsSonde de vivacité de l'application.
startup_probe_configTCP, pas de cheminSonde de démarrage au niveau de l'infrastructure (ne suit pas les redirections HTTP).
uptime_check_configdésactivé, chemin /healthTest de disponibilité Cloud Monitoring. Activer pour la surveillance de production.
alert_policies[]Politiques d'alerte métrique.

Groupe 20 — Identity-Aware Proxy (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 22 — VPC Service Controls et Audit Logging​

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

5. Sorties​

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

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés (inclut le bucket de stockage Kestra).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration.
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.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledAudit logging 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
db_namekestra — défini une foisCritiqueImmuable après le premier déploiement ; le modifier connecte Kestra à une base de données vide, perdant tous les flux, l'historique d'exécution, les déclencheurs et les espaces de noms.
application_namekestra — défini une foisCritiqueImmuable après le premier déploiement ; le modifier renomme toutes les ressources GCP, entraînant une recréation complète avec perte de données.
KESTRA_BASICAUTH_ENABLED (injecté true)laisser tel quelCritiqueLe fait de le remplacer par false expose l'interface utilisateur complète de Kestra et l'API REST sans authentification. Ne désactiver que derrière un proxy d'authentification fiable (IAP, Cloud Armor).
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
max_instance_count1ÉlevéPlusieurs instances provoquent des conflits de verrouillage de file d'attente PostgreSQL et une double affectation de tâches dans l'édition communautaire.
min_instance_count1ÉlevéLe fait de le définir à 0 entraîne des déclencheurs planifiés manqués pendant les périodes de démarrage à froid.
memory_limit4GiÉlevéDes valeurs inférieures à 2 GiB provoquent des erreurs OutOfMemory JVM sous une charge d'exécution concurrente.
enable_cloudsql_volumetrueÉlevéRequis pour le pont JDBC de socket Unix ; sans lui, le pont de socket entrypoint.sh n'a pas de socket à relier.
KESTRA_QUEUE_TYPE / KESTRA_REPOSITORY_TYPE (injecté postgres)laisser tel quelÉlevéSeul PostgreSQL est provisionné ; le fait de le remplacer par un backend non pris en charge entraîne un échec au démarrage.
execution_environmentgen2ÉlevéLes montages NFS et GCS Fuse nécessitent la génération 2 ; le fait de passer à gen1 entraîne des échecs de montage.
Seuil d'échec startup_probe40 (par défaut)ÉlevéLa réduction en dessous de ~10 provoque des redémarrages prématurés lors d'un démarrage JVM lent avant que Kestra n'ait fini de charger.
ENDPOINTS_ALL_PORT (injecté 8080)laisser tel quelÉlevéLe fait de remplacer ce port rompt les vérifications de santé de Cloud Run, provoquant des redémarrages continus du conteneur.
min_instance_count1MoyenLe fait de le définir à 0 ajoute une latence de démarrage à froid et risque de manquer des travaux planifiés.
ingress_settingsall (ou LB-only pour la production)MoyenLe fait de le définir à internal bloque tous les déclencheurs de webhook externes et les appels d'API provenant de l'extérieur du VPC.
enable_iap / enable_cloud_armoractiver pour l'administrationMoyenL'interface utilisateur et l'API Kestra sont autrement accessibles publiquement.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour les exigences de rétention de conformité.
organization_iddéfinir lors de l'utilisation de VPC-SCMoyenS'il est vide, les contrôles de service VPC sont ignorés silencieusement.

Destruction des ressources — délai connu du sous-réseau Cloud Run​

Lors de la destruction de ce déploiement, vous pouvez rencontrer :

Error: Error waiting for Subnetwork to be deleted: The following serverless IPv4 address(es)
on subnet ... are still in use.

GCP conserve les adresses IPv4 sans serveur de manière asynchrone après la suppression du service Cloud Run. Attendez 20 à 30 minutes après la tentative de destruction initiale et réexécutez la commande de destruction ; elle réussira une fois que GCP aura libéré les adresses réservées.


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

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