rook-ceph-operator

Deploy and manage Rook-Ceph storage clusters via CephCluster, CephBlockPool, and related CRDs.

4|2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill rook-ceph-operator-aidas-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rook-ceph-operator
Source: https://github.com/Aidas-dev/k8s-agent-skills/tree/main/skills/rook-ceph-operator
Command: npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill rook-ceph-operator-aidas-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring Rook-Ceph storage on Kubernetes involves many CRDs, Helm charts, and version-specific breaking changes (like the v1.20 CSI driver split) that commonly cause PVC provisioning failures and data-loss mistakes. ## Core Features & Use Cases - CRD Reference: Covers CephCluster, CephBlockPool, CephFilesystem, CephObjectStore, CephNFS, CephRBDMirror, and supporting resources with key spec fields. - v1.20 Upgrade Guidance: Documents the ceph-csi-drivers chart requirement, driver name matching with StorageClasses, and known issues like leader election and RBAC bugs. - Use Case: You need RWX shared storage for a workload. Use this Skill to create a CephFilesystem with correct metadata/data pools, MDS placement, and a matching StorageClass, while avoiding pitfalls like preservePoolsOnDelete defaults. ## Quick Start Ask the agent to create a CephBlockPool with host failure domain and a matching StorageClass for the rook-ceph cluster.

Frequently Asked Questions about rook-ceph-operator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Rook-Ceph on Kubernetes with Helm?▼

Install charts in order: rook-ceph operator first, then ceph-csi-drivers, then rook-ceph-cluster. In v1.20 the CSI drivers moved to a separate chart, so skipping ceph-csi-drivers breaks all PVC provisioning.

How do I create a CephBlockPool with a StorageClass?▼

Define a CephBlockPool with spec.failureDomain, spec.replicated.size, and spec.deviceClass. Rook automatically creates a StorageClass using the rook-ceph.rbd.csi.ceph.com provisioner for PVC consumption.

Why are PVCs stuck pending after upgrading to Rook v1.20?▼

Rook v1.20 delegates CSI drivers to the ceph-csi-drivers chart. If driver names don't match your StorageClass provisioners (e.g., rook-ceph.rbd.csi.ceph.com), or leader-election RBAC is missing, provisioning hangs.

What is the difference between CephBlockPool and CephFilesystem?▼

CephBlockPool provides RBD block storage for single-node PVC mounts, while CephFilesystem provides CephFS shared storage supporting ReadWriteMany access. CephFS requires MDS daemons and separate metadata and data pools.

Does deleting a CephFilesystem CRD delete my data?▼

Yes, by default deleting the CRD removes the underlying pools and all data. Set preservePoolsOnDelete: true on the filesystem spec to retain data when the custom resource is removed.