发布日期: 2026-06-02
版本号: v1.20.0

要升级Rook，请参考官方升级指南。本次更新的重要破坏性变更是Ceph CSI operator现在成为管理CSI驱动设置的必需组件，升级会保留原有设置，但后续修改需由管理员通过新的Ceph CSI CRD完成，配置位置已从原配置映射和Helm chart中移除。新安装和Helm用户需通过专门的CSI算子配置进行设置。
主要功能更新包括：支持Kubernetes v1.31至v1.36；新增SSE-S3与Vault Agent集成的加密支持；自动清理未使用的CRUSH规则（可配置关闭）；并发协调多集群功能已稳定；容器协调逻辑改为按名称识别以增强稳定性；支持基于主机的加密OSD扩容；新增实验性RGW账户管理功能；支持双节点集群，允许监视器节点间浮动迁移。

更新内容 （中文）

升级指南

如需从之前版本的 Rook 进行升级，请参阅 Rook 升级指南。

破坏性变更

  • 管理 CSI 驱动设置现在需要 Ceph CSI 算子。
    • 升级将继续使用 Rook 之前应用的现有设置。CSI 设置的后续更新需要由 Rook 管理员完成。具有默认 CSI 设置的集群无需自定义。
    • CSI 设置已从 Rook 算子配置图 rook-ceph-operator-config 和 rook-ceph Helm Chart 中移除。
    • 新安装必须使用 Ceph-CSI 的 OperatorConfig 和 Driver CR 配置 CSI 设置。默认设置包含在 operator.yaml 中。有关自定义 CSI 设置的更多详情和示例，请参阅 CSI 配置。
    • 对于 Helm 用户，Ceph CSI 算子设置由 ceph-csi-drivers chart 配置。自定义 CSI 镜像仍由 rook-ceph chart values 配置。

功能特性

  • 支持的 Kubernetes 版本为 v1.31 至 v1.36。
  • 支持与 Vault Agent 结合使用 SSE-S3：新增了使用 HashiCorp Vault Agent 认证进行 SSE-S3 服务器端加密的支持。更多详情请参阅 CephObjectStore 安全设置。
  • 未使用的 CRUSH 规则清理：现在 Rook 在 Ceph 管理器启动后默认会删除未使用的 CRUSH 规则。如果不应删除未使用的 CRUSH 规则，请在算子配置中将 ROOK_DELETE_UNUSED_CRUSH_RULES 设置为 false。
  • 通过设置 ROOK_RECONCILE_CONCURRENT_CLUSTERS 并行协调多个 Ceph 集群的功能现已宣布稳定。
  • Pod 内的容器现在一致地按名称进行协调，而不是依赖于它们的声明顺序。这是一项防御性措施，旨在应对因变更 Webhook 操作而导致的声明顺序变化。
  • 针对基于加密主机的 OSD 进行 OSD 扩容：对于使用主机（非 PVC）集群的加密 OSD（encryptedDevice: true），调整底层磁盘大小现在会自动扩展加密的 OSD。
  • RGW 账户（实验性）：CephObjectStoreAccount CRD 用于管理 RGW 账户。在 CephObjectStoreUser 中新增了 accountRef 字段，用于将用户与账户关联。此功能目前仅可使用 Ceph 主分支镜像（quay.ceph.io/ceph-ci/ceph:main）进行测试。更多详情请参阅 对象存储账户 文档。
  • 两节点集群（实验性）：Rook 允许一个“浮动”监视器在两个节点之间迁移，以防其中一个节点宕机。

更新内容 （原始）

Upgrade Guide

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

Breaking Changes

  • The Ceph CSI operator is required for managing CSI driver settings.
    • Upgrades will continue working with the existing settings that had been applied by Rook previously. Further updates to CSI settings will need to be updated by the Rook admin. Clusters with default CSI settings do not require customizations.
    • CSI settings are removed from the Rook operator configmap rook-ceph-operator-config and the rook-ceph Helm chart.
    • New installs must configure the CSI settings with the Ceph-CSI OperatorConfig and Driver CRs. Default settings are included in operator.yaml. For custom CSI settings, see the CSI Configuration for more details and examples.
    • For helm users, the Ceph CSI operator settings are configured by the ceph-csi-drivers chart. Custom CSI images remain configured by the rook-ceph chart values.

Features

  • Supported Kubernetes versions are v1.31 through v1.36.
  • SSE-S3 with Vault Agent: Added support for server-side encryption with SSE-S3 using HashiCorp Vault Agent authentication. See the CephObjectStore Security Settings for more details.
  • Unused CRUSH rule cleanup: Rook now deletes unused CRUSH rules by default after the Ceph mgr starts. If unused CRUSH rules should not be deleted, set ROOK_DELETE_UNUSED_CRUSH_RULES to false in the operator config.
  • Concurrently reconciling multiple Ceph Clusters with the setting ROOK_RECONCILE_CONCURRENT_CLUSTERS is declared stable.
  • Containers within a pod are now consistently reconciled by name instead of relying on the order in which they are declared. This is a defensive measure against the declaration order changing due to manipulation by a mutating webhook.
  • OSD resize with encrypted host-based OSDs: For encrypted OSDs (with encryptedDevice: true) with host-based (non-PVC) clusters, resizing the underlying disk now automatically expands encrypted OSDs.
  • RGW Accounts (Experimental): The CephObjectStoreAccount CRD manages RGW accounts. The accountReffield is added inCephObjectStoreUser to associate users with accounts. This feature is currently only testable with the Ceph main branch image (quay.ceph.io/ceph-ci/ceph:main`). See the Object Store Accounts documentation for more details.
  • Two-node clusters (Experimental): Rook allows a “floating” mon to migrate between the two nodes in case one node is down.

下载链接