Aller au contenu principal

Keycloak sur GKE Autopilot

Keycloak sur GKE Autopilot

Keycloak est une plateforme open source de gestion des identités et des accès 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 GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes.

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 à chaque application GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


Coût de Keycloak sur RAD et comparaison​

Le module Keycloak sur GKE Autopilot de RAD coûte environ 136 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 175 crédits (17,50 $ US). GKE convient à Keycloak qui doit rester disponible et évoluer sur plusieurs pods ; pour le coût le plus bas, le module Cloud Run exécute le même Keycloak pour environ 85 $ US par mois. 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 136 $ 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édezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement175 crédits (17,50 $ US au prix de la recharge)157,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 136 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 135 crédits par jour, soit environ 4 050 par mois (environ 405 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve

10 crédits coûtent 1 $ US pour une recharge unique, et moins avec un plan 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 chaque application 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 (valeur par défaut du module)Par mois
Pod GKE Autopilot, 2x vCPU / 4 Gio79,35 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Totalenviron 136 $ US

Comparaison​

  • 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, nous n'en citons donc pas ici.
  • Dimensionné au pod GKE de 2 vCPU/4 Gio, un Compute Engine e2-standard-2 (2 vCPU/8 Go, environ 49 $/mois) ou un VPS plus grand se rapproche en termes de coûts — mais, encore une fois, vous gérez vous-même le système d'exploitation, Postgres, les sauvegardes et les correctifs, et les frais de gestion de GKE sont annulés tant que c'est votre seul cluster de ce type.
  • Le coût de RAD ne croît pas par application cliente fédérée, contrairement à un SaaS d'identité par MAU.
  • Ou consultez le guide Cloud Run pour l'option la moins chère.

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 tout le projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à 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 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 — tout le 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 réactiver 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 qu'il faut. 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 que la plupart des utilisations d'étude et de démo conviennent). Google indique que la plupart des services sont entièrement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : 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 workflow 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​

