Merge pull request #96186 from JoeAldinger/OSDOCS-15188-4.20

[4.20] networking overview

Author: stevsmit

_attributes/_attributes

@@ -1 +1 @@
-../../../_attributes/
+../../_attributes/

_topic_maps/_topic_map.yml

@@ -1383,12 +1383,18 @@ Name: Networking
 Dir: networking
 Distros: openshift-enterprise,openshift-origin
 Topics:
-- Name: Understanding networking
-  File: understanding-networking
-- Name: Accessing hosts
-  File: accessing-hosts
-- Name: Networking dashboards
-  File: networking-dashboards
+- Name: Networking overview
+  Dir: networking_overview
+  Distros: openshift-enterprise,openshift-origin
+  Topics:
+  - Name: Understanding networking
+    File: understanding-networking
+  - Name: Accessing hosts
+    File: accessing-hosts
+  - Name: Networking dashboards
+    File: networking-dashboards
+  - Name: CIDR range definitions
+    File: cidr-range-definitions
 - Name: Networking Operators
   Dir: networking_operators
   Distros: openshift-enterprise,openshift-origin
@@ -1543,37 +1549,6 @@ Topics:
     File: configuring-ipsec-ovn
   - Name: Zero trust networking
     File: zero-trust-networking
-- Name: Configuring the Ingress Controller for manual DNS management
-  File: ingress-controller-dnsmgt
-  Distros: openshift-enterprise,openshift-origin
-- Name: Verifying connectivity to an endpoint
-  File: verifying-connectivity-endpoint
-- Name: Changing the cluster network MTU
-  File: changing-cluster-network-mtu
-- Name: Configuring the node port service range
-  File: configuring-node-port-service-range
-- Name: Configuring the cluster network IP address range
-  File: configuring-cluster-network-range
-- Name: Configuring IP failover
-  File: configuring-ipfailover
-- Name: Configuring system controls and interface attributes using the tuning plugin
-  File: configure-syscontrols-interface-tuning-cni
-- Name: Using Stream Control Transmission Protocol
-  File: using-sctp
-  Distros: openshift-enterprise,openshift-origin
-- Name: Using PTP hardware
-  Dir: ptp
-  Topics:
-  - Name: About PTP in OpenShift cluster nodes
-    File: about-ptp
-  - Name: Configuring PTP devices
-    File: configuring-ptp
-  - Name: Developing PTP events consumer applications with the REST API v2
-    File: ptp-cloud-events-consumer-dev-reference-v2
-  - Name: PTP events REST API v2 reference
-    File: ptp-events-rest-api-reference-v2
-- Name: CIDR range definitions
-  File: cidr-range-definitions
 - Name: Multiple networks
   Dir: multiple_networks
   Distros: openshift-enterprise,openshift-origin
@@ -1679,90 +1654,119 @@ Topics:
     File: tracking-network-flows
   - Name: Configuring hybrid networking
     File: configuring-hybrid-networking
-- Name: Configuring Routes
-  Dir: routes
-  Topics:
-  - Name: Route configuration
-    File: route-configuration
-  - Name: Secured routes
-    File: secured-routes
-- Name: Configuring ingress cluster traffic
-  Dir: configuring_ingress_cluster_traffic
-  Topics:
-  - Name: Overview
-    File: overview-traffic
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ExternalIPs for services
-    File: configuring-externalip
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic using an Ingress Controller
-    File: configuring-ingress-cluster-traffic-ingress-controller
-  - Name: Configuring the Ingress Controller endpoint publishing strategy
-    File: nw-configuring-ingress-controller-endpoint-publishing-strategy
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic using a load balancer
-    File: configuring-ingress-cluster-traffic-load-balancer
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic on AWS
-    File: configuring-ingress-cluster-traffic-aws
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic using a service external IP
-    File: configuring-ingress-cluster-traffic-service-external-ip
-    Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic using a NodePort
-    File: configuring-ingress-cluster-traffic-nodeport
+- Name: Ingress and load balancing
+  Dir: ingress_load_balancing
+  Distros: openshift-enterprise,openshift-origin
+  Topics:
+  - Name: Configuring Routes
+    Dir: routes
     Distros: openshift-enterprise,openshift-origin
