From 2eef980090085b9e967f6a8185c5f910878c8caa Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Thu, 16 Feb 2023 09:56:53 +1000 Subject: [PATCH] doc/rgw: refine "Realms" section Make various syntactical and semantic improvements to "Realms" section. Signed-off-by: Zac Dover (cherry picked from commit 5cea2529c442cd0c5ecc25a8f3131548a71f590f) --- doc/radosgw/multisite.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/radosgw/multisite.rst b/doc/radosgw/multisite.rst index 3d1620a8dc5c6..f4ab04642ed24 100644 --- a/doc/radosgw/multisite.rst +++ b/doc/radosgw/multisite.rst @@ -761,20 +761,20 @@ Expand the details of an option to reveal a longer description. Realms ------ -A realm represents a globally unique namespace consisting of one or more -zonegroups containing one or more zones, and zones containing buckets, -which in turn contain objects. A realm enables the Ceph Object Gateway -to support multiple namespaces and their configuration on the same -hardware. +A realm is a globally unique namespace that consists of one or more zonegroups. +Zonegroups contain one or more zones. Zones contain buckets. Buckets contain +objects. -A realm contains the notion of periods. Each period represents the state +Realms make it possible for the Ceph Object Gateway to support multiple +namespaces and their configurations on the same hardware. + +Each realm is associated with a "period". A period represents the state of the zonegroup and zone configuration in time. Each time you make a -change to a zonegroup or zone, update the period and commit it. +change to a zonegroup or zone, you should update and commit the period. -By default, the Ceph Object Gateway does not create a realm -for backward compatibility with Infernalis and earlier releases. -However, as a best practice, we recommend creating realms for new -clusters. +To ensure backward compatibility with Infernalis and earlier releases, the Ceph +Object Gateway does not by default create a realm. However, as a best practice, +we recommend that you create realms when creating new clusters. Create a Realm ~~~~~~~~~~~~~~ -- 2.39.5