docs: restore and update storage documentation

docs/.vitepress/config.mts

@@ -34,7 +34,6 @@ export default withMermaid({
           { text: 'OpenStack', link: '/openstack/' },
           { text: 'Storage', link: '/storage/' },
           { text: 'Networking', link: '/networking/' },
-          { text: 'Observability', link: '/observability/' },
           { text: 'Management', link: '/management/' },
           { text: 'API Reference', link: '/api/' },
         ],
@@ -128,16 +127,6 @@ export default withMermaid({
         useFolderTitleFromIndexFile: true,
         sortMenusByFrontmatterOrder: true,
       },
-      {
-        documentRootPath: '/docs/',
-        scanStartPath: 'observability',
-        resolvePath: '/observability/',
-        capitalizeFirst: false,
-        useTitleFromFrontmatter: true,
-        useFolderLinkFromIndexFile: true,
-        useFolderTitleFromIndexFile: true,
-        sortMenusByFrontmatterOrder: true,
-      },
       {
         documentRootPath: '/docs/',
         scanStartPath: 'management',

docs/getting-started/full-deployment.md

@@ -80,9 +80,9 @@ Follow the [Minimal Environment](/getting-started/minimal) guide first to unders
 
 ### Observability layer
 
-- [ ] Prysm deployed and collecting events - see [Observability - Prysm](/observability/prysm)
-- [ ] Prometheus scraping all targets - see [Observability - Prometheus](/observability/prometheus)
-- [ ] Perses dashboards deployed - see [Observability - Perses](/observability/perses)
+- [ ] Prysm deployed and collecting events - see [Observability - Prysm](/storage/observability/prysm)
+- [ ] Prometheus scraping all targets - see [Observability - Prometheus](/storage/observability/prometheus)
+- [ ] Perses dashboards deployed - see [Observability - Perses](/storage/observability/perses)
 - [ ] Alerting rules configured and routing verified
 
 ### Management layer

docs/getting-started/minimal.md

@@ -90,10 +90,93 @@ helm repo update
 
 helm install rook-ceph rook-release/rook-ceph \
   --namespace rook-ceph \
-  --create-namespace
+  --create-namespace \
+  --version v1.20.7 \
+  --wait
+
+helm repo add ceph-csi-operator https://ceph.github.io/ceph-csi-operator
+helm repo update
+helm install ceph-csi-drivers ceph-csi-operator/ceph-csi-drivers \
+  --namespace rook-ceph \
+  --version 1.0.4 \
+  --wait \
+  -f https://raw.githubusercontent.com/rook/rook/v1.20.7/deploy/charts/ceph-csi-drivers/values.yaml
+```
+
+Create `minimal-ceph-cluster.yaml`, replacing `k3s-node` and `sdb` with the
+Kubernetes node name and the dedicated raw device in your lab:
+
+```yaml
+apiVersion: ceph.rook.io/v1
+kind: CephCluster
+metadata:
+  name: rook-ceph
+  namespace: rook-ceph
+spec:
+  dataDirHostPath: /var/lib/rook
+  cephVersion:
+    image: quay.io/ceph/ceph:v20.2.4
+  mon:
+    count: 1
+    allowMultiplePerNode: true
+  mgr:
+    count: 1
+    allowMultiplePerNode: true
+  storage:
+    useAllNodes: false
+    useAllDevices: false
+    nodes:
+    - name: k3s-node
+      devices:
+      - name: sdb
+  cephConfig:
+    global:
+      osd_pool_default_size: "1"
+      mon_warn_on_pool_no_redundancy: "false"
+---
+apiVersion: ceph.rook.io/v1
+kind: CephBlockPool
+metadata:
+  name: replicapool
+  namespace: rook-ceph
+spec:
+  replicated:
+    size: 1
+    requireSafeReplicaSize: false
+---
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: rook-ceph-block
+provisioner: rook-ceph.rbd.csi.ceph.com
+parameters:
+  clusterID: rook-ceph
+  pool: replicapool
+  imageFormat: "2"
+  imageFeatures: layering
+  csi.storage.k8s.io/provisioner-secret-name: rook-csi-rbd-provisioner
+  csi.storage.k8s.io/provisioner-secret-namespace: rook-ceph
+  csi.storage.k8s.io/controller-expand-secret-name: rook-csi-rbd-provisioner
+  csi.storage.k8s.io/controller-expand-secret-namespace: rook-ceph
+  csi.storage.k8s.io/controller-publish-secret-name: rook-csi-rbd-provisioner
+  csi.storage.k8s.io/controller-publish-secret-namespace: rook-ceph
+  csi.storage.k8s.io/node-stage-secret-name: rook-csi-rbd-node
+  csi.storage.k8s.io/node-stage-secret-namespace: rook-ceph
+  csi.storage.k8s.io/fstype: ext4
+allowVolumeExpansion: true
+reclaimPolicy: Delete
+```
+
+The device must be unformatted, unmounted, and dedicated to this disposable
+test cluster. Apply the manifest and wait for Ceph to become ready:
+
+```bash
+kubectl apply -f minimal-ceph-cluster.yaml
+kubectl -n rook-ceph wait --for=condition=Ready cephcluster/rook-ceph --timeout=15m
 ```
 
-Then deploy a minimal single-node `CephCluster`. See [Storage - Rook](/storage/rook) for the full cluster configuration.
+This single-node configuration is for testing only. See [Storage - Rook](/storage/rook)
+for the production three-node cluster configuration.
 
 ## Step 5: Deploy OpenStack
 

docs/management/greenhouse.md

@@ -22,4 +22,4 @@ Greenhouse aggregates operational views from multiple tools - Prometheus, Perses
 
 - [Greenhouse documentation](https://cloudoperators.github.io/greenhouse/)
 - [Greenhouse GitHub](https://github.com/cloudoperators/greenhouse)
-- [Observability](/observability/) - Prometheus and Perses, which Greenhouse surfaces
+- [Observability](/storage/observability/) - Prometheus and Perses, which Greenhouse surfaces

docs/overview/architecture.md

@@ -42,7 +42,9 @@ The infrastructure data plane - the raw execution environment for virtual machin
 
 ## Observability
 
-Cross-cutting. [Prysm](/observability/prysm) collects audit and operational events. [Prometheus](/observability/prometheus) scrapes metrics from all layers. [Perses](/observability/perses) provides dashboards.
+Cross-cutting. [Prysm](/storage/observability/prysm) collects audit and operational
+events. [Prometheus](/storage/observability/prometheus) scrapes metrics from all
+layers. [Perses](/storage/observability/perses) provides dashboards.
 
 ## OpenStack
 

docs/overview/index.md

@@ -36,4 +36,4 @@ CobaltCore is for teams that:
 - **[Architecture](/overview/architecture)** - understand how the layers fit together
 - **[Why CobaltCore](/overview/why)** - the reasoning behind the design decisions
 - **[Showroom](/showroom/)** - live examples and demos of CobaltCore in action
-- Layer sections (**Platform**, **Compute**, **OpenStack**, **Storage**, **Networking**, **Observability**, **Management**) - deep-dive reference for each part of the stack
+- Layer sections (**Platform**, **Compute**, **OpenStack**, **Storage**, **Networking**, **Management**) - deep-dive reference for each part of the stack. Storage includes the observability documentation.