OSDOCS-14356-New: Added bond best practices info to networking docs #93160

dfitzmau · 2025-05-08T15:56:36Z

Checklist of items:

static DHCP requirements
fail_over_mac=1
Remove ip=bond0 kargs.

Version(s):
4.12+

Link to docs preview:

SME has approved this change.
QE has approved this change.

ocpdocs-previewbot · 2025-05-08T16:16:38Z

🤖 Thu Dec 18 14:40:46 - Prow CI generated the docs preview:
https://93160--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

modules/virt-example-nmstate-multiple-interfaces.adoc

dfitzmau · 2025-05-30T09:39:49Z

/retest

modules/installation-network-user-infra.adoc

modules/installation-user-infra-machines-static-network.adoc

modules/nw-kernel-bonding.adoc

modules/installation-user-infra-machines-static-network.adoc

rbbratta · 2025-12-18T12:38:14Z

modules/configuring-localnet-switched-topology.adoc

-`node-role.kubernetes.io/worker`:: A node selector that specifies the nodes to apply the node network configuration policy to.
+
+`metadata.name`:: The name for the configuration object.
+`node-role.kubernetes.io/worker::` A node selector that specifies the nodes to apply the node network configuration policy to.


is this a typo?

r::`

is this a typo? :: after the back-quote?

ocpdocs-vale-bot · 2025-12-18T13:30:27Z

modules/enable-active-backup-mode.adoc

@@ -0,0 +1,15 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA.

ocpdocs-vale-bot · 2025-12-18T13:30:29Z

modules/enable-active-backup-mode.adoc

@@ -0,0 +1,15 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.TaskContents: The '.Procedure' block title is missing.

ocpdocs-vale-bot · 2025-12-18T13:30:38Z

modules/installation-user-infra-machines-static-network.adoc

-Optional: You can bond multiple network interfaces to a single interface by using the `bond=` option. Refer to the following examples:
+As an optional configuration, you can bond multiple network interfaces to a single interface by using the `bond=` option. To apply this configuration to your cluster, complete the procedure steps for each node that runs on your cluster.
+
+.Procedure


🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

ocpdocs-vale-bot · 2025-12-18T13:30:41Z

modules/installation-user-infra-machines-static-network.adoc

+As an optional configuration, you can bond multiple SR-IOV network interfaces to a dual port NIC interface by using the `bond=` option.

-On each node, you must perform the following tasks:
+.Procedure


🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

ocpdocs-vale-bot · 2025-12-18T13:30:45Z

modules/nw-kernel-bonding.adoc

@@ -0,0 +1,24 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA.

ocpdocs-vale-bot · 2025-12-18T13:30:48Z

modules/nw-ovs-bonding.adoc

@@ -0,0 +1,20 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA.

ocpdocs-vale-bot · 2025-12-18T14:15:08Z

modules/enable-active-backup-mode.adoc

@@ -0,0 +1,16 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.TaskContents: The '.Procedure' block title is missing.

modules/installation-user-infra-machines-static-network.adoc

ocpdocs-vale-bot · 2025-12-18T14:15:18Z

modules/installation-user-infra-machines-static-network.adoc

+As an optional configuration, you can bond multiple SR-IOV network interfaces to a dual port NIC interface by using the `bond=` option.

-On each node, you must perform the following tasks:
+.Procedure


🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

modules/nw-kernel-bonding.adoc

modules/nw-ovs-bonding.adoc

ocpdocs-vale-bot · 2025-12-18T14:42:47Z

modules/enable-active-backup-mode.adoc

@@ -0,0 +1,16 @@
+// Module included in the following assemblies:


🤖 [error] AsciiDocDITA.TaskContents: The '.Procedure' block title is missing.

ocpdocs-vale-bot · 2025-12-18T14:42:56Z

modules/installation-user-infra-machines-static-network.adoc

-Optional: You can bond multiple network interfaces to a single interface by using the `bond=` option. Refer to the following examples:
+As an optional configuration, you can bond multiple network interfaces to a single interface by using the `bond=` option. To apply this configuration to your cluster, complete the procedure steps for each node that runs on your cluster.
+
+.Procedure


🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

ocpdocs-vale-bot · 2025-12-18T14:42:59Z

modules/installation-user-infra-machines-static-network.adoc

+As an optional configuration, you can bond multiple SR-IOV network interfaces to a dual port NIC interface by using the `bond=` option.

-On each node, you must perform the following tasks:
+.Procedure


🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

openshift-ci · 2025-12-18T14:43:18Z

@dfitzmau: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

cybertron

One last thing inline, but otherwise lgtm.

cybertron · 2025-12-18T22:08:04Z

modules/creating-manifest-file-customized-br-ex-bridge.adoc


+[NOTE]
+====
+As a postinstallation task, do not make configuration changes to the `br-ex` bridge or its underlying interfaces.


I don't think we want this note here. This is the section of the docs where we discuss the changes you can make when you deploy with a custom NMState br-ex.

openshift-ci bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label May 8, 2025

dfitzmau force-pushed the OSDOCS-14356-new branch from 18241e1 to 8846ca5 Compare May 8, 2025 16:03

openshift-ci bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels May 8, 2025

dfitzmau force-pushed the OSDOCS-14356-new branch from 8846ca5 to d6452ad Compare May 8, 2025 16:06

ocpdocs-vale-bot reviewed May 8, 2025

View reviewed changes

modules/virt-example-nmstate-multiple-interfaces.adoc Outdated Show resolved Hide resolved

dfitzmau force-pushed the OSDOCS-14356-new branch 2 times, most recently from 3296fa2 to 318fd00 Compare May 9, 2025 08:21

dfitzmau added branch/enterprise-4.12 branch/enterprise-4.13 branch/enterprise-4.14 branch/enterprise-4.15 branch/enterprise-4.16 branch/enterprise-4.17 branch/enterprise-4.18 branch/enterprise-4.19 branch/enterprise-4.20 labels Jul 9, 2025

dfitzmau force-pushed the OSDOCS-14356-new branch from 318fd00 to 1b5443b Compare July 9, 2025 11:27

cybertron reviewed Jul 9, 2025

View reviewed changes

modules/installation-network-user-infra.adoc Outdated Show resolved Hide resolved

modules/installation-user-infra-machines-static-network.adoc Show resolved Hide resolved

modules/installation-user-infra-machines-static-network.adoc Outdated Show resolved Hide resolved

dfitzmau force-pushed the OSDOCS-14356-new branch from 1b5443b to 5b7d324 Compare August 11, 2025 11:12

openshift-ci bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 11, 2025

dfitzmau force-pushed the OSDOCS-14356-new branch 6 times, most recently from 02430e1 to 58716d3 Compare August 11, 2025 12:54

rbbratta reviewed Dec 15, 2025

View reviewed changes

modules/installation-user-infra-machines-static-network.adoc Show resolved Hide resolved

rbbratta reviewed Dec 15, 2025

View reviewed changes

modules/nw-kernel-bonding.adoc Show resolved Hide resolved

rbbratta reviewed Dec 15, 2025

View reviewed changes

modules/installation-user-infra-machines-static-network.adoc Outdated Show resolved Hide resolved

rbbratta reviewed Dec 15, 2025

View reviewed changes

modules/installation-user-infra-machines-static-network.adoc Show resolved Hide resolved

rbbratta reviewed Dec 15, 2025

View reviewed changes

modules/installation-user-infra-machines-static-network.adoc Outdated Show resolved Hide resolved

dfitzmau force-pushed the OSDOCS-14356-new branch 4 times, most recently from a29819f to 3ce4e93 Compare December 16, 2025 15:37

rbbratta reviewed Dec 18, 2025

View reviewed changes

dfitzmau force-pushed the OSDOCS-14356-new branch from 3ce4e93 to 40da5f1 Compare December 18, 2025 13:18

ocpdocs-vale-bot reviewed Dec 18, 2025

View reviewed changes

dfitzmau force-pushed the OSDOCS-14356-new branch from 40da5f1 to a103331 Compare December 18, 2025 14:05

ocpdocs-vale-bot reviewed Dec 18, 2025

View reviewed changes

modules/installation-user-infra-machines-static-network.adoc Show resolved Hide resolved

ocpdocs-vale-bot reviewed Dec 18, 2025

View reviewed changes

modules/nw-kernel-bonding.adoc Show resolved Hide resolved

ocpdocs-vale-bot reviewed Dec 18, 2025

View reviewed changes

modules/nw-ovs-bonding.adoc Show resolved Hide resolved

OSDOCS-14356-New: Added bond best practices info to networking docs

1e179f5

dfitzmau force-pushed the OSDOCS-14356-new branch from a103331 to 1e179f5 Compare December 18, 2025 14:31

ocpdocs-vale-bot reviewed Dec 18, 2025

View reviewed changes

cybertron reviewed Dec 18, 2025

View reviewed changes

		@@ -0,0 +1,15 @@
		// Module included in the following assemblies:

		@@ -0,0 +1,24 @@
		// Module included in the following assemblies:

		@@ -0,0 +1,20 @@
		// Module included in the following assemblies:

		@@ -0,0 +1,16 @@
		// Module included in the following assemblies:

OSDOCS-14356-New: Added bond best practices info to networking docs #93160

Are you sure you want to change the base?

OSDOCS-14356-New: Added bond best practices info to networking docs #93160

Uh oh!

Conversation

dfitzmau commented May 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented May 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

dfitzmau commented May 30, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

openshift-ci bot commented Dec 18, 2025

Uh oh!

cybertron left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

dfitzmau commented May 8, 2025 •

edited

Loading

ocpdocs-previewbot commented May 8, 2025 •

edited

Loading