Skip to content

Commit 0cee50f

Browse files
committed
Docs: Add Rook Page
Add a page explaining Rook's role in the CobaltCore ecosystem as it relates to Ceph. Signed-off-by: Zac Dover <zac.dover@clyso.com>
1 parent 2b6c0d1 commit 0cee50f

1 file changed

Lines changed: 37 additions & 0 deletions

File tree

docs/architecture/rook.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: Rook
3+
---
4+
5+
# Rook
6+
7+
Rook is an open-source cloud-native storage orchestrator that automates the
8+
deployment, configuration, and management of [Ceph](./ceph.md) storage clusters
9+
within Kubernetes environments. Built as a Kubernetes operator, Rook extends
10+
Kubernetes with custom resource definitions (CRDs) that allow administrators to
11+
define and manage Ceph clusters using native Kubernetes APIs and tools.
12+
13+
Rook eliminates much of the operational complexity traditionally associated
14+
with running Ceph by leveraging Kubernetes primitives for scheduling,
15+
self-healing, and scaling. When deployed, Rook runs as a set of pods within the
16+
Kubernetes cluster, managing the lifecycle of Ceph daemons (monitors, managers,
17+
OSDs, MDS, and RGW) as containerized workloads. It automatically handles tasks
18+
such as OSD provisioning from available storage devices, the management of the
19+
monitor quorum, and disaster recovery.
20+
21+
The system provides declarative configuration through YAML manifests, enabling
22+
infrastructure-as-code practices for storage management. Administrators can
23+
define storage classes that map to Ceph pools, allowing applications to
24+
dynamically provision persistent volumes for block storage (RBD), shared file
25+
systems (CephFS), or object storage (RGW) through standard Kubernetes
26+
mechanisms.
27+
28+
Rook continuously monitors cluster health and automatically responds to
29+
failures by restarting failed daemons, replacing unhealthy OSDs, and
30+
maintaining desired state as defined in the cluster specifications. It
31+
integrates with [Kubernetes](./cluster.md) monitoring and logging systems,
32+
providing visibility into storage operations alongside application workloads.
33+
34+
## See Also
35+
1. [The rook.io page](https://rook.io/)
36+
1. [The Rook Documentation](https://rook.io/docs/rook/latest-release/Getting-Started/intro/)
37+
1. [The Rook project repository](https://github.com/rook/rook)

0 commit comments

Comments
 (0)