-  - Name: Configuring ingress cluster traffic using load balancer allowed source ranges
-    File: configuring-ingress-cluster-traffic-load-balancer-allowed-source-ranges
+    Topics:
+    - Name: Route configuration
+      File: route-configuration
+    - Name: Secured routes
+      File: secured-routes
+  - Name: Configuring ingress cluster traffic
+    Dir: configuring_ingress_cluster_traffic
     Distros: openshift-enterprise,openshift-origin
-  - Name: Patching existing ingress objects
-    File: configuring-ingress-cluster-patch-fields
+    Topics:
+    - Name: Overview
+      File: overview-traffic
+    - Name: Configuring ExternalIPs for services
+      File: configuring-externalip
+    - Name: Configuring ingress cluster traffic using an Ingress Controller
+      File: configuring-ingress-cluster-traffic-ingress-controller
+    - Name: Configuring the Ingress Controller endpoint publishing strategy
+      File: nw-configuring-ingress-controller-endpoint-publishing-strategy
+    - Name: Configuring ingress cluster traffic using a load balancer
+      File: configuring-ingress-cluster-traffic-load-balancer
+    - Name: Configuring ingress cluster traffic on AWS
+      File: configuring-ingress-cluster-traffic-aws
+    - Name: Configuring ingress cluster traffic using a service external IP
+      File: configuring-ingress-cluster-traffic-service-external-ip
+    - Name: Configuring ingress cluster traffic using a NodePort
+      File: configuring-ingress-cluster-traffic-nodeport
+    - Name: Configuring ingress cluster traffic using load balancer allowed source ranges
+      File: configuring-ingress-cluster-traffic-load-balancer-allowed-source-ranges
+    - Name: Patching existing ingress objects
+      File: configuring-ingress-cluster-patch-fields
+    - Name: Allocating load balancers to specific subnets
+      File: allocating-load-balancers
+    - Name: Configuring the Ingress Controller for manual DNS management
+      File: ingress-controller-dnsmgt
+    - Name: Gateway API with OpenShift Container Platform networking
+      File: ingress-gateway-api
+  - Name: Load balancing on OpenStack
+    File: load-balancing-openstack
+  - Name: Load balancing with MetalLB
+    Dir: metallb
     Distros: openshift-enterprise,openshift-origin
-  - Name: Allocating load balancers to specific subnets
-    File: allocating-load-balancers
+    Topics:
+    - Name: Configuring MetalLB address pools
+      File: metallb-configure-address-pools
+    - Name: Advertising the IP address pools
+      File: about-advertising-ipaddresspool
+    - Name: Configuring MetalLB BGP peers
+      File: metallb-configure-bgp-peers
+    - Name: Advertising an IP address pool using the community alias
+      File: metallb-configure-community-alias
+    - Name: Configuring MetalLB BFD profiles
+      File: metallb-configure-bfd-profiles
+    - Name: Configuring services to use MetalLB
+      File: metallb-configure-services
+    - Name: Managing symmetric routing with MetalLB
+      File: metallb-configure-return-traffic
+    - Name: Configuring the integration of MetalLB and FRR-K8s
+      File: metallb-frr-k8s
+    - Name: MetalLB logging, troubleshooting, and support
+      File: metallb-troubleshoot-support
+- Name: Configuring network settings
+  Dir: configuring_network_settings
+  Distros: openshift-enterprise,openshift-origin
+  Topics:
+  - Name: Configuring system controls and interface attributes using the tuning plugin
+    File: configure-syscontrols-interface-tuning-cni
+  - Name: Configuring the node port service range
+    File: configuring-node-port-service-range
+  - Name: Configuring the cluster network IP address range
+    File: configuring-cluster-network-range
+  - Name: Configuring IP failover
+    File: configuring-ipfailover
+  - Name: Configuring the cluster-wide proxy
+    File: enable-cluster-wide-proxy
+  - Name: Configuring a custom PKI
+    File: configuring-a-custom-pki
+- Name: Advanced networking
+  Dir: advanced_networking
+  Distros: openshift-enterprise, openshift-origin
+  Topics:
+  - Name: Verifying connectivity to an endpoint
+    File: verifying-connectivity-endpoint
+  - Name: Changing the cluster network MTU
+    File: changing-cluster-network-mtu
+  - Name: Using Stream Control Transmission Protocol
+    File: using-sctp
+  - Name: Associating secondary interfaces metrics to network attachments
+    File: associating-secondary-interfaces-metrics-to-network-attachments
+  - Name: Using PTP hardware
+    Dir: ptp
     Distros: openshift-enterprise,openshift-origin
