From c7dae3ceb78999e4b06d108a43cedf2b2693c273 Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Tue, 20 Apr 2021 10:07:03 -0400 Subject: [PATCH] doc/cephadm: document _no_schedule label Signed-off-by: Sage Weil --- doc/cephadm/host-management.rst | 16 +++++++++++++++- doc/cephadm/service-management.rst | 4 ++++ 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/doc/cephadm/host-management.rst b/doc/cephadm/host-management.rst index edf6772d40d6..a586df246ec2 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 26533544c0b2..e6952cebbded 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 ------------------- -- 2.47.3