From: Casey Bodley Date: Wed, 13 Mar 2024 22:35:40 +0000 (-0400) Subject: doc/radosgw: document the notification_v2 zone feature X-Git-Tag: testing/wip-batrick-testing-20240411.154038~218^2~1 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=30d97250f945e0afdfe9ca52a97a42922091d4dd;p=ceph-ci.git doc/radosgw: document the notification_v2 zone feature Signed-off-by: Casey Bodley --- diff --git a/doc/radosgw/notifications.rst b/doc/radosgw/notifications.rst index 655f3bbc39e..aa9a55ef966 100644 --- 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 b439fd9dfd2..5b5986527ab 100644 --- 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 --------