Merge pull request #76379 from stevsmit/OSDOCS-9479-whereabouts-ipam

Adds whereabouts multi tenant example to networking docs

Author: stevsmit

modules/nw-multus-ipam-object.adoc

@@ -192,9 +192,14 @@ spec:
 [id="nw-multus-whereabouts_{context}"]
 == Dynamic IP address assignment configuration with Whereabouts
 
-The Whereabouts CNI plugin allows the dynamic assignment of an IP address to an additional network without the use of a DHCP server.
+The Whereabouts CNI plugin allows the dynamic assignment of an IP address to an additional network without the use of a DHCP server. 
 
-The following table describes the configuration for dynamic IP address assignment with Whereabouts:
+The Whereabouts CNI plugin also supports overlapping IP address ranges and configuration of the same CIDR range multiple times within separate `NetworkAttachmentDefinitions`. This provides greater flexibility and management capabilities in multi-tenant environments.
+
+[id="dynamic-ip-address-assignment-objects_{context}"]
+=== Dynamic IP address configuration objects
+
+The following table describes the configuration objects for dynamic IP address assignment with Whereabouts:
 
 .`ipam` whereabouts configuration object
 [cols=".^2,.^2,.^6",options="header"]
@@ -213,16 +218,18 @@ The following table describes the configuration for dynamic IP address assignmen
 |`array`
 |Optional: A list of zero or more IP addresses and ranges in CIDR notation. IP addresses within an excluded address range are not assigned.
 
+|`network_name`
+|`string`
+| Optional: Helps ensure that each group or domain of pods gets its own set of IP addresses, even if they share the same range of IP addresses. Setting this field is important for keeping networks separate and organized, notably in multi-tenant environments.
+
 |====
 
-////
-[NOTE]
-=====
-Whereabouts can be used for both IPv4 and IPv6 addresses.
-=====
-////
+[id="dynamic-ip-address-assignment-whereabouts_{context}"]
+=== Dynamic IP address assignment configuration that uses Whereabouts
+
+The following example shows a dynamic address assignment configuration that uses Whereabouts:
 
-.Dynamic IP address assignment configuration example that uses Whereabouts
+.Whereabouts dynamic IP address assignment
 [source,json]
 ----
 {
@@ -237,6 +244,37 @@ Whereabouts can be used for both IPv4 and IPv6 addresses.
 }
 ----
 
+[id="dynamic-ip-address-assignment-whereabouts-overlapping-ip-ranges_{context}"]
+=== Dynamic IP address assignment that uses Whereabouts with overlapping IP address ranges
+
+The following example shows a dynamic IP address assignment that uses overlapping IP address ranges for multi-tenant networks. 
+
+.NetworkAttachmentDefinition 1
+[source,json]
+----
+{
+  "ipam": {
+    "type": "whereabouts",
+    "range": "192.0.2.192/29",
+    "network_name": "example_net_common", <1>
+  }
+}
+----
+<1> Optional. If set, must match the `network_name` of NetworkAttachmentDefinition 2.
+
+.NetworkAttachmentDefinition 2
+[source,json]
+----
+{
+  "ipam": {
+    "type": "whereabouts",
+    "range": "192.0.2.192/24",
+    "network_name": "example_net_common", <1>
+  }
+}
+----
+<1> Optional. If set, must match the `network_name` of NetworkAttachmentDefinition 1. 
+
 ifdef::sr-iov[]
 :!sr-iov:
 endif::[]