diff --git a/doc/cephadm/host-management.rst b/doc/cephadm/host-management.rst index edf6772d40d..a586df246ec 100644 --- a/doc/cephadm/host-management.rst +++ b/doc/cephadm/host-management.rst @@ -117,7 +117,21 @@ To remove a label, run:: ceph orch host label rm my_hostname my_label - + +.. _cephadm-special-host-labels: + +Special host labels +------------------- + +The following host labels have a special meaning to cephadm. All start with ``_``. + +* ``_no_schedule``: *Do not schedule or deploy daemons on this host*. + + This label prevents cephadm from deploying daemons on this host. If it is added to + an existing host that already contains Ceph daemons, it will cause cephadm to move + those daemons elsewhere (except OSDs, which are not removed automatically). + + Maintenance Mode ================ diff --git a/doc/cephadm/service-management.rst b/doc/cephadm/service-management.rst index 26533544c0b..e6952cebbde 100644 --- a/doc/cephadm/service-management.rst +++ b/doc/cephadm/service-management.rst @@ -132,6 +132,10 @@ For the orchestrator to deploy a *service*, it needs to know where to deploy specification. Placement specifications can either be passed as command line arguments or in a YAML files. +.. note:: + + cephadm will not deploy daemons on hosts with the ``_no_schedule`` label; see :ref:`cephadm-special-host-labels`. + Explicit placements -------------------