From: Zac Dover Date: Sat, 21 Jan 2023 16:32:59 +0000 (+1000) Subject: doc/install: refine index.rst X-Git-Tag: v16.2.12~3^2~67^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=99e9e71ab8a00547199601105bf8bdd9f9f211e4;p=ceph.git doc/install: refine index.rst Refine English sentences in doc/install/index.rst. Remove adverbial phrases of time that refer to Nautilus-era features as "new", since that was four years ago. Signed-off-by: Zac Dover (cherry picked from commit e7669539aceffc0f6f5d61bd140f1c7936d21cf9) --- diff --git a/doc/install/index.rst b/doc/install/index.rst index 5a8a9d2cbbd89..853d1923728a0 100644 --- a/doc/install/index.rst +++ b/doc/install/index.rst @@ -10,27 +10,26 @@ Recommended methods ~~~~~~~~~~~~~~~~~~~ :ref:`Cephadm ` installs and manages a Ceph -cluster using containers and systemd, with tight integration with the CLI and -dashboard GUI. - -* cephadm only supports Octopus and newer releases. -* cephadm is fully integrated with the new orchestration API and - fully supports the new CLI and dashboard features to manage - cluster deployment. -* cephadm requires container support (podman or docker) and +cluster that uses containers and systemd and is tightly integrated with the CLI +and dashboard GUI. + +* cephadm supports only Octopus and newer releases. +* cephadm is fully integrated with the orchestration API and fully supports the + CLI and dashboard features that are used to manage cluster deployment. +* cephadm requires container support (in the form of Podman or Docker) and Python 3. `Rook `_ deploys and manages Ceph clusters running in Kubernetes, while also enabling management of storage resources and -provisioning via Kubernetes APIs. We recommend Rook as the way to run Ceph in +provisioning via Kubernetes APIs. We recommend Rook as the way to run Ceph in Kubernetes or to connect an existing Ceph storage cluster to Kubernetes. -* Rook only supports Nautilus and newer releases of Ceph. +* Rook supports only Nautilus and newer releases of Ceph. * Rook is the preferred method for running Ceph on Kubernetes, or for connecting a Kubernetes cluster to an existing (external) Ceph cluster. -* Rook supports the new orchestrator API. New management features - in the CLI and dashboard are fully supported. +* Rook supports the orchestrator API. Management features in the CLI and + dashboard are fully supported. Other methods ~~~~~~~~~~~~~ @@ -39,16 +38,20 @@ Other methods Ceph clusters using Ansible. * ceph-ansible is widely deployed. -* ceph-ansible is not integrated with the new orchestrator APIs, - introduced in Nautlius and Octopus, which means that newer - management features and dashboard integration are not available. +* ceph-ansible is not integrated with the orchestrator APIs that were + introduced in Nautilus and Octopus, which means that the management features + and dashboard integration introduced in Nautilus and Octopus are not + available in Ceph clusters deployed by means of ceph-ansible. -`ceph-deploy `_ is a tool for quickly deploying clusters. +`ceph-deploy `_ is a +tool that can be used to quickly deploy clusters. It is deprecated. .. IMPORTANT:: - ceph-deploy is no longer actively maintained. It is not tested on versions of Ceph newer than Nautilus. It does not support RHEL8, CentOS 8, or newer operating systems. + ceph-deploy is not actively maintained. It is not tested on versions of Ceph + newer than Nautilus. It does not support RHEL8, CentOS 8, or newer operating + systems. `DeepSea `_ installs Ceph using Salt. @@ -67,7 +70,7 @@ Ceph can also be :ref:`installed manually `. Windows ~~~~~~~ -For Windows installations, please consult this document: +For Windows installations, consult this document: `Windows installation guide`_. .. _Windows installation guide: ./windows-install