networking overview #95770

JoeAldinger · 2025-07-08T19:13:19Z

Version(s):
4.17+

Issue:
https://issues.redhat.com/browse/OSDOCS-15186

Link to docs preview:
https://95770--ocpdocs-pr.netlify.app/

QE review:

QE has approved this change.

Additional information:
This PR reorganizes the Networking book into 10 separate books with sub-directories.

stevsmit · 2025-07-08T19:29:23Z

/retest

ocpdocs-previewbot · 2025-07-08T19:35:06Z

🤖 Wed Jul 16 18:31:39 - Prow CI generated the docs preview:
https://95770--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

hosted_control_planes/hcp-prepare/hcp-requirements.adoc

ocpdocs-vale-bot · 2025-07-09T16:59:21Z

modules/rosa-hcp-sts-creating-a-cluster-cli-no-cni-plugin.adoc

@@ -24,7 +24,7 @@ When using the {product-title} (ROSA) command-line interface (CLI), `rosa`, to c
 +
 [NOTE]
 ====
-When creating a {hcp-title} cluster, the default machine Classless Inter-Domain Routing (CIDR) is `10.0.0.0/16`. If this does not correspond to the CIDR range for your VPC subnets, add `--machine-cidr <address_block>` to the following commands. To learn more about the default CIDR ranges for {product-title}, see xref:../networking/cidr-range-definitions.adoc#cidr-range-definitions[CIDR range definitions].
+When creating a {hcp-title} cluster, the default machine Classless Inter-Domain Routing (CIDR) is `10.0.0.0/16`. If this does not correspond to the CIDR range for your VPC subnets, add `--machine-cidr <address_block>` to the following commands. To learn more about the default CIDR ranges for {product-title}, see xref:../networking/networking_overview/cidr-range-definitions.adoc#cidr-range-definitions[CIDR range definitions].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies.

networking/configuring-cluster-wide-proxy.adoc

Ingress and load balancing Advanced networking configuring network settings

openshift-ci · 2025-07-16T18:35:25Z

@JoeAldinger: all tests passed!

Full PR test history. Your PR dashboard.

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.

stevsmit · 2025-07-16T19:40:47Z

Let's goooooooooooooo

stevsmit · 2025-07-16T19:41:15Z

We've compiled a list of things that could be fixed in the future. Nothing damning here; all of the xrefs work and the git diff looks good. Merging.

stevsmit · 2025-07-16T19:41:29Z

/cherry-pick enterprise-4.20

openshift-cherrypick-robot · 2025-07-16T19:42:15Z

@stevsmit: #95770 failed to apply on top of branch "enterprise-4.20":

Applying: networking overview
Using index info to reconstruct a base tree...
M	_topic_maps/_topic_map.yml
M	_topic_maps/_topic_map_osd.yml
M	_topic_maps/_topic_map_rosa.yml
M	installing/installing_aws/ipi/installing-aws-network-customizations.adoc
M	networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
M	networking/metallb/metallb-troubleshoot-support.adoc
M	networking/networking_operators/metallb-operator/about-metallb.adoc
M	welcome/learn_more_about_openshift.adoc
Falling back to patching base and 3-way merge...
Auto-merging welcome/learn_more_about_openshift.adoc
Auto-merging networking/networking_operators/metallb-operator/about-metallb.adoc
Auto-merging networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/routes/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/modules
Auto-merging networking/ingress_load_balancing/metallb/metallb-troubleshoot-support.adoc
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/images
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/configuring_ingress_cluster_traffic/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/_attributes
CONFLICT (content): Merge conflict in networking/configuring_network_settings/modules
CONFLICT (content): Merge conflict in networking/configuring_network_settings/images
CONFLICT (content): Merge conflict in networking/configuring_network_settings/_attributes
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/snippets
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/modules
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/images
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/_attributes
CONFLICT (content): Merge conflict in networking/advanced_networking/modules
CONFLICT (content): Merge conflict in networking/advanced_networking/images
CONFLICT (content): Merge conflict in networking/advanced_networking/_attributes
Auto-merging installing/installing_aws/ipi/installing-aws-network-customizations.adoc
Auto-merging _topic_maps/_topic_map_rosa.yml
Auto-merging _topic_maps/_topic_map_osd.yml
Auto-merging _topic_maps/_topic_map.yml
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 networking overview

In response to this:

/cherry-pick enterprise-4.20

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.

stevsmit · 2025-07-16T19:43:39Z

/cherry-pick enterprise-4.19

openshift-cherrypick-robot · 2025-07-16T19:44:27Z

@stevsmit: #95770 failed to apply on top of branch "enterprise-4.19":