GKE maintient au moins un pod en cours d'exécution, il ne se met donc jamais à l'échelle zéro de lui-même. 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 déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 175 crédits (17,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 quatre jours ou plus, à la fois dans votre propre projet (environ 4,55 $ US par jour) et dans un projet géré par RAD (135 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 fixée 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 suspendue 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 105 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 une seule charge de travail web JVM (basée sur Quarkus) construite en mode optimisé pour la production. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod JVM sur le port 8080, 2 vCPU / 4 Gio de mémoire par défaut
Base de donnéesCloud SQL pour PostgreSQL 15Requis — le moteur est fixé à POSTGRES_15 ; MySQL n'est pas pris en charge
Connectivité de la base de donnéesSidecar Cloud SQL Auth ProxyÉcoute sur 127.0.0.1:5432 ; KC_DB_URL est une connexion JDBC TCP simple — pas de problème de socket Unix sur GKE
SecretsSecret ManagerKC_BOOTSTRAP_ADMIN_PASSWORD (administrateur temporaire) et mot de passe de la base de données générés automatiquement
IngressCloud Load BalancingLoadBalancer externe avec une IP statique réservée ; domaine personnalisé facultatif + certificat géré
Build d'imageCloud Build + Artifact RegistryUne image multi-étapes personnalisée exécute kc.sh build au moment du build, kc.sh start --optimized au démarrage

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

  • PostgreSQL 15 est obligatoire. database_type par défaut POSTGRES_15 et est fixé par la couche d'application partagée ; MySQL/SQL Server ne sont pas pris en charge pour Keycloak.
  • Cloud SQL est atteint via le sidecar Auth Proxy sur la boucle locale. GKE définit enable_cloudsql_volume = true par défaut (contrairement à la variante CloudRun, qui le définit par défaut à false car l'intégration Cloud SQL de Cloud Run est un montage de socket Unix que le pilote JDBC ne peut pas utiliser). Sur GKE, le sidecar expose un véritable écouteur TCP sur 127.0.0.1:5432, donc KC_DB_URL est un simple jdbc:postgresql://127.0.0.1:5432/<db> — aucune solution de contournement de socket n'est nécessaire.
  • KC_DB_USERNAME n'est jamais codé en dur. La fondation préfixe le rôle Postgres réel (par exemple keycloakdemo<hash>) ; entrypoint.sh mappe les variables DB_USER/DB_PASSWORD injectées par la plateforme sur KC_DB_USERNAME/KC_DB_PASSWORD au moment de l'exécution uniquement si elles ne sont pas déjà définies — ce module n'est pas confronté au piège de l'utilisateur de base de données codé en dur mentionné pour d'autres applications dans ce dépôt.
  • Les nombres de réplicas min/max sont fixés par ce module, et non par les entrées min_instance_count/max_instance_count. Le Keycloak_GKE main.tf code en dur la configuration de mise à l'échelle par application à min_instance_count = 1, max_instance_count = 5 lorsqu'il construit la carte de configuration d'application que App_GKE lit réellement pour la mise à l'échelle — les variables de haut niveau min_instance_count/ max_instance_count sont également transmises à la fondation, mais sont masquées par les valeurs spécifiques à l'application. Voir §6.
  • NFS et Redis ne sont pas utilisés. enable_nfs et enable_redis sont tous deux par défaut à false — Keycloak conserve tout l'état (domaines, clients, utilisateurs, sessions) dans PostgreSQL, et Keycloak_Common ne provisionne aucun bucket Cloud Storage (storage_buckets = []).
  • KC_BOOTSTRAP_ADMIN_PASSWORD est généré automatiquement et stocké dans Secret Manager, associé à KC_BOOTSTRAP_ADMIN_USERNAME (par défaut admin). Il s'agit explicitement d'un identifiant de démarrage temporaire — connectez-vous, créez un administrateur permanent, puis faites pivoter ou désactivez le compte de démarrage.
  • L'affinité de session est ClientIP afin que les requêtes d'un client atteignent le même pod.
  • La santé/les métriques sont sur un port de gestion séparé (9000), pas le port HTTP (8080). Toutes les sondes sont des vérifications TCP sur le port 8080 (l'écouteur HTTP acceptant les connexions) plutôt que des vérifications HTTP sur /health, qui se trouve sur le port 9000 et échouerait toujours à une sonde visant le port 8080.
  • KC_HOSTNAME est défini au moment de l'exécution. entrypoint.sh exporte le GKE_SERVICE_URL injecté par App_GKE (l'URL de l'équilibreur de charge, la même valeur que service_url), de sorte que l'émetteur OIDC ne flotte pas avec l'adresse utilisée par un client ; remplacez-le via environment_variables pour un domaine personnalisé.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que vous avez exécuté gcloud container clusters get-credentials <cluster> --region "$REGION" --project "$PROJECT" et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Keycloak​

Les pods Keycloak sont planifiés sur Autopilot, qui facture le CPU/la mémoire réellement demandés par les pods. Keycloak est sans état (workload_type par défaut Deployment, pas StatefulSet) puisque tout l'état durable réside dans PostgreSQL.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Keycloak pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

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

B. Cloud SQL pour PostgreSQL 15​

Keycloak stocke toutes les données d'application (domaines, clients, utilisateurs, groupes, sessions) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Les pods l'atteignent via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1:5432 ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init crée de manière idempotente le rôle et la base de données de l'application, accorde la propriété et accorde les privilèges sur SCHEMA public (requis sur PostgreSQL 15+, où public n'est plus accessible en écriture par tous) — Keycloak lui-même crée et migre ensuite son schéma lors du premier 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 Secret Manager contenant le mot de passe se trouvent tous dans les Sorties. Voir App_GKE pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe.

C. Secret Manager​

Le seul secret au niveau de l'application de Keycloak est le mot de passe administrateur de démarrage (KC_BOOTSTRAP_ADMIN_PASSWORD, une valeur aléatoire de 20 caractères associée au nom d'utilisateur admin via KC_BOOTSTRAP_ADMIN_USERNAME). Le mot de passe de la base de données est généré séparément par la fondation et est injecté directement en tant que KC_DB_PASSWORD (via db_password_env_var_name = "KC_DB_PASSWORD" sur l'appel App_GKE), en plus du DB_PASSWORD standard. Sur GKE, les secrets sont projetés dans les pods via le pilote CSI Secret Store.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~keycloak"
    gcloud secrets versions access latest \
    --secret="$(gcloud secrets list --project "$PROJECT" \
    --filter='name~keycloak-admin-password' --format='value(name)' --limit=1)" \
    --project "$PROJECT"

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

D. Réseau et Ingress​

Par défaut, la charge de travail est exposée via une IP externe Cloud Load Balancing (service_type = LoadBalancer, reserve_static_ip = true afin que l'adresse survive aux redéploiements). Un domaine personnalisé avec un certificat géré par Google peut être activé via enable_custom_domain + application_domains.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc,ingress -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

E. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles — Keycloak sert une page d'accueil publique à /, ce que uptime_check_config cible.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application Keycloak​

  • Configuration de la base de données au premier déploiement. Le job db-init exécute db-init.sh en utilisant postgres:15-alpine. Il attend pg_isready, puis crée de manière idempotente le rôle de l'application (ou met à jour son mot de passe), accorde ce rôle à postgres afin que le superutilisateur puisse gérer ses objets, crée / possède la base de données et accorde des privilèges sur la base de données et sur SCHEMA public. Il se termine en envoyant un POST /quitquitquit au sidecar Cloud SQL Proxy sur 127.0.0.1:9091 afin que le pod du job puisse se terminer et être marqué comme Réussi sur GKE. Le job peut être réexécuté en toute sécurité (execute_on_apply = true, max_retries = 3).
  • Pas de job de migration séparé — Keycloak migre son propre schéma au premier démarrage. L'image personnalisée exécute kc.sh build au moment du build (intégrant KC_DB=postgres, la santé et les métriques) et kc.sh start --optimized au démarrage du conteneur ; le processus de démarrage de Keycloak crée / migre le schéma par rapport à la base de données vide créée par db-init.
  • Compte administrateur de démarrage. entrypoint.sh exécute kc.sh start --optimized avec KC_BOOTSTRAP_ADMIN_USERNAME=admin et le secret KC_BOOTSTRAP_ADMIN_PASSWORD généré. Connectez-vous à <service-url>/admin, créez un administrateur permanent, puis faites pivoter ou désactivez le compte de démarrage — il est censé être temporaire.
  • Le mappage des variables d'environnement de la base de données se fait au moment de l'exécution, jamais intégré. La plateforme injecte DB_HOST=127.0.0.1 (le sidecar Auth Proxy), DB_USER, DB_PASSWORD, DB_NAME, DB_PORT ; entrypoint.sh mappe ceux-ci sur KC_DB_URL/KC_DB_USERNAME/KC_DB_PASSWORD uniquement lorsque la variable KC_DB_* n'est pas déjà explicitement définie, de sorte que les opérateurs peuvent toujours les remplacer via environment_variables.
  • Chemin de santé — TCP uniquement, port 8080. Keycloak 25+ sert /health, /health/ready, /health/live et /metrics sur le port de gestion séparé 9000, et non sur le port HTTP 8080 que la plateforme sonde. Une sonde HTTP vers 8080/health renverrait toujours 404. La sonde de démarrage (délai initial de 30s, 30 échecs ≈ jusqu'à ~330s au total pour le démarrage de la JVM + la migration du schéma) et la sonde de vivacité (délai initial de 60s, 3 échecs) sont des vérifications TCP sur le port 8080.
  • Mise à l'échelle horizontale / mise en cluster : mise en garde. Le commentaire de câblage de Keycloak_GKE indique que Keycloak "persiste tout l'état dans PostgreSQL, donc la mise à l'échelle horizontale est sûre (les nœuds du cluster forment un cache partagé via l'infinispan par défaut)".
  • Vérifier la configuration en cours d'exécution :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E '^KC_'

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_GKE avec leur comportement et leurs valeurs par défaut standards.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namekeycloakNom de base des ressources. Ne pas modifier après le premier déploiement.
application_version26.0Tag d'image Keycloak intégré à l'image personnalisée kc.sh build. Ne jamais rétrograder — les migrations de schéma sont unidirectionnelles.

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

VariableValeur par défautDescription
container_resources{ cpu_limit = "2000m", memory_limit = "4Gi" }Le dimensionnement autoritaire du CPU/mémoire — il est fusionné dans la configuration de l'application après les propres Keycloak_Common cpu_limit/memory_limit, il l'emporte donc toujours. La JVM de Keycloak a besoin d'au moins 2 Gio.
cpu_limit / memory_limit2000m / 4GiEntrées de dimensionnement de haut niveau héritées, transmises à Keycloak_Common — masquées par container_resources (voir §6) puisque container_resources a toujours une valeur par défaut non nulle.
min_instance_count / max_instance_count1 / 5Transmises directement à la fondation, mais les limites effectives des réplicas sont codées en dur à 1/5 dans le main.tf de ce module, indépendamment de ces valeurs — voir §6.
container_port8080Écouteur HTTP de Keycloak. La santé/les métriques sont sur le port de gestion séparé 9000 — la plateforme sonde ce port via TCP, pas HTTP.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy (boucle locale TCP) — requis sur GKE pour la connectivité JDBC.
cloudsql_volume_mount_path/cloudsqlChemin à l'intérieur du conteneur où le répertoire du socket Unix de l'Auth Proxy est monté (utilisé par les appels db-init pg_isready/psql du job ; le conteneur Keycloak en cours d'exécution se connecte via 127.0.0.1:5432, pas ce chemin).

Groupe 6 — Backend et cluster GKE​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour l'interface utilisateur d'administration/connexion de Keycloak.
workload_typenull → DeploymentKeycloak est sans état ; ne pas passer à StatefulSet.
session_affinityClientIPRoutage persistant pour qu'un client atteigne le même pod.
termination_grace_period_seconds60Temps alloué aux requêtes en cours pour se terminer avant qu'un pod ne soit forcé de s'arrêter.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_config / health_check_configTCP, port 8080Entrées de sonde de la fondation de haut niveau — les valeurs startup_probe/liveness_probe spécifiques à l'application ci-dessous sont ce que App_GKE lit réellement pour les sondes de cette charge de travail.
startup_probeTCP, délai de 30s, 30 échecsTransmis à Keycloak_Common ; budget d'échec généreux pour le démarrage de la JVM + la création du schéma au premier démarrage.
liveness_probeTCP, délai de 60s, 3 échecsTransmis à Keycloak_Common. TCP uniquement — /health sur le port 9000 n'est pas accessible depuis la sonde.
uptime_check_config{ enabled = false, path = "/" }Keycloak sert une page d'accueil publique à /.

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

VariableValeur par défautDescription
enable_nfsfalseGénéralement pas requis — Keycloak conserve tout l'état dans PostgreSQL.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Moteur fixe ; MySQL/SQL Server ne sont pas pris en charge.
db_name / db_userkeycloak / keycloakLe nom/utilisateur de base de données faisant autorité — ceux-ci passent par Keycloak_Common config.db_name/config.db_user, ce que App_GKE provisionne réellement.
application_database_name / application_database_userkeycloak / keycloakTransmis directement à l'appel de la fondation, mais masqués par db_name/db_user dans la résolution de configuration par application de App_GKE — les deux ont la même valeur par défaut, donc cela est invisible à moins qu'une seule paire ne soit modifiée. Voir §6.
enable_postgres_extensionsfalseNon requis pour Keycloak.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
reserve_static_iptrueIP externe stable sur les redéploiements.
application_domains[]Noms d'hôtes personnalisés + certificat géré.

Groupe 21 — Cloud Armor, CDN et Redis​

VariableValeur par défautDescription
enable_redisfalseKeycloak ne nécessite pas Redis ; laissez false à moins qu'un SPI/plugin personnalisé ne le nécessite.

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


5. Sorties​

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

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe de l'équilibreur de charge (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Keycloak.
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 de la base de données (127.0.0.1 via l'Auth Proxy) / port.
storage_bucketsBuckets Cloud Storage créés (vides — Keycloak ne stocke aucun état en dehors de PostgreSQL).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration (db-init) et d'importation (facultatif).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant qu'aucune ressource ne soit créée, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15 (fixe)CritiqueLa sélection d'un moteur non-Postgres interrompt le démarrage du schéma de Keycloak et chaque requête.
db_name / db_user (la paire faisant autorité)Définir une fois, avant le premier déploiementCritiqueEffectivement immuable — App_GKE résout la base de données/l'utilisateur Cloud SQL réels à partir de ceux-ci, et les modifier après le premier déploiement pointe Keycloak vers une base de données/un rôle différent (vide), orphelinant tous les domaines/utilisateurs.
application_database_name / application_database_userLaisser correspondre db_name/db_userMoyenCeux-ci sont transmis à la fondation mais masqués par db_name/db_user dans la résolution de configuration par application de App_GKE — ne modifier que cette paire n'a aucun effet silencieux sur le nom réel de la base de données, ce qui peut induire un opérateur en erreur en lui faisant croire qu'un renommage a eu lieu.
min_instance_count / max_instance_countComprendre qu'ils sont informatifs iciMoyenCe module code en dur les limites effectives des réplicas à 1/5 dans main.tf quelles que soient les valeurs de ces variables — définir max_instance_count = 1 pour le contrôle des coûts ne limitera pas réellement les réplicas à 1.
cpu_limit / memory_limitDéfinir container_resources à la placeMoyencontainer_resources a toujours une valeur par défaut non nulle et est fusionné en dernier, donc la modification des seules variables héritées cpu_limit/memory_limit est ignorée silencieusement.
KC_BOOTSTRAP_ADMIN_PASSWORD (généré automatiquement)Récupérer, se connecter, puis faire pivoter/désactiverÉlevéL'administrateur de démarrage est censé être temporaire ; le laisser actif indéfiniment est un risque de sécurité des identifiants.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy sur 127.0.0.1:5432 est requis pour la connectivité de la base de données sur GKE ; le désactiver sans chemin TCP alternatif interrompt tous les appels de base de données.
Chemins de sondeTCP sur le port 8080 (par défaut)ÉlevéLe /health de Keycloak se trouve sur le port de gestion 9000, et non 8080 — une sonde HTTP vers 8080/health renvoie toujours 404 et le pod ne devient jamais Prêt même si Keycloak a démarré correctement.
max_instance_count > 1 (mise en cluster de sessions)Vérifier la réplication Infinispan/session avant de s'y fierÉlevéSi la pile de cache de l'image déployée n'est pas réellement distribuée entre les pods (non confirmé — voir §3), les utilisateurs peuvent être redirigés vers un pod sans connaissance de leur session, forçant une réauthentification.
session_affinityClientIPMoyenSans persistance, les requêtes rebondissent entre les pods plus que nécessaire tant que la mise en garde de mise en cluster ci-dessus n'est pas résolue.
application_versionNe jamais rétrograderCritiqueLes migrations de schéma Keycloak sont unidirectionnelles ; une rétrogradation après l'exécution d'une migration peut corrompre le schéma.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer lors des redéploiements, ce qui rompt le DNS et KC_HOSTNAME.
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 — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à Keycloak partagée avec la variante Cloud Run (le build d'image personnalisé, le mappage DB/nom d'hôte du point d'entrée, les secrets et les valeurs par défaut des sondes) est décrite dans Keycloak_Common.

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