-  - Name: Gateway API with OpenShift Container Platform networking
-    File: ingress-gateway-api
-    Distros: openshift-enterprise
-  # Kubernetes NMState (TECHNOLOGY PREVIEW)
+    Topics:
+    - Name: About PTP in OpenShift cluster nodes
+      File: about-ptp
+    - Name: Configuring PTP devices
+      File: configuring-ptp
+    - Name: Developing PTP events consumer applications with the REST API v2
+      File: ptp-cloud-events-consumer-dev-reference-v2
+    - Name: PTP events REST API v2 reference
+      File: ptp-events-rest-api-reference-v2
 - Name: Kubernetes NMState
   Dir: k8s_nmstate
   Topics:
   - Name: Observing and updating node network state and configuration
     File: k8s-nmstate-updating-node-network-config
   - Name: Troubleshooting node network configuration
     File: k8s-nmstate-troubleshooting-node-network
-- Name: Configuring the cluster-wide proxy
-  File: enable-cluster-wide-proxy
-  Distros: openshift-enterprise,openshift-origin
-- Name: Configuring a custom PKI
-  File: configuring-a-custom-pki
-  Distros: openshift-enterprise,openshift-origin
-- Name: Load balancing on OpenStack
-  File: load-balancing-openstack
-- Name: Load balancing with MetalLB
-  Dir: metallb
-  Topics:
-  - Name: Configuring MetalLB address pools
-    File: metallb-configure-address-pools
-  - Name: Advertising the IP address pools
-    File: about-advertising-ipaddresspool
-  - Name: Configuring MetalLB BGP peers
-    File: metallb-configure-bgp-peers
-  - Name: Advertising an IP address pool using the community alias
-    File: metallb-configure-community-alias
-  - Name: Configuring MetalLB BFD profiles
-    File: metallb-configure-bfd-profiles
-  - Name: Configuring services to use MetalLB
-    File: metallb-configure-services
-  - Name: Managing symmetric routing with MetalLB
-    File: metallb-configure-return-traffic
-  - Name: Configuring the integration of MetalLB and FRR-K8s
-    File: metallb-frr-k8s
-  - Name: MetalLB logging, troubleshooting, and support
-    File: metallb-troubleshoot-support
-- Name: Associating secondary interfaces metrics to network attachments
-  File: associating-secondary-interfaces-metrics-to-network-attachments
 ---
 Name: Storage
 Dir: storage

_topic_maps/_topic_map_osd.yml

@@ -734,8 +734,13 @@ Name: Networking
 Dir: networking
 Distros: openshift-dedicated
 Topics:
-- Name: About networking
-  File: about-managed-networking
+- Name: Networking overview
+  Dir: networking_overview
+  Topics:
+  - Name: About networking
+    File: about-managed-networking
+  - Name: CIDR range definitions
+    File: cidr-range-definitions
 - Name: Networking Operators
   Dir: networking_operators
   Distros: openshift-dedicated
@@ -748,8 +753,6 @@ Topics:
   File: network-verification
 - Name: Configuring a cluster-wide proxy during installation
   File: configuring-cluster-wide-proxy
-- Name: CIDR range definitions
-  File: cidr-range-definitions
 - Name: Network security
   Dir: network_security
   Distros: openshift-dedicated
@@ -784,13 +787,17 @@ Topics:
   Topics:
   - Name: Enabling multicast for a project
     File: enabling-multicast
-- Name: Configuring Routes
-  Dir: routes
+- Name: Ingress and load balancing
+  Dir: ingress_load_balancing
+  Distros: openshift-dedicated
   Topics:
