From 796bc62422fe12f5f23ed74835f8c3f23a1aae36 Mon Sep 17 00:00:00 2001
From: Boekhorst <boekhorst@b1-systems.de>
Date: Wed, 25 Sep 2024 09:53:48 +0200
Subject: [PATCH] feat: add docs for osism and scs websites

Signed-off-by: Boekhorst <boekhorst@b1-systems.de>
---
 docs/configuration-guide/rookify.md | 46 +++++++++++++++++++++++++++++
 docs/deploy-guide/rookify.md        | 17 +++++++++++
 docs/operations-guide/rookify.md    | 15 ++++++++++
 3 files changed, 78 insertions(+)
 create mode 100644 docs/configuration-guide/rookify.md
 create mode 100644 docs/deploy-guide/rookify.md
 create mode 100644 docs/operations-guide/rookify.md

diff --git a/docs/configuration-guide/rookify.md b/docs/configuration-guide/rookify.md
new file mode 100644
index 0000000..9a38219
--- /dev/null
+++ b/docs/configuration-guide/rookify.md
@@ -0,0 +1,46 @@
+---
+sidebar_label: Configure Rookify: Migrate to Rook from Ceph Ansible (technical preview)
+sidebar_position: 31
+---
+
+# Configure Rookify: Migrate from Ceph Ansible to Rook (Technical Preview)
+
+The [Rookify GitHub repository](https://github.com/SovereignCloudStack/rookify) includes a README.md that provides a condensed summary of the information covered here.
+
+Rookify is developed to migrate from Ceph-Ansible to Rook _in place_ and _without downtime_.
+
+Nevertheless, it is **strongly advised** to test Rookify in a controlled environment beforehand, such as the [OSISM testbed](https://github.com/osism/testbed). Additionally, ensure that all precautionary backups are taken, and any other necessary safety measures are in place.
+
+## Config.yaml
+
+The primary configuration file for Rookify is `config.yaml`. The repository contains an example file for general use, as well as one specifically tailored to the OSISM testbed setup:
+
+- [config.example.yaml](https://github.com/SovereignCloudStack/rookify/blob/main/config.example.yaml)
+- [config.example.osism.yaml](https://github.com/SovereignCloudStack/rookify/blob/main/config.example.osism.yaml)
+
+### Parameters
+
+```yaml
+general:
+  machine_pickle_file: data.pickle
+```
+
+The general section allows for optional definition of a pickle file, which allows for saving the state of the migration as serialized objects on disk. The pickle filed can be named as pleased.
+
+```yaml
+logging:
+  level: INFO # level at which logging should start
+  format:
+    time: "%Y-%m-%d %H:%M.%S" # other example: "iso"
+    renderer: console # or: json
+```
+
+The `logging` section allows for specification of `structlog`. The `level` parameter can be set to all python [log-levels](https://docs.python.org/3/library/logging.html#logging-levels), i.e. `NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAl`, but it is recommended to use `INFO`.
+
+```yaml
+ceph:
+  config: ./.ceph/ceph.conf
+  keyring: ./.ceph/ceph.client.admin.keyring
+```
+
+The `ceph` section specifies the `ceph.conf` and `ceph.client.admin.keyring` of the target systems (i.e. the system where Ceph-Ansible needs to be migrated to Rook).
diff --git a/docs/deploy-guide/rookify.md b/docs/deploy-guide/rookify.md
new file mode 100644
index 0000000..b67efbc
--- /dev/null
+++ b/docs/deploy-guide/rookify.md
@@ -0,0 +1,17 @@
+---
+sidebar_label: Migrate Ceph-Ansible via Rookify (technical preview)
+sidebar_position: 51
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# Migrate Ceph-Ansible via Rookify (technical preview)
+
+:::warning
+
+This is a technical preview and not recommended for production use yet.
+
+:::
+
+Rookify is now also available in OSISM.
diff --git a/docs/operations-guide/rookify.md b/docs/operations-guide/rookify.md
new file mode 100644
index 0000000..746972d
--- /dev/null
+++ b/docs/operations-guide/rookify.md
@@ -0,0 +1,15 @@
+---
+sidebar_label: Ceph via Rook (technical preview)
+---
+
+# Ceph via Rook (technical preview)
+
+:::warning
+
+This is a technical preview and not recommended for production use yet. This whole
+document has to be reworkded with more rook like handling. Do not take it for
+granted yet.
+
+:::
+
+## Where to find docs