如何在Kubernetes中配置Keycloak实现多realm导入

你遇到的JSON解析报错是因为Keycloak默认将导入的配置文件识别为单realm对象，当你传入多realm数组格式时，需要显式指定singleFile导入模式才能正常解析，具体操作步骤如下：

1. 调整ConfigMap中的realm配置 #

确保你的多realm配置是合法JSON数组，无多余尾逗号、引号配对错误等语法问题，参考格式：

[
  {
    "realm": "realm1",
    "enabled": true,
    // 其余realm1原有配置
  },
  {
    "realm": "realm2",
    "enabled": true,
    // realm2配置
  },
  {
    "realm": "realm3",
    "enabled": true,
    // realm3配置
  },
  {
    "realm": "realm4",
    "enabled": true,
    // realm4配置
  }
]

更新原有存储realm配置的ConfigMap即可。

2. 修改Deployment配置注入启动参数 #

Keycloak支持通过JAVA_OPTS_APPEND环境变量追加JVM启动参数，不需要修改原有容器启动命令，修改后的Deployment配置示例如下，保留你原有配置的其他部分即可：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: keycloak
spec:
  replicas: 1
  template:
    spec:
      containers:
      - name: keycloak
        image: jboss/keycloak:12.0.4
        env:
          # 追加多realm导入所需JVM参数
          - name: JAVA_OPTS_APPEND
            value: >-
              -Dkeycloak.migration.provider=singleFile
              -Dkeycloak.migration.file=/opt/jboss/keycloak/imports/realm-config.json
              -Dkeycloak.migration.strategy=IGNORE_EXISTING
          # 保留你原有的其他环境变量，例如KEYCLOAK_USER、KEYCLOAK_PASSWORD等
        volumeMounts:
          # 保留原有ConfigMap挂载配置，确保挂载路径和上面migration.file指定的路径一致
          - mountPath: /opt/jboss/keycloak/imports/
            name: realm-config
      volumes:
        - name: realm-config
          configMap:
            # 替换为你实际使用的ConfigMap名称
            name: keycloak-realm-config

参数说明：

• keycloak.migration.file：需要和你ConfigMap挂载后的realm配置文件完整路径完全一致
• keycloak.migration.strategy：可选值为IGNORE_EXISTING（已存在的realm不覆盖）、OVERWRITE_EXISTING（覆盖已存在的realm），根据你的需求选择即可

3. 生效配置 #

重新apply修改后的Deployment和ConfigMap即可，容器启动后会自动导入所有realm配置。

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