Aller au contenu principal

Unleash sur Google Cloud Run

Unleash sur Google Cloud Run

Unleash est une plateforme open source, sous licence Apache 2.0, de gestion de fonctionnalités (feature flags) et de bascules (toggles) pour la livraison progressive, les tests A/B et les déploiements progressifs. Ce module déploie Unleash sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud qu'Unleash utilise et sur la façon 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 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 — veuillez vous référer au guide de la fondation App_CloudRun plutôt que de les répéter ici.


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

L'exécution d'Unleash sur Cloud Run dans votre propre projet Google Cloud coûte environ 67,80 US$/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 75 crédits (7,50 US$) facturé une seule fois au moment du déploiement. Unleash est une plateforme open source de gestion de fonctionnalités et de livraison progressive, et sa base de données Postgres représente la majeure partie de ce coût d'exécution. Dans un projet géré par RAD, les frais de module tombent à 67,5 crédits (10 % de moins) — voir Mettez-le en pause gratuitement ci-dessous — ou consultez le guide GKE si vous préférez l'exécuter sur Kubernetes.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)75 crédits67,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 buildIdentique
Coût d'exécution Google Cloud67,80 US$/mois, facturé par Google au prix catalogue~61 crédits/jour (environ 1 830/mois, 183 US$ au prix de la recharge), mesuré au prix catalogue plus la marge de RAD

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

10 crédits coûtent 1 US$ pour une recharge unique, et moins avec un abonnement mensuel.

Coût d'exécution par défaut dans votre propre projet

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 0,5 GiB (scaleToZero)10,78 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$
Total67,80 US$

Comment cela se compare​

  • Le cloud hébergé d'Unleash est tarifé par siège : le paiement à l'usage est de 75 $/siège/mois avec un minimum de 5 sièges, donc une petite équipe est facturée à partir de 375 $/mois, et l'édition Enterprise est sur devis — vérifié sur la page de tarification d'Unleash, le 8 octobre 2026. Le coût de RAD pour un projet propre (environ 68 $/mois, forfaitaire, sans minimum de sièges) est une fraction de l'engagement le plus petit d'Unleash Cloud.
  • Une comparaison avec un VPS autogéré, dimensionné selon la configuration légère par défaut d'Unleash (1 vCPU / 0,5 GiB) : un Hetzner CPX11 ou un DigitalOcean 1 vCPU/2 Go Droplet coûte environ 6 à 12 $/mois — moins cher en termes de trésorerie, plus votre propre temps pour les sauvegardes et les correctifs Postgres, que Cloud SQL et Secret Manager gérés par RAD couvrent pour vous.
  • Les plateformes de gestion de fonctionnalités sont généralement adoptées par une équipe d'ingénieurs de plus de cinq personnes, ce qui est précisément là où la tarification par siège d'Unleash Cloud frappe le plus fort et où un coût d'exécution forfaitaire auto-hébergé cesse de s'adapter à l'effectif.

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

C'est l'avantage principal d'un projet géré par RAD, et cela ne coûte rien pendant la pause. 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 logique récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, aucune VM, ou la ressource de calcul une par une : 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 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 pour cela : 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 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 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.

Une lacune réelle : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logique 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 personnalisé Unleash et que vous souhaitez conserver ce travail, 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 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources définitivement, et ramener Unleash signifie redéployer à partir de zéro. Cela coûte environ 78-81 crédits dans votre propre projet, ou environ 70,5-73,5 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Unleash reste inutilisé suffisamment 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 (environ 2,26 US$ par jour), ou environ 2 jours ou plus dans un projet géré par RAD (61 crédits par jour).

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, donc copiez la dernière sauvegarde 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 non utilisé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 frais propres de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration ; tarification d'Unleash.

1. Vue d'ensemble​

