Dualstack configuration procedure

Author: jmanthei

modules/nw-multus-configure-dualstack-ip-address.adoc

@@ -0,0 +1,58 @@
+// Module included in the following assemblies:
+//
+// * networking/multiple_networks/configuring-additional-network.adoc
+
+:_content-type: PROCEDURE 
+
+[id="nw-multus-configure-dualstack-ip-address_{context}"]
+= Creating a configuration for assignment of dual-stack IP addresses dynamically
+
+Dual-stack IP address assignment can be configured with the `ipRanges` parameter for:
+
+* IPv4 addresses
+* IPv6 addresses
+* multiple IP address assignment 
+
+.Procedure
+
+. Set `type` to `whereabouts`.
+
+. Use `ipRanges` to allocate IP addresses as shown in the following example:
++
+[source,yaml]
+----
+cniVersion: operator.openshift.io/v1
+kind: Network
+=metadata:
+  name: cluster
+spec:
+  additionalNetworks:
+  - name: whereabouts-shim
+    namespace: default
+    type: Raw
+    rawCNIConfig: |-
+      {
+       "name": "whereabouts-dual-stack",
+       "cniVersion": "0.3.1,
+       "type": "bridge",
+       "ipam": {
+         "type": "whereabouts",
+         "ipRanges": [
+                  {"range": "192.168.10.0/24"},
+                  {"range": "2001:db8::/64"}
+              ]
+       }
+      }
+
+----
+
+. Attach network to a pod. For more information, see "Adding a pod to an additional network".
+
+. Verify that all IP addresses are assigned.
+
+. Run the following command to ensure the IP addresses are assigned as metadata.
++
+[source,yaml]
+----
+$ oc exec -it mypod -- ip a
+----

networking/hardware_networks/configuring-sriov-ib-attach.adoc

@@ -10,6 +10,13 @@ You can configure an InfiniBand (IB) network attachment for an Single Root I/O V
 
 include::modules/nw-sriov-ibnetwork-object.adoc[leveloffset=+1]
 include::modules/nw-multus-ipam-object.adoc[leveloffset=+2]
+
+include::modules/nw-multus-configure-dualstack-ip-address.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../networking/multiple_networks/attaching-pod.html#nw-multus-add-pod_attaching-pod[Attaching a pod to an additional network]
+
 include::modules/nw-sriov-network-attachment.adoc[leveloffset=+1]
 
 [id="configuring-sriov-ib-attach-next-steps"]

networking/hardware_networks/configuring-sriov-net-attach.adoc

@@ -10,6 +10,12 @@ You can configure an Ethernet network attachment for an Single Root I/O Virtuali
 
 include::modules/nw-sriov-network-object.adoc[leveloffset=+1]
 include::modules/nw-multus-ipam-object.adoc[leveloffset=+2]
+include::modules/nw-multus-configure-dualstack-ip-address.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../networking/multiple_networks/attaching-pod.html#nw-multus-add-pod_attaching-pod[Attaching a pod to an additional network]
+
 include::modules/nw-sriov-network-attachment.adoc[leveloffset=+1]
 
 [id="configuring-sriov-net-attach-next-steps"]

networking/multiple_networks/configuring-additional-network.adoc

@@ -168,6 +168,12 @@ include::modules/configuring-pods-static-ip.adoc[leveloffset=+3]
 
 include::modules/nw-multus-ipam-object.adoc[leveloffset=+1]
 
+include::modules/nw-multus-configure-dualstack-ip-address.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../../networking/multiple_networks/attaching-pod.html#nw-multus-add-pod_attaching-pod[Attaching a pod to an additional network]
+
 include::modules/nw-multus-create-network.adoc[leveloffset=+1]
 
 include::modules/nw-multus-create-network-apply.adoc[leveloffset=+1]