From dfd205dca7889e325a6ec22892d3a9e058ad89d2 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Wed, 24 Mar 2021 01:19:11 +1000 Subject: [PATCH] doc/cephadm: rewrite "index.rst" This PR rewrites the three paragraphs at the front of the cephadm guide, increasing their elegance and removing ambiguities. Signed-off-by: Zac Dover --- doc/cephadm/index.rst | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/doc/cephadm/index.rst b/doc/cephadm/index.rst index 02d7430ba44..d9531d51ca5 100644 --- a/doc/cephadm/index.rst +++ b/doc/cephadm/index.rst @@ -4,19 +4,20 @@ Cephadm ======= -Cephadm deploys and manages a Ceph cluster by connection to hosts from the -manager daemon via SSH to add, remove, or update Ceph daemon containers. It -does not rely on external configuration or orchestration tools like Ansible, -Rook, or Salt. +``cephadm`` deploys and manages a Ceph cluster. It does this by connecting the +manager daemon to hosts via SSH. The manager daemon is able to add, remove, and +update Ceph containers. ``cephadm`` does not rely on external configuration +tools such as Ansible, Rook, and Salt. -Cephadm manages the full lifecycle of a Ceph cluster. It starts -by bootstrapping a tiny Ceph cluster on a single node (one monitor and -one manager) and then uses the orchestration interface ("day 2" -commands) to expand the cluster to include all hosts and to provision -all Ceph daemons and services. This can be performed via the Ceph -command-line interface (CLI) or dashboard (GUI). +``cephadm`` manages the full lifecycle of a Ceph cluster. This lifecycle +starts with the bootstrapping process, when ``cephadm`` creates a tiny +Ceph cluster on a single node. This cluster consists of one monitor and +one manager. ``cephadm`` then uses the orchestration interface ("day 2" +commands) to expand the cluster, adding all hosts and provisioning all +Ceph daemons and services. Management of this lifecycle can be performed +either via the Ceph command-line interface (CLI) or via the dashboard (GUI). -Cephadm is new in the Octopus v15.2.0 release and does not support older +``cephadm`` is new in Ceph release v15.2.0 (Octopus) and does not support older versions of Ceph. .. note::