Keycloak Operator v21.1.1绑定外部PostgreSQL数据库报错排查

问题场景 #

通过OperatorHub安装Keycloak Operator后，使用以下自定义资源（CR）配置绑定外部Azure PostgreSQL数据库：

apiVersion: k8s.keycloak.org/v2alpha1
kind: Keycloak
metadata:
  name: keycloak-prod
spec:
  instances: 1
  db:
    vendor: postgresql
    url: jdbc:postgresql://aksdev-pgdb.postgres.database.azure.com:5432/keycloakdevDB
    host: aksdev-pgdb.postgres.database.azure.com
    database: keycloakdevDB
    port: 5432
    schema: public
    usernameSecret:
      name: keycloak-db-secret
      key: username
    passwordSecret:
      name: keycloak-db-secret
      key: password

应用后Pod陷入CrashLoopBackOff状态，日志输出包含ERROR: Failed to run 'build' command. ERROR: No value present。

报错原因与核心问题分析 #

这个错误的核心原因是Keycloak Operator v2alpha1版本的CRD规则中，数据库配置的url与host/database/port参数为互斥关系，不能同时配置。当你同时提供完整JDBC URL和拆分的主机/数据库/端口信息时，Operator的参数解析逻辑会出现冲突，无法确定使用哪一组配置，最终触发"No value present"的缺失值报错。

另外需要注意：Azure PostgreSQL默认强制SSL连接，当前CR中未配置SSL相关参数，即使解决上述冲突，后续仍可能出现数据库连接失败的问题。

修复方案 #

1. 清理冲突的数据库配置：
   选择以下两种配置方式之一即可：
   • 方式一：保留url，移除host、database、port字段，同时添加SSL参数

     apiVersion: k8s.keycloak.org/v2alpha1
     kind: Keycloak
     metadata:
       name: keycloak-prod
     spec:
       instances: 1
       db:
         vendor: postgresql
         url: jdbc:postgresql://aksdev-pgdb.postgres.database.azure.com:5432/keycloakdevDB?sslmode=require
         schema: public
         usernameSecret:
           name: keycloak-db-secret
           key: username
         passwordSecret:
           name: keycloak-db-secret
           key: password
     

   • 方式二：保留host、database、port，移除url字段，并显式配置SSL

     apiVersion: k8s.keycloak.org/v2alpha1
     kind: Keycloak
     metadata:
       name: keycloak-prod
     spec:
       instances: 1
       db:
         vendor: postgresql
         host: aksdev-pgdb.postgres.database.azure.com
         database: keycloakdevDB
         port: 5432
         schema: public
         ssl: required
         usernameSecret:
           name: keycloak-db-secret
           key: username
         passwordSecret:
           name: keycloak-db-secret
           key: password
     

2. 确认Secret有效性：确保keycloak-db-secret已在同一命名空间下创建，且包含username和password两个Key，对应的值为Azure PostgreSQL的正确登录凭据。

内容的提问来源于stack exchange，提问作者Adarsh Vyas