From f175d2364756736a08390666e9c28d50c821f1c7 Mon Sep 17 00:00:00 2001
From: Nicholas Kuechler <nicholas.kuechler@rackspace.com>
Date: Wed, 11 Dec 2024 10:23:36 -0600
Subject: [PATCH] docs: adds docs for ceph

---
 docs/user-guide/rook-ceph.md | 24 ++++++++++++++++++++++++
 mkdocs.yml                   |  1 +
 2 files changed, 25 insertions(+)
 create mode 100644 docs/user-guide/rook-ceph.md

diff --git a/docs/user-guide/rook-ceph.md b/docs/user-guide/rook-ceph.md
new file mode 100644
index 000000000..8926721f5
--- /dev/null
+++ b/docs/user-guide/rook-ceph.md
@@ -0,0 +1,24 @@
+# Rook Ceph
+
+UnderStack uses Ceph primarily as an OpenStack Glance backend and for pod volumes.
+
+## Accessing Ceph Dashboard
+
+The Ceph admin dashboard is not exposed publicly so a port-forward needs to be
+created and then you'll be able to access the Ceph UI.
+
+``` bash
+kubectl -n rook-ceph port-forward service/rook-ceph-mgr-dashboard 8443:8443
+```
+
+Once the port-forward is running, you can browse to <https://localhost:8443/> to access the Ceph admin dashboard.
+
+### Getting Ceph admin credentials
+
+Username: `admin`
+
+Password:
+
+``` bash
+kubectl -n rook-ceph get secret rook-ceph-dashboard-password -o jsonpath="{.data.password}" | base64 --decode && echo
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 62793f5b6..316754b96 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -127,4 +127,5 @@ nav:
     - user-guide/monitoring.md
     - user-guide/openstack-ironic.md
     - user-guide/openstack-placement.md
+    - user-guide/rook-ceph.md
   - Workflows: workflows/