From 8e4f9ea46ceec267748d60c6ed009b209d2352ab Mon Sep 17 00:00:00 2001 From: Sebastian Wagner Date: Fri, 15 Oct 2021 13:13:02 +0200 Subject: [PATCH] doc/cephadm: Hosts: Add "initial CRUSH location" Followup on d2a9a35993 Signed-off-by: Sebastian Wagner --- doc/cephadm/host-management.rst | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/doc/cephadm/host-management.rst b/doc/cephadm/host-management.rst index 2253cb6e14df6..c109e2dc73b32 100644 --- a/doc/cephadm/host-management.rst +++ b/doc/cephadm/host-management.rst @@ -169,13 +169,14 @@ Where the force flag when entering maintenance allows the user to bypass warning See also :ref:`cephadm-fqdn` -Host Specification -================== +Creating many hosts at once +=========================== Many hosts can be added at once using -``ceph orch apply -i`` by submitting a multi-document YAML file:: +``ceph orch apply -i`` by submitting a multi-document YAML file: + +.. code-block:: yaml - --- service_type: host hostname: node-00 addr: 192.168.0.10 @@ -197,6 +198,26 @@ This can be combined with service specifications (below) to create a cluster spe file to deploy a whole cluster in one command. see ``cephadm bootstrap --apply-spec`` also to do this during bootstrap. Cluster SSH Keys must be copied to hosts prior to adding them. +Setting the initial CRUSH location of host +========================================== + +Hosts can contain a ``location`` identifier which will instruct cephadm to +create a new CRUSH host located in the specified hierachy. + +.. code-block:: yaml + + service_type: host + hostname: node-00 + addr: 192.168.0.10 + location: + rack: rack1 + +.. note:: + + The ``location`` attribute will be only affect the initial CRUSH location. Subsequent + changes of the ``location`` property will be ignored. Also, removing a host will no remove + any CRUSH buckets. + SSH Configuration ================= -- 2.39.5