docs: add docs for public_bind_addr

Signed-off-by: Bassam Tabbara <bassam.tabbara@quantum.com>

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 572e45f438b2a4ca89425e083783f71b1dab4976..b7b4d4975e19bc4a40ca486e569a6139b62cd449 100644 (file)
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -2,6 +2,9 @@
 ------
 * The "journaler allow split entries" config setting has been removed.
 * The 'apply' mode of cephfs-journal-tool has been removed
+* Added new configuration "public bind addr" to support dynamic environments
+  like Kubernetes. When set the Ceph MON daemon could bind locally to an IP
+  address and advertise a different IP address "public addr" on the network.
 
 12.0.0
 ------

diff --git a/doc/rados/configuration/network-config-ref.rst b/doc/rados/configuration/network-config-ref.rst
index d2b367701e74ac1fb4b65ea92c366ba22b4c1c24..693520625fc3a3032beaf188b3a91c6d5720909f 100644 (file)
--- a/doc/rados/configuration/network-config-ref.rst
+++ b/doc/rados/configuration/network-config-ref.rst
@@ -375,6 +375,20 @@ addresses.
 :Default: ``false``
 :Required: No
 
+``public bind addr``
+
+:Description: In some dynamic deployments the Ceph MON daemon might bind
+              to an IP address locally that is different from the ``public addr``
+              advertised to other peers in the network. The environment must ensure
+              that routing rules are set correclty. If ``public bind addr`` is set
+              the Ceph MON daemon will bind to it locally and use ``public addr``
+              in the monmaps to advertise its address to peers. This behavior is limited
+              to the MON daemon.
+
+:Type: IP Address
+:Required: No
+:Default: N/A
+
 
 
 Hosts