diff --git a/modules/nw-multus-add-pod.adoc b/modules/nw-multus-add-pod.adoc index 0f9f9b25ec..d90ba51cff 100644 --- a/modules/nw-multus-add-pod.adoc +++ b/modules/nw-multus-add-pod.adoc @@ -22,10 +22,10 @@ endif::[] [id="nw-multus-add-pod_{context}"] = Adding a pod to a secondary network -[role="_abstract"] -You can add a pod to a secondary network. The pod continues to send normal cluster-related network traffic over the default network. +[role="_abstract"] +To enable a pod to use additional network interfaces in {product-title}, you can attach the pod to a secondary network. The pod continues to send normal cluster-related network traffic over the default network. -When a pod is created, a secondary networks is attached to the pod. However, if a pod already exists, you cannot attach a secondary network to it. +When a pod is created, a secondary network is attached to the pod. However, if a pod already exists, you cannot attach a secondary network to it. The pod must be in the same namespace as the secondary network. diff --git a/modules/nw-multus-advanced-annotations.adoc b/modules/nw-multus-advanced-annotations.adoc index 3b021c30a0..a038b5542d 100644 --- a/modules/nw-multus-advanced-annotations.adoc +++ b/modules/nw-multus-advanced-annotations.adoc @@ -7,8 +7,7 @@ = Specifying pod-specific addressing and routing options [role="_abstract"] -You can configure pod-specific addressing and routing options by using JSON-formatted annotations. -Configuring these options enables you to set static IP addresses, MAC addresses, and default routes for the pod. +To set static IP addresses, MAC addresses, and default routes for a pod in {product-title}, you can configure pod-specific addressing and routing options using JSON-formatted annotations. With these annotations, you can customize network behavior for individual pods on secondary networks. .Prerequisites diff --git a/modules/nw-multus-delete-network.adoc b/modules/nw-multus-delete-network.adoc index e1700189b2..41f72e8672 100644 --- a/modules/nw-multus-delete-network.adoc +++ b/modules/nw-multus-delete-network.adoc @@ -4,10 +4,12 @@ :_mod-docs-content-type: PROCEDURE [id="nw-multus-delete-network_{context}"] -= Removing a secondary network attachment definition += Removing a secondary NetworkAttachmentDefinition custom resource [role="_abstract"] -As a cluster administrator, you can remove a secondary network from your {product-title} cluster. The secondary network is not removed from any pods that it is attached to. +To clean up unused network configurations or free up network resources in {product-title}, you can remove a secondary `NetworkAttachmentDefinition` CR. Edit the Cluster Network Operator CR and delete the `NetworkAttachmentDefinition` CR to remove the secondary network from your cluster. + +When a secondary network is removed from the cluster, it is not removed from any pods that it is attached to. .Prerequisites @@ -23,7 +25,7 @@ As a cluster administrator, you can remove a secondary network from your {produc $ oc edit networks.operator.openshift.io cluster ---- -. Modify the CR by removing the configuration that the CNO created from the `additionalNetworks` collection for the secondary network that you want to remove. +. Modify the custom resource (CR) by removing the configuration that the CNO created from the `additionalNetworks` collection for the secondary network that you want to remove. + [source,yaml] ---- @@ -41,14 +43,14 @@ where: `additionalNetworks`:: Specifies the secondary network attachment definition that you want to remove from the `additionalNetworks` collection. If you are removing the configuration mapping for the only secondary network attachment definition in the `additionalNetworks` collection, you must specify an empty collection. -- -. Remove a network attachment definition from the network of your cluster by entering the following command: +. Remove the `NetworkAttachmentDefinition` CR from the network of your cluster by entering the following command: + [source,terminal] ---- $ oc delete net-attach-def ---- + -Replace `` with the name of the network attachment definition that you want to remove. +Replace `` with the name of the `NetworkAttachmentDefinition` CR that you want to remove. . Save your changes and quit the text editor to commit your changes. diff --git a/modules/nw-multus-edit-network.adoc b/modules/nw-multus-edit-network.adoc index 5734f55561..3cc43a60f2 100644 --- a/modules/nw-multus-edit-network.adoc +++ b/modules/nw-multus-edit-network.adoc @@ -4,11 +4,10 @@ :_mod-docs-content-type: PROCEDURE [id="nw-multus-edit-network_{context}"] -= Modifying a secondary network attachment definition += Modifying a NetworkAttachmentDefinition custom resource [role="_abstract"] -You can modify a secondary network attachment definition. -You modify the attachment definition to update network settings or change network parameters. +To update network settings or change network parameters for a secondary network in {product-title}, you can modify the `NetworkAttachmentDefinition` custom resource. Edit the Cluster Network Operator CR to apply your changes. .Prerequisites diff --git a/modules/nw-multus-remove-pod.adoc b/modules/nw-multus-remove-pod.adoc index 2b5732ff75..d31bcb5f30 100644 --- a/modules/nw-multus-remove-pod.adoc +++ b/modules/nw-multus-remove-pod.adoc @@ -8,8 +8,7 @@ = Removing a pod from a secondary network [role="_abstract"] -You can remove a pod from a secondary network. -You remove pods from secondary networks to disconnect them from specific network configurations. +To disconnect a pod from specific network configurations in {product-title}, you can remove the pod from a secondary network. Delete the pod using the `oc delete pod` command to remove its connection to the secondary network. .Prerequisites diff --git a/networking/multiple_networks/secondary_networks/attaching-pod.adoc b/networking/multiple_networks/secondary_networks/attaching-pod.adoc index 7ad3bb64e8..1c0c6359dc 100644 --- a/networking/multiple_networks/secondary_networks/attaching-pod.adoc +++ b/networking/multiple_networks/secondary_networks/attaching-pod.adoc @@ -7,8 +7,7 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -You can attach a pod to a secondary network. -Attaching a pod to a secondary network enables the pod to use additional network interfaces beyond the primary cluster network. +To enable a pod to use additional network interfaces beyond the primary cluster network in {product-title}, you can attach the pod to a secondary network. Secondary networks provide additional connectivity options for your workloads. include::modules/nw-multus-add-pod.adoc[leveloffset=+1] diff --git a/networking/multiple_networks/secondary_networks/editing-additional-network.adoc b/networking/multiple_networks/secondary_networks/editing-additional-network.adoc index b34700d56a..e9e90b99a6 100644 --- a/networking/multiple_networks/secondary_networks/editing-additional-network.adoc +++ b/networking/multiple_networks/secondary_networks/editing-additional-network.adoc @@ -7,7 +7,6 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -You can modify the configuration for an existing secondary network. -You modify secondary networks to update network settings or change network parameters. +To update network settings or change network parameters for a secondary network in {product-title}, you can modify the configuration for an existing secondary network. Edit the `NetworkAttachmentDefinition` custom resource to apply your changes. include::modules/nw-multus-edit-network.adoc[leveloffset=+1] diff --git a/networking/multiple_networks/secondary_networks/removing-additional-network.adoc b/networking/multiple_networks/secondary_networks/removing-additional-network.adoc index 04704c632b..66d2be7c13 100644 --- a/networking/multiple_networks/secondary_networks/removing-additional-network.adoc +++ b/networking/multiple_networks/secondary_networks/removing-additional-network.adoc @@ -7,7 +7,6 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -You can remove an additional network attachment. -You remove additional networks to clean up unused network configurations or free up network resources. +To clean up unused network configurations or free up network resources in {product-title}, you can remove an additional network attachment. Delete the `NetworkAttachmentDefinition` custom resource to remove the secondary network from your cluster. include::modules/nw-multus-delete-network.adoc[leveloffset=+1] diff --git a/networking/multiple_networks/secondary_networks/removing-pod.adoc b/networking/multiple_networks/secondary_networks/removing-pod.adoc index cf542a1177..fa20fed3d4 100644 --- a/networking/multiple_networks/secondary_networks/removing-pod.adoc +++ b/networking/multiple_networks/secondary_networks/removing-pod.adoc @@ -7,7 +7,6 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -You can remove a pod from a secondary network. -You remove pods from secondary networks to disconnect them from specific network configurations. +To disconnect a pod from specific network configurations in {product-title}, you can remove the pod from a secondary network. Delete the pod to remove its connection to the secondary network. include::modules/nw-multus-remove-pod.adoc[leveloffset=+1]