doc/radosgw: document the notification_v2 zone feature

Signed-off-by: Casey Bodley <cbodley@redhat.com>
(cherry picked from commit 30d97250f945e0afdfe9ca52a97a42922091d4dd)

diff --git a/doc/radosgw/notifications.rst b/doc/radosgw/notifications.rst
index 655f3bbc39e3909f3a4879f130f65574779ea2e5..aa9a55ef966e8d159dc8a0b381cbad01d5c4d17a 100644 (file)
--- a/doc/radosgw/notifications.rst
+++ b/doc/radosgw/notifications.rst
@@ -4,6 +4,10 @@ Bucket Notifications
 
 .. versionadded:: Nautilus
 
+.. versionchanged:: Squid
+   A new "v2" format for Topic and Notification metadata can be enabled with
+   the :ref:`feature_notification_v2` zone feature.
+
 .. contents::
 
 Bucket notifications provide a mechanism for sending information out of radosgw

diff --git a/doc/radosgw/zone-features.rst b/doc/radosgw/zone-features.rst
index b439fd9dfd26f1933fcde773dd14b1596f76105a..5b5986527ab6847694ca7a76f11b11ee1b53ae83 100644 (file)
--- a/doc/radosgw/zone-features.rst
+++ b/doc/radosgw/zone-features.rst
@@ -16,6 +16,8 @@ Supported Features
 +-----------------------------------+---------+----------+
 | :ref:`feature_compress_encrypted` | Reef    | Disabled |
 +-----------------------------------+---------+----------+
+| :ref:`feature_notification_v2`    | Squid   | Enabled  |
++-----------------------------------+---------+----------+
 
 .. _feature_resharding:
 
@@ -49,6 +51,20 @@ must upgrade to Reef or later before enabling.
    the same data. Due to these security considerations, this feature is disabled
    by default.
 
+
+.. _feature_notification_v2:
+
+notification_v2
+~~~~~~~~~~~~~~~
+
+This feature opts in to a new "v2" metadata format for bucket notifications and
+topics. Unlike "v1", this format is supported by multisite replication and can
+scale to many topics.
+
+Once this feature is enabled on all zonegroups in the realm, a background process
+will convert existing v1 topics and bucket notifications into their v2 format.
+
+
 Commands
 --------