Upgrade Guide
To upgrade from previous versions of Rook, see the Rook upgrade guide.
Breaking Changes
- The minimum supported version of Kubernetes is v1.25. Upgrade to Kubernetes v1.25 or higher before upgrading Rook.
- The image
repository
andtag
settings are specified separately in the helm chart values.yaml for the CSI images. Helm users previously specifying the CSI images with theimage
setting will need to update their values.yaml with the separaterepository
andtag
settings. - Rook is beginning the process of deprecating CSI network "holder" pods. If there are pods named
csi-*plugin-holder-*
in the Rook operator namespace, see the holder pod deprecation documentation to disable them. Migration of affected clusters is optional for v1.14, but will be required in a future release. - The Rook operator config
CSI_ENABLE_READ_AFFINITY
was removed. v1.13 clusters that have modified this value to be"true"
must set the option as desired in each CephCluster as documented here before upgrading to v1.14.
Features
- Kubernetes versions v1.25 through v1.29 are supported. K8s v1.30 will be supported as soon as released.
- Ceph daemon pods using the
default
service account now use a newrook-ceph-default
service account. - A custom Ceph
application
can be applied to a CephBlockPool CR. - Object stores can be created with shared metadata and data pools. Isolation between object stores is enabled via RADOS namespaces. This configuration is recommended to limit the number of pools when multiple object stores are created.
- Support for VolumeSnapshotGroup is available for the RBD and CephFS CSI drivers.
- Support for virtual style hosting for s3 buckets is added in the CephObjectStore, by adding hosting.dnsNames to the object store.
- A static prefix can be specified for the CSI drivers and OBC provisioner (the default prefix is the
rook-ceph
namespace). - Azure Key Vault KMS support is added for storing OSD encryption keys.
- Additional status columns added to the
kubectl
output for Rook CRDs.