From bdaf1220491889864e19f59321177ae4c1fcd3bc Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Fri, 3 Mar 2023 04:04:30 +1000 Subject: [PATCH] doc/radosgw: format admonitions Break up the text of two similar admonitions into three paragraphs (in each of the two instances). This makes the content of the admonition much easier to read at a glance. Signed-off-by: Zac Dover (cherry picked from commit 4db68f5711f48b190f0135a3a7a6df8dfcf5abfa) --- doc/radosgw/multisite.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/radosgw/multisite.rst b/doc/radosgw/multisite.rst index 92a1be764f90e..e4969ec82afe8 100644 --- a/doc/radosgw/multisite.rst +++ b/doc/radosgw/multisite.rst @@ -159,7 +159,11 @@ realm enforces a globally unique namespace within itself. radosgw-admin realm create --rgw-realm=movies --default - .. note:: If you intend the cluster to have a single realm, specify the ``--default`` flag. If ``--default`` is specified, ``radosgw-admin`` uses this realm by default. If ``--default`` is not specified, you must specify either the ``--rgw-realm`` flag or the ``--realm-id`` flag to identify the realm when adding zonegroups and zones. + .. note:: If you intend the cluster to have a single realm, specify the ``--default`` flag. + + If ``--default`` is specified, ``radosgw-admin`` uses this realm by default. + + If ``--default`` is not specified, you must specify either the ``--rgw-realm`` flag or the ``--realm-id`` flag to identify the realm when adding zonegroups and zones. #. After the realm has been created, ``radosgw-admin`` echoes back the realm configuration. For example: @@ -195,7 +199,11 @@ for the realm. radosgw-admin zonegroup create --rgw-zonegroup=us --endpoints=http://rgw1:80 --rgw-realm=movies --master --default - .. note:: If the realm will have only a single zonegroup, specify the ``--default`` flag. If ``--default`` is specified, ``radosgw-admin`` uses this zonegroup by default when adding new zones. If ``--default`` is not specified, you must use either the ``--rgw-zonegroup`` flag or the ``--zonegroup-id`` flag to identify the zonegroup when adding or modifying zones. + .. note:: If the realm will have only a single zonegroup, specify the ``--default`` flag. + + If ``--default`` is specified, ``radosgw-admin`` uses this zonegroup by default when adding new zones. + + If ``--default`` is not specified, you must use either the ``--rgw-zonegroup`` flag or the ``--zonegroup-id`` flag to identify the zonegroup when adding or modifying zones. #. After creating the master zonegroup, ``radosgw-admin`` echoes back the zonegroup configuration. For example: -- 2.39.5