-  - Name: Route configuration
-    File: route-configuration
-  - Name: Secured routes
-    File: secured-routes
+    - Name: Configuring Routes
+      Dir: routes
+      Topics:
+      - Name: Route configuration
+        File: route-configuration
+      - Name: Secured routes
+        File: secured-routes
 ---
 Name: Building applications
 Dir: applications

_topic_maps/_topic_map_rosa.yml

@@ -981,8 +981,14 @@ Name: Networking
 Dir: networking
 Distros: openshift-rosa
 Topics:
-- Name: About networking
-  File: about-managed-networking
+- Name: Networking overview
+  Dir: networking_overview
+  Distros: openshift-rosa
+  Topics:
+  - Name: About networking
+    File: about-managed-networking
+  - Name: CIDR range definitions
+    File: cidr-range-definitions
 - Name: Networking Operators
   Dir: networking_operators
   Distros: openshift-rosa
@@ -999,8 +1005,6 @@ Topics:
   File: network-verification
 - Name: Configuring a cluster-wide proxy during installation
   File: configuring-cluster-wide-proxy
-- Name: CIDR range definitions
-  File: cidr-range-definitions
 - Name: Network security
   Dir: network_security
   Distros: openshift-rosa
@@ -1049,13 +1053,18 @@ Topics:
   Topics:
   - Name: Enabling multicast for a project
     File: enabling-multicast
-- Name: Configuring Routes
-  Dir: routes
+- Name: Ingress and load balancing
+  Dir: ingress_load_balancing
+  Distros: openshift-rosa
   Topics:
-  - Name: Route configuration
-    File: route-configuration
-  - Name: Secured routes
-    File: secured-routes
+  - Name: Configuring Routes
+    Dir: routes
+    Distros: openshift-rosa
+    Topics:
+    - Name: Route configuration
+      File: route-configuration
+    - Name: Secured routes
+      File: secured-routes
 ---
 Name: Building applications
 Dir: applications

_unused_topics/migrate-from-openshift-sdn.adoc

@@ -37,9 +37,9 @@ include::modules/live-migration-metrics-information.adoc[leveloffset=+3]
 
 * xref:../../networking/network_security/network_policy/about-network-policy.adoc#about-network-policy[About network policy]
 
-* xref:../../networking/changing-cluster-network-mtu.adoc#nw-cluster-mtu-change_changing-cluster-network-mtu[Changing the cluster MTU]
+* xref:../../networking/advanced_networking/changing-cluster-network-mtu.adoc#nw-cluster-mtu-change_changing-cluster-network-mtu[Changing the cluster MTU]
 
-* xref:../../networking/changing-cluster-network-mtu.adoc#mtu-value-selection_changing-cluster-network-mtu[MTU value selection]
+* xref:../../networking/advanced_networking/changing-cluster-network-mtu.adoc#mtu-value-selection_changing-cluster-network-mtu[MTU value selection]
 
 * xref:../../networking/network_security/network_policy/about-network-policy.adoc#nw-networkpolicy-optimize-ovn_about-network-policy[About network policy]
 * OVN-Kubernetes capabilities

applications/deployments/route-based-deployment-strategies.adoc

@@ -35,10 +35,10 @@ include::modules/deployments-ab-testing.adoc[leveloffset=+1]
 include::modules/deployments-ab-testing-lb.adoc[leveloffset=+2]
 
 ifndef::openshift-rosa-hcp[]
-// Remove conditionals when Networking content is in ROSA HCP 
+// Remove conditionals when Networking content is in ROSA HCP
 [role="_additional-resources"]
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations].
+* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations].
 endif::[]

architecture/index.adoc

@@ -20,7 +20,7 @@ include::modules/openshift-architecture-common-terms.adoc[leveloffset=+1]
 
 // Topic not included in the OSD/ROSA docs
 ifndef::openshift-dedicated,openshift-rosa[]
-* For more information on networking, see xref:../networking/understanding-networking.adoc#understanding-networking[{product-title} networking].
+* For more information on networking, see xref:../networking/networking_overview/understanding-networking.adoc#understanding-networking[{product-title} networking].
 endif::openshift-dedicated,openshift-rosa[]
 * For more information on storage, see xref:../storage/index.adoc#index[{product-title} storage].
 * For more information on authentication, see xref:../authentication/index.adoc#index[{product-title} authentication].