From bae07a4417645b064322aa260fd0697984cce728 Mon Sep 17 00:00:00 2001 From: Sebastian Wagner Date: Thu, 27 Jan 2022 10:09:58 +0100 Subject: [PATCH] doc/cephadm: Co-location of daemons Signed-off-by: Sebastian Wagner --- doc/cephadm/services/index.rst | 24 ++++++++++++++++++++++++ doc/cephadm/services/mgr.rst | 8 +++++++- doc/cephadm/services/rgw.rst | 4 ++++ 3 files changed, 35 insertions(+), 1 deletion(-) diff --git a/doc/cephadm/services/index.rst b/doc/cephadm/services/index.rst index 8200a0bc1edce..efc8ed8f2cc3b 100644 --- a/doc/cephadm/services/index.rst +++ b/doc/cephadm/services/index.rst @@ -402,6 +402,30 @@ YAML can also be used to specify limits on hosts: - host2 - host3 +.. _cephadm_co_location: + +Co-location of daemons +---------------------- + +Cephadm supports the deployment of multiple daemons on the same host: + +.. code-block:: yaml + + service_type: rgw + placement: + label: rgw + count-per-host: 2 + +The main reason for deploying multiple daemons per host is an additional +performance benefit for running multiple RGW and MDS daemons on the same host. + +See also: + +* :ref:`cephadm_mgr_co_location`. +* :ref:`cephadm-rgw-designated_gateways`. + +This feature was introduced in Pacific. + Algorithm description --------------------- diff --git a/doc/cephadm/services/mgr.rst b/doc/cephadm/services/mgr.rst index 98a54398b18c0..133a00d77217b 100644 --- a/doc/cephadm/services/mgr.rst +++ b/doc/cephadm/services/mgr.rst @@ -22,13 +22,19 @@ example spec file (leveraging a default placement): networks: - 192.169.142.0/24 +.. _cephadm_mgr_co_location: + Allow co-location of MGR daemons ================================ In deployment scenarios with just a single host, cephadm still needs -to deploy at least two MGR daemons. See ``mgr_standby_modules`` in +to deploy at least two MGR daemons in order to allow an automated +upgrade of the cluster. See ``mgr_standby_modules`` in the :ref:`mgr-administrator-guide` for further details. +See also: :ref:`cephadm_co_location`. + + Further Reading =============== diff --git a/doc/cephadm/services/rgw.rst b/doc/cephadm/services/rgw.rst index ece8aeee35a52..a0f130a8eead1 100644 --- a/doc/cephadm/services/rgw.rst +++ b/doc/cephadm/services/rgw.rst @@ -36,6 +36,8 @@ under the arbitrary service id *foo*: ceph orch apply rgw foo +.. _cephadm-rgw-designated_gateways: + Designated gateways ------------------- @@ -49,6 +51,8 @@ ports 8000 and 8001: ceph orch host label add gwhost2 rgw ceph orch apply rgw foo '--placement=label:rgw count-per-host:2' --port=8000 +See also: :ref:`cephadm_co_location`. + .. _cephadm-rgw-networks: Specifying Networks -- 2.39.5