发布日期: 2026-01-20
版本号: v1.19.0

从旧版Rook升级需参考升级指南,主要破坏性变更包括:支持的Kubernetes版本范围为v1.30至v1.35,Ceph最低支持版本提升至v19.2.0,运行旧版Ceph的集群需先行升级;CephFilesystem CRD中的activeStandby属性行为调整,设为false时将直接缩减并移除备用MDS守护进程;Helm图表中Ceph镜像配置方式变更,允许单独设置仓库与标签;外部模式下若提供管理员密钥环,将不再自动创建CSI客户端。新功能方面,实验性支持通过NVMe/TCP协议暴露RBD卷,提升块存储访问性能;集成CephCSI v3.16,增强RBD与CephFS卷的节点故障保护、支持块卷使用统计及加密配置;实验性允许同一操作器并发协调多个CephCluster资源,需设置操作器参数启用;控制器日志增加了命名空间标识以提升排障一致性。

更新内容 (中文)

升级指南

如需从Rook旧版本升级,请参阅 Rook升级指南

不兼容变更

  • 支持的Kubernetes版本范围为v1.30至v1.35
  • 最低支持的Ceph版本为v19.2.0。运行Ceph v18的Rook v1.18集群在升级Rook前必须先升级至Ceph v1.2.0或更高版本
  • CephFilesystem自定义资源中的activeStandby属性行为已变更。当设为false时,备用MDS守护进程部署将被缩减并移除,而非仅在守护进程运行时禁用备用缓存
  • Helm图表:rook-ceph-cluster图表中Ceph镜像定义位置已调整,现支持仓库与标签的独立设置。详情参见 Rook升级指南
  • 外部模式下,当用户提供Ceph管理员密钥环给Rook时,Rook将不再自动创建CSI Ceph客户端。该方案可通过相同的外部Python脚本提供更一致的外置集群配置方式

新功能

  • 实验性功能:NVMe over Fabrics(NVMe-oF)允许通过NVMe/TCP协议暴露和访问RBD卷。这使得集群内的Kubernetes Pod与集群外部的客户端均可使用标准NVMe-oF启动器连接Ceph块存储,实现网络高性能块存储访问。参见 NVMe-oF配置指南 开始使用
  • CephCSI v3.16集成:
    • 支持通过NVMe over Fabrics协议配置和挂载卷的NVMe-oF CSI驱动
    • 增强了节点故障场景下RBD和CephFS卷的防护机制
    • 块卷使用统计功能
    • 可配置的块加密算法
  • 实验性功能:允许在同一个Rook算子管理多个集群时并行协调CephCluster自定义资源。通过将算子配置ROOK_RECONCILE_CONCURRENT_CLUSTERS值设为大于1即可启用并发处理
  • 为控制器添加带命名空间标识的日志信息,提升rook算子日志的排障一致性

更新内容 (原始)

Upgrade Guide

To upgrade from previous versions of Rook, see the Rook upgrade guide.

Breaking Changes

  • The supported Kubernetes versions are v1.30 - v1.35
  • The minimum supported Ceph version is v19.2.0. Rook v1.18 clusters running Ceph v18 must upgrade to Ceph v19.2.0 or higher before upgrading Rook.
  • The behavior of the activeStandby property in the CephFilesystem CRD has changed. When set to false, the standby MDS daemon deployment will be scaled down and removed, rather than only disabling the standby cache while the daemon remains running.
  • Helm: The rook-ceph-cluster chart has changed where the Ceph image is defined, to allow separate settings for the repository and tag. For more details, see the Rook upgrade guide.
  • In external mode, when users provide a Ceph admin keyring to Rook, Rook will no longer create CSI Ceph clients automatically. This approach will provide more consistency to configure external mode clusters via the same external Python script.

Features

  • Experimental: NVMe over Fabrics (NVMe-oF) allows RBD volumes to be exposed and accessed via the NVMe/TCP protocol. This enables both Kubernetes pods within the cluster and external clients outside the cluster to connect to Ceph block storage using standard NVMe-oF initiators, providing high-performance block storage access over the network. See the NVMe-oF Configuration Guide to get started.
  • CephCSI v3.16 Integration:
    • NVMe-oF CSI driver for provisioning and mounting volumes over the NVMe over Fabrics protocol
    • Improved fencing for RBD and CephFS volumes during node failure
    • Block volume usage statistics
    • Configurable block encryption cipher
  • Experimental: Allow concurrent reconciles of the CephCluster CR when there multiple clusters being managed by the same Rook operator. Concurrency is enabled by increasing the operator setting ROOK_RECONCILE_CONCURRENT_CLUSTERS to a value greater than 1.
  • Improved logging with namespaced names for the controllers for more consistency in troubleshooting the rook operator log.

下载链接