Applying: networking overview
Using index info to reconstruct a base tree...
M	_topic_maps/_topic_map.yml
M	_topic_maps/_topic_map_osd.yml
M	_topic_maps/_topic_map_rosa.yml
M	installing/installing_aws/ipi/installing-aws-network-customizations.adoc
M	networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
M	networking/metallb/metallb-troubleshoot-support.adoc
M	networking/networking_operators/metallb-operator/about-metallb.adoc
M	welcome/learn_more_about_openshift.adoc
Falling back to patching base and 3-way merge...
Auto-merging welcome/learn_more_about_openshift.adoc
Auto-merging networking/networking_operators/metallb-operator/about-metallb.adoc
Auto-merging networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/routes/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/modules
Auto-merging networking/ingress_load_balancing/metallb/metallb-troubleshoot-support.adoc
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/metallb/images
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/configuring_ingress_cluster_traffic/snippets
CONFLICT (content): Merge conflict in networking/ingress_load_balancing/_attributes
CONFLICT (content): Merge conflict in networking/configuring_network_settings/modules
CONFLICT (content): Merge conflict in networking/configuring_network_settings/images
CONFLICT (content): Merge conflict in networking/configuring_network_settings/_attributes
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/snippets
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/modules
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/images
CONFLICT (content): Merge conflict in networking/advanced_networking/ptp/_attributes
CONFLICT (content): Merge conflict in networking/advanced_networking/modules
CONFLICT (content): Merge conflict in networking/advanced_networking/images
CONFLICT (content): Merge conflict in networking/advanced_networking/_attributes
Auto-merging installing/installing_aws/ipi/installing-aws-network-customizations.adoc
Auto-merging _topic_maps/_topic_map_rosa.yml
Auto-merging _topic_maps/_topic_map_osd.yml
Auto-merging _topic_maps/_topic_map.yml
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 networking overview

In response to this:

/cherry-pick enterprise-4.19

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.

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

JoeAldinger force-pushed the OSDOCS-15188 branch from 10e0592 to 642bdf2 Compare July 8, 2025 20:05

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 Jul 8, 2025

ocpdocs-vale-bot reviewed Jul 8, 2025

View reviewed changes

hosted_control_planes/hcp-prepare/hcp-requirements.adoc Show resolved Hide resolved

JoeAldinger force-pushed the OSDOCS-15188 branch 5 times, most recently from e62fd11 to 89dfe87 Compare July 9, 2025 16:47

ocpdocs-vale-bot reviewed Jul 9, 2025

View reviewed changes

JoeAldinger force-pushed the OSDOCS-15188 branch 3 times, most recently from 48ffcc0 to 838210a Compare July 9, 2025 18:17

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 Jul 9, 2025

JoeAldinger force-pushed the OSDOCS-15188 branch 12 times, most recently from 091e6a9 to 6a8fe9c Compare July 14, 2025 14:28

ocpdocs-vale-bot reviewed Jul 15, 2025

View reviewed changes

networking/configuring-cluster-wide-proxy.adoc Outdated Show resolved Hide resolved

JoeAldinger force-pushed the OSDOCS-15188 branch 5 times, most recently from e8ffdb2 to b91a588 Compare July 16, 2025 13:37

stevsmit added peer-review-in-progress Signifies that the peer review team is reviewing this PR branch/enterprise-4.20 labels Jul 16, 2025

stevsmit added this to the Continuous Release milestone Jul 16, 2025

JoeAldinger force-pushed the OSDOCS-15188 branch from b91a588 to 4864bba Compare July 16, 2025 18:15

networking overview

bde73e2

Ingress and load balancing Advanced networking configuring network settings

JoeAldinger force-pushed the OSDOCS-15188 branch from 4864bba to bde73e2 Compare July 16, 2025 18:19

stevsmit added branch/enterprise-4.17 branch/enterprise-4.18 branch/enterprise-4.19 labels Jul 16, 2025

stevsmit added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-in-progress Signifies that the peer review team is reviewing this PR labels Jul 16, 2025

stevsmit merged commit c641ded into openshift:main Jul 16, 2025
2 checks passed

stevsmit mentioned this pull request Jul 16, 2025

[4.20] networking overview #96186

Merged

This was referenced Jul 17, 2025

[enterprise-4.19] networking overview #96191

Merged

[enterprise-4.18] networking overview #96225

Merged

JoeAldinger mentioned this pull request Jul 29, 2025

merge conflicts 4.17 #96684

Merged

1 task

dfitzmau mentioned this pull request Jul 31, 2025

OSDOCS-3467: Updated configuration-externalip.adoc for private cluster #96695

Merged

2 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

networking overview #95770

networking overview #95770

Uh oh!

JoeAldinger commented Jul 8, 2025 •

edited

Loading

Uh oh!

stevsmit commented Jul 8, 2025

Uh oh!

ocpdocs-previewbot commented Jul 8, 2025 •

edited

Loading

Uh oh!

Uh oh!

ocpdocs-vale-bot Jul 9, 2025

Uh oh!

Uh oh!

openshift-ci bot commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

openshift-cherrypick-robot commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

openshift-cherrypick-robot commented Jul 16, 2025

Uh oh!

Uh oh!

networking overview #95770

networking overview #95770

Uh oh!

Conversation

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

Uh oh!

Uh oh!

stevsmit commented Jul 8, 2025

Uh oh!

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

Uh oh!

Uh oh!

Uh oh!

ocpdocs-vale-bot Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

openshift-ci bot commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

openshift-cherrypick-robot commented Jul 16, 2025

Uh oh!

stevsmit commented Jul 16, 2025

Uh oh!

openshift-cherrypick-robot commented Jul 16, 2025

Uh oh!

Uh oh!

JoeAldinger commented Jul 8, 2025 •

edited

Loading

ocpdocs-previewbot commented Jul 8, 2025 •

edited

Loading