KServe项目关于kube-rbac-proxy镜像迁移的技术通告

随着Google Cloud Registry（GCR）服务即将在2025年3月18日停止服务，KServe项目组需要提醒所有用户注意一个重要变更：当前使用的gcr.io/kubebuilder/kube-rbac-proxy镜像将在此日期后不可用。作为KServe的核心组件之一，这一变更将影响所有现网部署，需要用户及时采取行动。

背景说明

kube-rbac-proxy是Kubernetes生态中广泛使用的RBAC代理组件，主要用于处理基于角色的访问控制。在KServe的架构中，它承担着重要的安全认证功能。目前项目中使用的是托管在Google GCR仓库的镜像版本。

根据Google官方公告，所有GCR仓库都将在2025年3月18日后停止服务。这意味着届时任何尝试拉取该镜像的操作都将失败，导致依赖该组件的服务出现异常。

影响范围

这一变更将影响：

1. 所有使用默认配置部署的KServe实例
2. 任何直接或间接依赖gcr.io/kubebuilder/kube-rbac-proxy镜像的自定义部署
3. 使用较旧版本KServe且未及时升级的系统

解决方案

项目组已经确定了两种可行的迁移方案：

方案一：完全移除依赖

通过重构代码逻辑，彻底移除对kube-rbac-proxy的依赖。这种方式最为彻底，但需要较大的架构调整。

方案二：迁移到替代镜像

将依赖迁移到官方推荐的替代镜像quay.io/brancz/kube-rbac-proxy。这是kube-rbac-proxy项目的官方维护版本，功能完全兼容。

经过评估，KServe项目组已经选择方案二作为主要迁移路径，并在最新版本中完成了相关变更。

用户操作指南

对于不同场景的用户，建议采取以下措施：

1. 新部署用户： 直接使用KServe最新版本，已内置正确的镜像配置。

2. 现有部署用户：

   • 检查当前部署中是否包含对gcr.io/kubebuilder/kube-rbac-proxy的引用
   • 制定升级计划，在2025年3月前完成迁移
   • 测试环境先行验证，确保兼容性

3. 定制化部署用户： 需要手动修改部署配置，将所有相关镜像引用更新为quay.io/brancz/kube-rbac-proxy

技术细节

迁移过程中需要注意：

• 新老镜像的版本对应关系
• 可能存在的配置参数差异
• 监控指标的兼容性
• 性能基准测试

建议用户在测试环境中充分验证后再进行生产环境部署。

时间规划

为确保平稳过渡，建议用户按照以下时间表行动：

• 2024年Q3：评估影响，制定迁移计划
• 2024年Q4：测试环境验证
• 2025年Q1：生产环境部署

结语

镜像仓库变更虽然看似简单，但可能对生产系统造成重大影响。KServe项目组建议所有用户重视此次变更，尽早规划迁移工作。如有任何技术问题，可通过社区渠道寻求支持。

项目组将持续关注相关进展，并在必要时提供额外指导。用户的安全和系统稳定性是我们的首要考虑。