doc/glossary: add "Bucket"

Add "Bucket" to the glossary. The definition added here is just a first
attempt, but a man's reach must exceed his grasp, or what's a heaven
for?

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit ffbc5ea2b9347e2600df6aea9cdf895529fbf857)

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 091d332629f03f7fad6fd149a89b66ac7b2e0e09..54abfe952c585266cd76be12fdee2e2a353ffc12 100644 (file)
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -14,6 +14,16 @@
                 system interface. Since Luminous (12.2), BlueStore has been
                 Ceph's default and recommended storage back end.
 
+        Bucket
+                In the context of :term:`RGW`, a bucket is a group of objects.
+                Buckets are grouped into zones, and zones are grouped into
+                zonegroups. In an filesystem-based analogy in which objects are
+                the counterpart of files, buckets are the counterpart of
+                directories. :ref:`Multisite sync
+                policies<radosgw-multisite-sync-policy>` can be set on buckets,
+                to provide fine-grained control of data movement from one zone
+                to another zone.
+                
        Ceph
                 Ceph is a distributed network storage and file system with
                 distributed metadata management and POSIX semantics.

diff --git a/doc/radosgw/multisite-sync-policy.rst b/doc/radosgw/multisite-sync-policy.rst
index 56342473ce845a1dd6371e398ae6e2eb2cb082b0..ba5d10ef5f53619b27372b8ba12f90e5841f59cd 100644 (file)
--- a/doc/radosgw/multisite-sync-policy.rst
+++ b/doc/radosgw/multisite-sync-policy.rst
@@ -1,3 +1,5 @@
+.. _radosgw-multisite-sync-policy:
+
 =====================
 Multisite Sync Policy
 =====================