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>

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 4d1376623bb0bd3980b9f8bda9f499ef2ed445b3..c20a306c4e333321ba94d9eca703a8d02443f75e 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 befef4279ee2090e03d6f9c327b080958bde8332..7a6e7105ce637d820d9a8a21550b3ba80ab7f95d 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
 =====================