Bitnami部署的Keycloak v20.0.5升级Infinispan至14.0.10方法咨询

前提准备 #

• 备份Keycloak配置文件、数据库及Infinispan缓存数据（用于升级失败时回滚）
• 确认Keycloak v20.0.5与Infinispan 14.0.10的兼容性（官方文档明确v20.x适配Infinispan 14.x）

场景1：Bitnami容器化部署（Docker/K8s） #

步骤1：停止当前Infinispan实例 #

• Docker环境：docker stop <infinispan-container-name>
• Kubernetes环境：kubectl scale statefulset <infinispan-statefulset-name> --replicas=0

步骤2：替换Infinispan镜像版本 #

• Docker环境：修改docker-compose.yml中Infinispan镜像为bitnami/infinispan:14.0.10，执行docker-compose up -d infinispan启动新实例
• Kubernetes环境：修改Infinispan StatefulSet的镜像字段为bitnami/infinispan:14.0.10，执行kubectl apply -f <infinispan-statefulset-yaml>更新配置，再恢复副本数：kubectl scale statefulset <infinispan-statefulset-name> --replicas=<原副本数>

步骤3：更新Keycloak缓存配置 #

• 检查容器内Keycloak配置文件（路径通常为/opt/bitnami/keycloak/conf/keycloak.conf），确认Infinispan的连接地址、认证信息无误
• 若使用自定义cache-ispn.xml，需调整配置适配Infinispan 14.x语法（比如部分废弃参数替换）
• 重启Keycloak实例：
  • Docker：docker restart <keycloak-container-name>
  • Kubernetes：kubectl rollout restart deployment <keycloak-deployment-name>

步骤4：验证升级结果 #

• 登录Keycloak管理控制台，进入Realm Settings > Cache检查缓存状态
• 查看Infinispan日志确认无启动报错：
  • Docker：docker logs <infinispan-container-name>
  • Kubernetes：kubectl logs <infinispan-pod-name>

场景2：Bitnami虚拟机/裸机包部署 #

步骤1：停止相关服务 #

sudo systemctl stop keycloak
sudo systemctl stop infinispan

步骤2：安装Infinispan 14.0.10 Bitnami包 #

• 下载对应系统架构的Infinispan 14.0.10 Bitnami安装包
• 执行安装（选择与原Infinispan相同的安装目录，提前备份原目录）：

chmod +x bitnami-infinispan-14.0.10-<platform>-x64-installer.run
sudo ./bitnami-infinispan-14.0.10-<platform>-x64-installer.run

步骤3：迁移原配置文件 #

• 将原Infinispan的infinispan.xml、认证配置等文件复制到新安装目录
• 检查配置文件，替换Infinispan 14.x中废弃的参数

步骤4：更新Keycloak缓存配置 #

• 编辑/opt/bitnami/keycloak/conf/keycloak.conf，确认cache设置为ispn，且Infinispan连接参数正确
• 若使用自定义cache-ispn.xml，更新文件适配Infinispan 14.x语法

步骤5：启动服务并验证 #

sudo systemctl start infinispan
sudo systemctl start keycloak

• 查看服务状态：sudo systemctl status infinispan keycloak
• 检查日志排查异常：
  • Infinispan日志路径：/opt/bitnami/infinispan/logs
  • Keycloak日志路径：/opt/bitnami/keycloak/logs

注意事项 #

• 升级后若出现缓存连接失败，优先检查Infinispan与Keycloak的认证配置（用户名/密码）是否一致
• 分布式缓存集群需确保所有Infinispan节点完成升级后，再重启Keycloak
• Infinispan 14.x中distributed-cache部分参数默认值有变化，需根据业务需求调整

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