mirror of
https://github.com/ceph/ceph
synced 2024-12-25 21:03:31 +00:00
c8f01d3a32
This commit addresses https://github.com/ceph/ceph/pull/43250, which has remained unmerged for thirteen months. The issues raised in that PR are addressed here. This commit contributes to the simplification of the procedure that explains how to install cephadm. More remains to be done on this page, but the old PR had to be dealt with first. Signed-off-by: Zac Dover <zac.dover@gmail.com>
51 lines
1.7 KiB
ReStructuredText
51 lines
1.7 KiB
ReStructuredText
.. _cephadm:
|
|
|
|
=======
|
|
Cephadm
|
|
=======
|
|
|
|
``cephadm`` is a utility that is used to manage a Ceph cluster.
|
|
|
|
Here is a list of some of the things that ``cephadm`` can do:
|
|
|
|
- ``cephadm`` can add a Ceph container to the cluster.
|
|
- ``cephadm`` can remove a Ceph container from the cluster.
|
|
- ``cephadm`` can update Ceph containers.
|
|
|
|
``cephadm`` does not rely on external configuration tools like Ansible, Rook,
|
|
or Salt. However, those external configuration tools can be used to automate
|
|
operations not performed by cephadm itself. To learn more about these external
|
|
configuration tools, visit their GitHub pages:
|
|
|
|
* https://github.com/ceph/cephadm-ansible
|
|
* https://github.com/ceph/ceph-salt
|
|
* https://rook.io/
|
|
|
|
``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 to expand the cluster, adding
|
|
hosts and provisioning Ceph daemons and services. Management of this lifecycle
|
|
can be performed either via the Ceph command-line interface (CLI) or via the
|
|
dashboard (GUI).
|
|
|
|
To use ``cephadm`` get started with Ceph, follow the instructions in
|
|
:ref:`cephadm_deploying_new_cluster`.
|
|
|
|
``cephadm`` was introduced in Ceph release v15.2.0 (Octopus) and does not
|
|
support older versions of Ceph.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
compatibility
|
|
install
|
|
adoption
|
|
host-management
|
|
Service Management <services/index>
|
|
upgrade
|
|
Cephadm operations <operations>
|
|
Client Setup <client-setup>
|
|
troubleshooting
|
|
Cephadm Feature Planning <../dev/cephadm/index>
|