Jenkins+Helm部署Spring API网关至GKE遇RoleBinding API版本错误

问题根源 #

你遇到的报错是因为Helm存储的历史release manifest中仍保留着rbac.authorization.k8s.io/v1beta1版本的RoleBinding资源，而Kubernetes 1.20及以上版本已经移除了这个API版本，导致Helm在做版本diff时无法识别旧资源，最终升级失败。即使你现在的Chart清单已经改用v1版本，Helm还是会读取历史记录进行校验。

具体解决步骤 #

1. 验证历史manifest中的旧API资源 #

先确认问题确实出在历史记录里：

helm get manifest <你的release名称> -n <部署的命名空间> | grep "rbac.authorization.k8s.io/v1beta1"

如果输出结果存在，说明历史manifest里确实有旧版本的RBAC资源。

2. 快速修复：用--force参数跳过diff检查 #

如果已经确认新Chart的所有资源都使用了正确的v1 API版本，可以直接用--force参数强制升级，跳过Helm的diff校验步骤：

helm upgrade <你的release名称> <Chart路径或仓库名> -n <部署的命名空间> --force

3. 彻底修复：修改Helm存储的历史release记录 #

如果不想用--force，可以手动修改Helm存储的历史manifest（默认用Secret存储）：

• 找到对应release的Secret：

  kubectl get secrets -n <部署的命名空间> | grep <你的release名称>
  

• 导出Secret内容到文件：

  kubectl get secret <找到的Secret名称> -n <部署的命名空间> -o yaml > release-backup.yaml
  

• 编辑release-backup.yaml，把所有rbac.authorization.k8s.io/v1beta1替换为rbac.authorization.k8s.io/v1
• 删除旧Secret并重新应用修改后的文件：

  kubectl delete secret <找到的Secret名称> -n <部署的命名空间>
  kubectl apply -f release-backup.yaml
  

• 再次执行Helm升级命令即可

4. 兜底方案：卸载后重新安装 #

如果服务允许短暂中断，最直接的方式是卸载旧release后重新安装：

# 卸载旧版本
helm uninstall <你的release名称> -n <部署的命名空间>
# 安装新版本
helm install <你的release名称> <Chart路径或仓库名> -n <部署的命名空间>

额外注意事项 #

• 确认GKE集群本身的版本也是1.20及以上（你只升级了Jenkins slave节点，集群master和worker节点版本也需要匹配）
• 再次检查Chart的所有模板文件，确保所有RBAC相关资源（Role、RoleBinding、ClusterRole、ClusterRoleBinding）都统一使用rbac.authorization.k8s.io/v1版本，没有遗漏的旧引用

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