Keycloak sur Google Cloud Run
Keycloak est une plateforme open source de gestion des identités et des accès (un projet CNCF) offrant l'authentification unique (SSO), OAuth 2.0/OIDC, SAML 2.0, la connexion sociale, la fédération d'utilisateurs (LDAP/Active Directory) et une autorisation granulaire — une alternative auto-hébergée à Auth0/Okta sans frais par utilisateur. Ce module déploie Keycloak sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par Keycloak et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications 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 du socle App_CloudRun plutôt que de les répéter ici.
Ce que coûte Keycloak sur RAD, et comment cela se compare
Le module Cloud Run de Keycloak sur RAD coûte environ 85 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 75 crédits (7,50 $ US). Keycloak est open source sous licence Apache 2.0 sans frais par utilisateur, ce qui est proche du coût total de l'exécution de votre propre plateforme d'identité SSO/OIDC/SAML. Si vous n'en avez besoin qu'occasionnellement — un projet de cours, un locataire de démonstration, un environnement de courte durée — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 85 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 75 crédits (7,50 $ US au prix de la recharge) | 67,5 crédits (10 % de moins) |
| Builds | Inclus 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 build | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 85 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 61 crédits par jour, soit environ 1 830 par mois (environ 183 $ US au prix de la recharge) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD 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 détenu en réserve |
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. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.
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 |
|---|---|
| Cloud Run, 2x vCPU / 2 Gio (scaleToZero) | 28,37 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Cloud NAT et réseau | 5,00 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ US |
| Total | environ 85 $ US |
Comment cela se compare
- Aucun fournisseur ne vend Keycloak hébergé lui-même à un prix publié. Les SaaS SSO gérés (Auth0, Okta) résolvent le même problème mais sont un produit différent avec une tarification par utilisateur actif mensuel qui n'est pas comparable à l'exécution de Keycloak, nous n'en citons donc pas ici.
- Dimensionné selon la configuration par défaut de Keycloak (2 vCPU/2 Gio), un VPS nu (Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, environ 24 $/mois) pourrait exécuter Keycloak et Postgres ensemble pour moins cher en termes monétaires — mais vous devez alors gérer le système d'exploitation, Postgres, les sauvegardes, les correctifs de sécurité et TLS vous-même. Le chiffre de RAD inclut Cloud SQL géré avec des sauvegardes automatisées, Secret Manager pour le mot de passe administrateur généré et Cloud Monitoring.
- Le coût de RAD n'augmente pas par application cliente fédérée comme le fait un SaaS d'identité par MAU, ce qui est important une fois que Keycloak est le SSO de plus d'une poignée d'applications.
- Voir le guide GKE pour un déploiement qui reste disponible en continu et met à l'échelle les pods sous charge, au lieu de la mise à l'échelle basée sur les requêtes de Cloud Run.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Keycloak s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à un Keycloak dont vous n'avez besoin qu'occasionnellement — un projet de cours, une démo, une évaluation de courte durée — que de le faire fonctionner en continu.
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 fiable de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL ou le calcul propre à Keycloak un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de restaurer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à 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 que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
- Une lacune réelle : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes de Keycloak sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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é Keycloak et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. 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
Cloud Run se met déjà à l'échelle à zéro entre les requêtes. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 $ US), car RAD recrée le projet et les services partagés avant Keycloak. La suppression ne permet d'économiser de l'argent que si Keycloak reste inutilisé pendant environ trois jours ou plus, à la fois dans votre propre projet (environ 2,85 $ US par jour) et dans un projet géré par RAD (61 crédits par jour).
- Supprimez tout ce que Keycloak utilise. La majeure partie du coût d'exécution est généralement la base de données. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de Keycloak alors que quelque chose d'autre partage le projet n'économise que la partie calcul propre à Keycloak.
- Conservez d'abord vos 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 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 Keycloak pour une classe. Chaque participant dispose de Keycloak 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 à l'avance, 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 Keycloak 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 de l'engagement, le partenaire transfère le projet, et les déploiements deviennent la propriété du client.
Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.
Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation quotidienne de 26 crédits de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
Keycloak s'exécute comme un conteneur JVM (Quarkus) sur Cloud Run v2, construit en mode production (optimisé) via Cloud Build. Le déploiement connecte un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Service JVM, 2 vCPU / 2 Gio par défaut, autoscaling basé sur les requêtes, gen2 |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — Keycloak y stocke les royaumes, les clients, les utilisateurs et les sessions |
| Build de conteneur | Cloud Build + Artifact Registry | Image personnalisée : kc.sh build intègre le fournisseur Postgres, puis start --optimized |
| Secrets | Secret Manager | Mot de passe administrateur de démarrage et mot de passe de base de données gérés automatiquement |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL par défaut run.app, équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
| Observabilité | Cloud Logging & Monitoring | Journaux de conteneurs, métriques, vérification de disponibilité facultative sur / |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est obligatoire.
database_type = "POSTGRES_15"est fixé parKeycloak_Common; MySQL n'est pas pris en charge. - La connexion à la base de données est TCP sur le VPC privé, pas le socket Cloud SQL.
enable_cloudsql_volumeest par défautfalsecar le pilote JDBC PostgreSQL intégré de Keycloak ne peut pas utiliser les sockets Unix — le point d'entrée assembleKC_DB_URL = jdbc:postgresql://<private-ip>:5432/<db>à l'exécution, et revient automatiquement d'un chemin de socket àDB_IPsi un socket est jamais monté. - Un job
db-inits'exécute à chaque apply (postgres:15-alpine) pour créer de manière idempotente la base de données et le rôle Keycloak. - Les identifiants administrateur de démarrage sont générés automatiquement. Nom d'utilisateur
admin(KC_BOOTSTRAP_ADMIN_USERNAME), mot de passe aléatoire et stocké dans Secret Manager, injecté commeKC_BOOTSTRAP_ADMIN_PASSWORD. - La santé est sur le port de gestion 9000, pas 8080. Keycloak 25+ sert
/health,/health/readyet/metricssur un port de gestion séparé que la plateforme ne sonde pas — la sonde de démarrage est donc TCP sur 8080 ; la sonde de vivacité cible HTTP/. - Mise à l'échelle à zéro par défaut (
min_instance_count = 0). Les démarrages à froid de la JVM prennent 60 à 120 secondes — définissez1pour un IdP de production. - Redis, NFS et les buckets GCS ne sont pas utilisés — tout l'état de Keycloak est dans PostgreSQL.
- Le mot de passe de la base de données est généré automatiquement et stocké dans Secret Manager.
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 indiqués dans les Sorties du déploiement.
A. Cloud Run — le service Keycloak
Keycloak s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement à la charge de 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
Keycloak stocke toutes les données de l'application (royaumes, clients, utilisateurs, sessions et configuration) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte via TCP à l'adresse IP privée de l'instance via le VPC (pas d'IP publique) — le socket du proxy d'authentification Cloud SQL n'est intentionnellement pas utilisé car JDBC ne peut pas se connecter via des sockets Unix. Lors du premier déploiement, un job db-init crée la base de données et le rôle de l'application.
- 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> --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 Build et Artifact Registry — l'image optimisée
Le module construit une image personnalisée (container_image_source = "custom") : un Dockerfile multi-étapes exécute kc.sh build sur l'image officielle quay.io/keycloak/keycloak pour intégrer le fournisseur PostgreSQL et les fonctionnalités de santé/métriques, puis superpose un point d'entrée de plateforme et démarre avec kc.sh start --optimized — Keycloak ne réexécute pas son étape de build lente à chaque démarrage.
- Console : Cloud Build → Historique ; Artifact Registry → Dépôts.
- CLI :
gcloud builds list --project "$PROJECT" --limit 5
gcloud artifacts repositories list --project "$PROJECT"
D. Secret Manager
Deux secrets protègent le déploiement : le mot de passe administrateur de démarrage (créé par Keycloak_Common, injecté comme KC_BOOTSTRAP_ADMIN_PASSWORD) et le mot de passe de la base de données (créé par le socle). Les deux sont injectés à 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" --filter="name~keycloak"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
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 peuvent être superposés ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité. Notez que Keycloak valide son nom d'hôte public — le point d'entrée détecte automatiquement l'URL run.app comme KC_HOSTNAME, donc si vous placez Keycloak derrière un équilibreur de charge ou un domaine personnalisé, définissez KC_HOSTNAME explicitement via environment_variables.
- 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 journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des vérifications de disponibilité et des stratégies d'alerte facultatives. Le point d'entrée imprime un résumé de la configuration (KC_DB_URL, KC_HOSTNAME, paramètres de proxy) à chaque démarrage — le premier endroit où chercher lors du diagnostic de la connectivité.
- 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 Keycloak
- Configuration de la base de données au premier déploiement. Un job
db-init(postgres:15-alpine) crée de manière idempotente le rôle et la base de données Keycloak, accorde les privilèges et accordeALL ON SCHEMA public(requis pour PostgreSQL 15+). Il s'exécute à chaque apply avec jusqu'à 3 tentatives et peut être réexécuté en toute sécurité. - Migrations de schéma au démarrage. Keycloak crée et migre son schéma automatiquement au premier démarrage sur la base de données vide. Les migrations sont unidirectionnelles — ne jamais rétrograder
application_version. - Mappage d'environnement d'exécution. Le point d'entrée personnalisé mappe
DB_HOST/DB_IP,DB_PORT,DB_NAME,DB_USERetDB_PASSWORDinjectés par le socle surKC_DB_URL,KC_DB_USERNAMEetKC_DB_PASSWORDde Keycloak. SiDB_HOSTest un répertoire de socket Cloud SQL (commence par/), il revient àDB_IPcar JDBC ne peut pas utiliser les sockets Unix. Les variablesKC_DB_*définies explicitement ont toujours la priorité. - Détection automatique du nom d'hôte. Le point d'entrée exporte
CLOUDRUN_SERVICE_URLinjecté par le socle (service_urldu module) commeKC_HOSTNAMEau démarrage, de sorte que l'émetteur OIDC est stable (avecKC_HOSTNAME_STRICT=falsederrière le frontal de terminaison TLS). RemplacezKC_HOSTNAMEviaenvironment_variableslors de l'utilisation d'un domaine personnalisé. - Conscient du proxy inverse.
KC_PROXY_HEADERS=xforwardedetKC_HTTP_ENABLED=truesont injectés afin que Keycloak fasse confiance aux en-têtesX-Forwarded-*définis par le frontal de terminaison TLS de Cloud Run. - Administrateur de démarrage. Au premier démarrage, Keycloak crée un administrateur de démarrage temporaire (
admin/ mot de passe Secret Manager). Connectez-vous à<url>/admin, créez un administrateur permanent, puis supprimez ou faites pivoter l'utilisateur de démarrage. - Piège de la santé — port 9000.
/health,/health/ready,/health/liveet/metricssont servis sur le port de gestion 9000, que Cloud Run n'expose pas. Sonder8080/healthrenverrait toujours 404 — c'est pourquoi la sonde de démarrage est TCP sur 8080. - Vérification. Le document de découverte OIDC est public et confirme la santé de bout en bout :
curl -s "$SERVICE_URL/realms/master/.well-known/openid-configuration" | head -c 300
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 Keycloak sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
support_users | [] | E-mails ayant accès et alertes de surveillance. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | keycloak | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | Keycloak SSO | Nom convivial affiché dans la console. |
application_version | 26.0 | Tag de l'image Keycloak. Ne jamais rétrograder — les migrations de schéma sont irréversibles. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_image_source | custom | custom construit l'image optimisée via Cloud Build — requis ; l'image amont manque le point d'entrée qui mappe les identifiants de base de données et détecte le nom d'hôte. |
cpu_limit | 2000m | Keycloak (JVM) a besoin d'au moins 1 vCPU ; 2 vCPU recommandés. |
memory_limit | 2Gi | Le tas JVM a besoin d'au moins 1 Gio ; 2 Gio recommandés. |
container_port | 8080 | Écouteur HTTP Keycloak. La santé/les métriques sont sur le port de gestion séparé 9000. |
min_instance_count | 0 | Mise à l'échelle à zéro. Les démarrages à froid de la JVM prennent 60 à 120 s — définissez 1 pour un IdP de production. |
max_instance_count | 3 | Plafond de coût. |
enable_cloudsql_volume | false | Conserver false. JDBC ne peut pas utiliser le socket Unix de Cloud SQL ; Keycloak se connecte via TCP sur IP privée. |
execution_environment | gen2 | Recommandé pour un démarrage plus rapide. |
enable_image_mirroring | true | Mettre en miroir l'image de base dans Artifact Registry. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 5 — Contrôle d'accès et d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Keycloak est un IdP exposé à Internet par défaut ; utilisez internal-and-cloud-load-balancing derrière un équilibreur de charge. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Requis pour que Keycloak puisse atteindre l'IP privée de Cloud SQL via le VPC. |
enable_iap | false | IAP devant un IdP OIDC/SAML interrompt les flux de redirection du navigateur — désactivez-le sauf si la console est uniquement interne. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres KC_* supplémentaires (par exemple KC_LOG_LEVEL, KC_FEATURES ou un KC_HOSTNAME explicite). KC_DB, KC_PROXY_HEADERS, KC_HTTP_ENABLED, KC_HEALTH_ENABLED, KC_METRICS_ENABLED et KC_BOOTSTRAP_ADMIN_USERNAME sont injectés automatiquement. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager (par exemple, mots de passe de truststore). |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 7 — Sauvegarde et restauration
Comportement de sauvegarde standard d'App_CloudRun (backup_schedule 0 2 * * *, backup_retention_days 7, enable_backup_import facultatif). Tout l'état est dans PostgreSQL, donc les sauvegardes de base de données capturent l'intégralité de la configuration Keycloak.
Groupe 8 — CI/CD et Binary Authorization
Intégration standard de Cloud Build / Cloud Deploy d'App_CloudRun — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.
Groupe 9 — SQL personnalisé
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 — Domaine, CDN, Cloud Armor et rétention d'images
| Variable | Valeur par défaut | Description |
|---|---|---|
application_domains | [] | Noms d'hôtes personnalisés pour l'équilibreur de charge externe. Définissez KC_HOSTNAME pour qu'il corresponde — Keycloak émet des jetons et des redirections pour son nom d'hôte configuré. |
enable_cloud_armor | false | WAF devant l'IdP — recommandé pour les connexions de production exposées à Internet. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 11 — Stockage et système de fichiers
Keycloak n'a pas besoin de stockage d'objets ou de fichiers — storage_buckets et gcs_volumes sont par défaut [] et enable_nfs à false. Tout l'état est dans PostgreSQL. Toutes les entrées suivent le comportement standard d'App_CloudRun.
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Keycloak nécessite PostgreSQL — ne pas modifier. |
db_name | keycloak | Nom de la base de données (préfixé par le locataire au moment du déploiement). Immuable après le premier déploiement. |
db_user | keycloak | Rôle de l'application (préfixé par le locataire au moment du déploiement). Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laissez vide pour utiliser le job db-init intégré (postgres:15-alpine, 3 tentatives). |
cron_jobs | [] | Jobs récurrents déclenchés par Cloud Scheduler. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | TCP sur 8080, délai initial de 30 s, 30 échecs (budget d'environ 330 s) | TCP car /health se trouve sur le port de gestion non exposé 9000. Budget généreux pour le démarrage de la JVM + les migrations au premier démarrage. |
liveness_probe | HTTP /, délai initial de 60 s | Le chemin racine de Keycloak répond sur 8080 une fois démarré. |
uptime_check_config | désactivé, chemin / | Activer pour la production ; Keycloak sert une page d'accueil publique à /. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 21 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Keycloak n'utilise pas Redis — laissez false. |
Groupe 22 — VPC Service Controls et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC — utile pour un IdP détenant des identifiants. |
enable_audit_logging | false | Journaux d'audit Cloud détaillés. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
5. Sorties
Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL run.app par défaut du service. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (sensible) / port. |
storage_buckets | Buckets Cloud Storage créés (vides — Keycloak n'en utilise aucun). |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | État de la surveillance, canaux, vérifications de disponibilité. |
initialization_jobs | Noms des jobs de configuration (db-init). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | État et détails CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre 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_enabled | Journalisation 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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
database_type | POSTGRES_15 | Critique | Keycloak nécessite PostgreSQL ; tout autre moteur interrompt le démarrage. |
enable_cloudsql_volume | false | Critique | JDBC ne peut pas utiliser le socket Unix de Cloud SQL. Avec une connexion uniquement par socket et sans repli DB_IP, Keycloak ne peut pas atteindre PostgreSQL. |
db_name / db_user | défini une fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/le rôle et détruit tous les royaumes et utilisateurs. |
application_version | ne jamais rétrograder | Critique | Les migrations de schéma Keycloak sont unidirectionnelles ; une rétrogradation corrompt ou refuse le schéma. |
container_image_source | custom | Élevé | L'image amont manque le point d'entrée qui mappe les identifiants de base de données, assemble l'URL JDBC et détecte KC_HOSTNAME — et elle n'est pas pré-construite pour start --optimized. |
startup_probe | TCP sur 8080, ≥30 échecs | Élevé | Une sonde HTTP sur 8080/health renvoie toujours 404 (la santé est sur le port 9000) ; la révision ne devient jamais prête même si Keycloak a bien démarré. |
| Administrateur de démarrage | remplacer après la première connexion | Élevé | admin + le mot de passe Secret Manager est un identifiant de démarrage temporaire ; le laisser comme seul administrateur est un risque permanent. |
KC_HOSTNAME (via environment_variables) | explicite lors de l'utilisation d'un domaine personnalisé / équilibreur de charge | Élevé | La détection automatique fixe l'URL run.app ; les redirections OIDC et les URL d'émetteur ne correspondent alors pas au domaine que les utilisateurs visitent réellement. |
memory_limit | 2Gi | Élevé | OOM JVM en dessous de ~1 Gio, surtout pendant les migrations au premier démarrage. |
vpc_egress_setting | PRIVATE_RANGES_ONLY (ou ALL_TRAFFIC) | Élevé | Sans egress VPC, le service ne peut pas atteindre l'IP privée de Cloud SQL. |
min_instance_count | 1 pour la production | Moyen | 0 ajoute un démarrage à froid JVM de 60 à 120 s à la première redirection SSO après inactivité — très visible dans les flux de connexion. |
enable_cloud_armor | activé pour les connexions exposées à Internet | Moyen | Les points de terminaison de connexion et d'administration sont autrement non protégés contre le trafic volumétrique/de bourrage d'identifiants. |
enable_redis | false | Faible | Keycloak n'utilise pas Redis ; l'activer n'injecte que des variables d'environnement inutilisées. |
Pour le comportement du socle 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 à Keycloak partagée avec la variante GKE est décrite dans Keycloak_Common.
Guides connexes
- Lab pratique : Keycloak sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Keycloak sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- Keycloak Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé avec Passbolt sur Google Cloud Run, Infisical sur Google Cloud Run dans la solution SSO Foundation.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.