Unleash s'exécute comme un conteneur Node.js sur Cloud Run v2. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 1 vCPU / 512 Mio par défaut, autoscaling sans serveur ; mise à l'échelle à zéro prise en charge
Base de donnéesCloud SQL pour PostgreSQL 15Requis — Unleash ne prend pas en charge MySQL ou d'autres moteurs
SecretsSecret ManagerJeton d'API administrateur de démarrage auto-généré (INIT_ADMIN_API_TOKENS) ; mot de passe de la base de données
IngressURL Cloud Run / Équilibrage de charge CloudURL par défaut run.app ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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.
  • Unleash est sans état. Toutes les données de drapeaux, bascules, stratégies, segments et audit résident dans PostgreSQL — aucun stockage d'objets, NFS ou volume persistant n'est provisionné, et toute instance peut servir toute requête.
  • Pas de backend Redis ou de file d'attente. Unleash n'a pas besoin de cache ou de file d'attente ; il s'adapte horizontalement en pointant plus d'instances vers la même base de données.
  • INIT_ADMIN_API_TOKENS est généré automatiquement et stocké dans Secret Manager. Unleash injecte ce jeton d'API administrateur (*:*) à accès complet dans sa base de données au premier démarrage afin que l'automatisation puisse appeler l'API d'administration immédiatement.
  • La mise à l'échelle à zéro est activée par défaut (min_instance_count = 0, cpu_always_allocated = false). Les démarrages à froid ajoutent quelques secondes à la première requête après l'inactivité. Définissez min_instance_count = 1 si les clients SDK interrogent à un intervalle serré et que la latence de démarrage à froid est inacceptable.
  • DATABASE_URL est assemblé au démarrage du conteneur à partir des variables DB_* injectées par la plateforme par le point d'entrée de l'image personnalisée, qui se ramifie sur le type de connexion (socket, proxy de bouclage ou IP privée) et maintient la vérification du certificat TLS activée pour les connexions IP privées directes (sécurisé par défaut).
  • Le point de terminaison de santé est /health — un point de terminaison public, non authentifié, qui renvoie 200. L'API d'administration sous /api/admin/* nécessite un jeton.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service Unleash​

Unleash s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre le nombre minimal et maximal d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux 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​

Unleash stocke toutes les données de l'application (projets, fonctionnalités, stratégies, segments, jetons d'API, utilisateurs et journal des modifications/audits) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte privément via le proxy d'authentification Cloud SQL ; aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application, et Unleash applique ses propres migrations de schéma 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 se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Secret Manager​

Un jeton d'API administrateur de démarrage est généré automatiquement et stocké dans Secret Manager, injecté sous le nom INIT_ADMIN_API_TOKENS. 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~admin-token"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
    # Use the token against the Admin API:
    curl -s -H "Authorization: <token>" "$SERVICE_URL/api/admin/projects"

Voir App_CloudRun pour les détails d'injection et de rotation.

D. Réseau et ingress​

Le service est accessible par son URL run.app par défaut, ce qui permet aux clients SDK et aux systèmes CI d'accéder à l'API Unleash. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être ajoutés ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.

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

Voir App_CloudRun.

E. Cloud Logging et Monitoring​

Les journaux des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des règles d'alerte facultatifs.

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

3. Comportement de l'application Unleash​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute create-db-and-user.sh en utilisant postgres:15-alpine. Il se connecte via le proxy d'authentification Cloud SQL et crée de manière idempotente la base de données et l'utilisateur de l'application et accorde les privilèges. Le job peut être réexécuté en toute sécurité ; il ne crée pas de tables.
  • Migrations de schéma au démarrage. Unleash applique ses propres migrations de schéma automatiquement à chaque démarrage, de sorte que la mise à niveau de la version de l'application applique les modifications de schéma sans étape de migration distincte. Prévoyez une marge de démarrage généreuse lors du premier démarrage sur une base de données vide.
  • DATABASE_URL est composé à l'exécution. Le point d'entrée de l'image personnalisée assemble la chaîne de connexion à partir des variables DB_* injectées. Vérifiez les variables injectées de la révision en cours d'exécution lors du débogage d'un problème de connexion :
    gcloud run services describe <service-name> \
    --region "$REGION" --project "$PROJECT" \
    --format='value(spec.template.spec.containers[0].env)'
  • Jeton d'API administrateur de démarrage. INIT_ADMIN_API_TOKENS injecte un jeton d'API administrateur (*:*) à accès complet au premier démarrage afin que CI, l'interface de ligne de commande Unleash et les backends SDK puissent appeler l'API d'administration sans connexion à l'interface utilisateur. Récupérez-le depuis Secret Manager (§2C).
  • Identifiants d'interface utilisateur par défaut. L'interface utilisateur d'administration fournit un compte de première exécution bien connu — admin / unleash4all. Changez le mot de passe immédiatement après la première connexion.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /health — un point de terminaison public, non authentifié, qui renvoie 200 uniquement lorsque le serveur est initialisé et connecté à PostgreSQL. L'API d'administration sous /api/admin/* nécessite un jeton, elle ne doit donc jamais être utilisée comme chemin de sonde.
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

4. Variables de configuration​

Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Unleash sont listés ; toute autre entrée est héritée de App_CloudRun avec son 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[]Adresses e-mail autorisées à accéder 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_nameunleashNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameUnleashNom lisible par l'homme affiché dans la console.
application_descriptionUnleash Analytics on Cloud RunDescription du service.
application_version5.7.0Tag d'image unleashorg/unleash-server ; latest est remappé vers un tag épinglé au moment du build.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomCloud Build enveloppe unleashorg/unleash-server avec le point d'entrée DATABASE_URL.
cpu_limit1000mCPU par instance ; 1 vCPU est suffisant pour la plupart des déploiements.
memory_limit512MiMémoire par instance ; augmentez à 1Gi pour une utilisation intensive de l'administration/des rapports.
min_instance_count00 active la mise à l'échelle à zéro ; définissez 1 pour un sondage SDK serré.
max_instance_count3Unleash s'adapte horizontalement — tout l'état est dans PostgreSQL.
cpu_always_allocatedfalseFacturation basée sur les requêtes ; Unleash n'effectue aucun travail en arrière-plan nécessitant un CPU toujours actif.
container_port4242Unleash écoute sur le port 4242.
execution_environmentgen2Gen2 recommandé.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumetrueProxy d'authentification Cloud SQL pour les connexions socket.
enable_image_mirroringtrueMettre en miroir l'image construite dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.
max_revisions_to_retain7Nombre d'anciennes révisions à conserver.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallall permet aux clients SDK et à CI d'atteindre l'API Unleash.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Bloque le trafic SDK authentifié par jeton.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. DATABASE_URL est assemblé à l'exécution — ne le définissez 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 avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmentez pour la production/conformité.
enable_backup_import / backup_source / backup_file / 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 — Scripts SQL personnalisés​

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

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner un équilibreur de charge HTTPS global + WAF Cloud Armor.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS définis dans storage_buckets.
storage_buckets[]Vide — Unleash ne nécessite aucun stockage de fichiers.
enable_nfsfalseNFS est désactivé ; Unleash est sans état.
gcs_volumes[]Montages de volume 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
database_typePOSTGRES_15Fixe — Unleash nécessite PostgreSQL.
application_database_nameunleashNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_userunleashUtilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.
enable_postgres_extensions / postgres_extensionsdésactivé / []Extensions PostgreSQL facultatives.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré.
cron_jobs[]Jobs Cloud Scheduler + Cloud Run planifiés.
additional_services[]Services Cloud Run auxiliaires/sidecar.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /health, délai de 30s, 30 tentativesSonde de démarrage. Prévoir une marge pour les migrations au premier démarrage.
liveness_probeHTTP /health, délai de 30sSonde de vivacité.
startup_probe_configHTTP /healthSonde de démarrage Cloud Run structurée.
health_check_configHTTP /healthSonde de vivacité Cloud Run structurée.
uptime_check_configdésactivé, /healthTest de disponibilité Cloud Monitoring.
alert_policies[]Règles d'alerte métriques.

Groupe 16 — Redis​

VariableValeur par défautDescription
enable_redisfalseUnleash ne nécessite pas Redis ; laissez désactivé.
redis_host""Utilisé uniquement lorsque enable_redis = true.
redis_port6379Port Redis.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (découvre automatiquement 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​

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.
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.
storage_bucketsBuckets Cloud Storage créés (vides pour Unleash).
container_imageImage déployée.
cicd_enabled / github_repository_urlStatut CI/CD et dépôt connecté.
deployment_id / project_idIdentifiants de nommage et de projet.

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_CloudRun, 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 environnement d'exécution gen1 avec des montages NFS/GCS, un database_type qui ne correspond pas à une extension activée, un backup_retention_days hors plage. 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 si incorrect
database_typePOSTGRES_15CritiqueTout autre moteur interrompt le démarrage d'Unleash — il ne prend en charge que PostgreSQL.
application_database_name / application_database_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données de drapeaux.
DATABASE_SSL_REJECT_UNAUTHORIZED (auto)Conserver true sur IP privéeCritiqueLa désactivation de la vérification du certificat sur une connexion TCP IP privée affaiblit la sécurité du transport.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_file valide fait échouer le job d'importation.
startup_probe / chemin liveness_probe/healthÉlevéPointer une sonde vers /api/admin/* renvoie 401/403 et la révision ne devient jamais prête.
enable_iapuniquement sans trafic SDKÉlevéIAP bloque toutes les requêtes non authentifiées, y compris les appels SDK/CI authentifiés par jeton vers l'API Unleash.
ingress_settingsallÉlevéinternal bloque les clients SDK externes et CI d'atteindre l'API Unleash.
INIT_ADMIN_API_TOKENS (auto)Récupérer de Secret ManagerMoyenLe jeton injecté accorde des droits d'API administrateur à accès complet — traitez-le comme un secret et faites-le pivoter s'il est exposé.
Connexion UI par défaut admin / unleash4allChanger lors de la première connexionÉlevéLaisser le mot de passe par défaut expose le contrôle administrateur complet de chaque drapeau.
min_instance_count0 (par défaut) ou 1MoyenLa mise à l'échelle à zéro ajoute quelques secondes de latence de démarrage à froid à la première requête après l'inactivité.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

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

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