Merge pull request #85085 from dfitzmau/OSDOCS-12303-phase3

OSDOCS-12303-phase3: Restructure the Networking docs for Operators

Author: dfitzmau

_topic_maps/_topic_map.yml

@@ -1396,14 +1396,28 @@ Topics:
       File: nw-creating-dns-records-on-infoblox
     - Name: Configuring the cluster-wide proxy on the External DNS Operator
       File: nw-configuring-cluster-wide-egress-proxy
-#   - Name: Understanding the Ingress Node Firewall Operator
-#     File: ingress-node-firewall-operator
-#   - Name: Understanding the Cluster Network Operator
-#     File: cluster-network-operator
-#   - Name: Understanding the DNS Operator
-#     File: dns-operator
-#   - Name: Understanding the Ingress Operator
-#     File: ingress-operator
+  - Name: MetalLB Operator
+    Dir: metallb-operator
+    Distros: openshift-enterprise,openshift-origin
+    Topics:
+    - Name: About MetalLB and the MetalLB Operator
+      File: about-metallb
+    - Name: Installing the MetalLB Operator
+      File: metallb-operator-install
+    - Name: Upgrading the MetalLB Operator
+      File: metallb-upgrading-operator
+  - Name: Understanding the Cluster Network Operator
+    File: cluster-network-operator
+    Distros: openshift-enterprise,openshift-origin
+  - Name: Understanding the DNS Operator
+    File: dns-operator
+    Distros: openshift-enterprise,openshift-origin
+  - Name: Understanding the Ingress Operator
+    File: ingress-operator
+    Distros: openshift-enterprise,openshift-origin
+  - Name: Understanding the Ingress Node Firewall Operator
+    File: ingress-node-firewall-operator
+    Distros: openshift-enterprise,openshift-origin
 #   - Name: SR-IOV Operator
 #     Dir: sr-iov-operator
 #     Distros: openshift-enterprise,openshift-origin
@@ -1414,16 +1428,6 @@ Topics:
 #       File: configuring-sriov-operator
 #     - Name: Uninstalling the SR-IOV Operator
 #       File: uninstalling-sriov-operator
-#   - Name: MetalLB Operator
-#     Dir: metallb-operator
-#     Distros: openshift-enterprise,openshift-origin
-#     Topics:
-#     - Name: About MetalLB and the MetalLB Operator
-#       File: about-metallb
-#     - Name: Installing the MetalLB Operator
-#       File: metallb-operator-install
-#     - Name: Upgrading the MetalLB Operator
-#       File: metallb-upgrading-operator
 - Name: Network security
   Dir: network_security
   Distros: openshift-enterprise,openshift-origin
@@ -1466,8 +1470,6 @@ Topics:
       File: multitenant-network-policy
   - Name: Audit logging for network security
     File: logging-network-security
-  - Name: Understanding the Ingress Node Firewall Operator
-    File: ingress-node-firewall-operator
   - Name: Egress Firewall
     Dir: egress_firewall
     Distros: openshift-enterprise,openshift-origin
@@ -1482,15 +1484,6 @@ Topics:
       File: configuring-egress-firewall-ovn
   - Name: Configuring IPsec encryption
     File: configuring-ipsec-ovn
-- Name: Understanding the Cluster Network Operator
-  File: cluster-network-operator
-  Distros: openshift-enterprise,openshift-origin
-- Name: Understanding the DNS Operator
-  File: dns-operator
-  Distros: openshift-enterprise,openshift-origin
-- Name: Understanding the Ingress Operator
-  File: ingress-operator
-  Distros: openshift-enterprise,openshift-origin
 - Name: Configuring the Ingress Controller for manual DNS management
   File: ingress-controller-dnsmgt
   Distros: openshift-enterprise,openshift-origin
@@ -1674,12 +1667,6 @@ Topics:
 - Name: Load balancing with MetalLB
   Dir: metallb
   Topics:
-  - Name: About MetalLB and the MetalLB Operator
-    File: about-metallb
-  - Name: Installing the MetalLB Operator
-    File: metallb-operator-install
-  - Name: Upgrading the MetalLB Operator
-    File: metallb-upgrading-operator
   - Name: Configuring MetalLB address pools
     File: metallb-configure-address-pools
   - Name: Advertising the IP address pools

_topic_maps/_topic_map_osd.yml

@@ -823,18 +823,14 @@ Distros: openshift-dedicated
 Topics:
 - Name: About networking
   File: about-managed-networking
-# - Name: Networking Operators
-#   Dir: networking_operators
-#   Distros: openshift-dedicated
-#   Topics:
-#   - Name: Understanding the DNS Operator
-#     File: dns-operator
-#   - Name: Understanding the Ingress Operator
-#     File: ingress-operator
-- Name: Understanding the DNS Operator
-  File: dns-operator
-- Name: Understanding the Ingress Operator
-  File: ingress-operator
+- Name: Networking Operators
+  Dir: networking_operators
+  Distros: openshift-dedicated
+  Topics:
+  - Name: Understanding the DNS Operator
+    File: dns-operator
+  - Name: Understanding the Ingress Operator
+    File: ingress-operator
 - Name: Network verification
   File: network-verification
 - Name: Configuring a cluster-wide proxy during installation

_topic_maps/_topic_map_rosa.yml

@@ -1088,16 +1088,12 @@ Topics:
   Topics:
   - Name: AWS Load Balancer Operator
     File: aws-load-balancer-operator
-  # - Name: Understanding the DNS Operator
-  #   File: dns-operator
-  # - Name: Understanding the Ingress Operator
-  #   File: ingress-operator
-  # - Name: Understanding the Ingress Node Firewall Operator
-  #   File: ingress-node-firewall-operator
-- Name: Understanding the DNS Operator
-  File: dns-operator
-- Name: Understanding the Ingress Operator
-  File: ingress-operator
+  - Name: Understanding the DNS Operator
+    File: dns-operator
+  - Name: Understanding the Ingress Operator
+    File: ingress-operator
+  - Name: Understanding the Ingress Node Firewall Operator
+    File: ingress-node-firewall-operator
 - Name: Network verification
   File: network-verification
 - Name: Configuring a cluster-wide proxy during installation
@@ -1136,8 +1132,6 @@ Topics:
       File: default-network-policy
     - Name: Configuring multitenant isolation with network policy
       File: multitenant-network-policy
-  - Name: Understanding the Ingress Node Firewall Operator
-    File: ingress-node-firewall-operator
 - Name: OVN-Kubernetes network plugin
   Dir: ovn_kubernetes_network_provider
   Topics:

_unused_topics/migrate-from-openshift-sdn.adoc

@@ -30,20 +30,35 @@ include::modules/live-migration-metrics-information.adoc[leveloffset=+3]
 == Additional resources
 
 * link:https://access.redhat.com/labs/ocpnc/[Red Hat OpenShift Network Calculator]
-* xref:../../networking/cluster-network-operator.adoc#nw-operator-configuration-parameters-for-ovn-sdn_cluster-network-operator[Configuration parameters for the OVN-Kubernetes network plugin]
+
+* xref:../networking/networking_operators/cluster-network-operator.adoc#nw-operator-cr_cluster-network-operator[Configuration for the OVN-Kubernetes network plugin]
+
 * xref:../../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backup-etcd[Backing up etcd]
+
 * 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/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
+
 - xref:../../networking/ovn_kubernetes_network_provider/configuring-egress-ips-ovn.adoc#configuring-egress-ips-ovn[Configuring an egress IP address]
+
 - xref:../../networking/network_security/egress_firewall/configuring-egress-firewall-ovn.adoc#configuring-egress-firewall-ovn[Configuring an egress firewall for a project]
+
 - link:https://access.redhat.com/solutions/7078619[OVN-Kubernetes egress firewall blocks process to deploy application as DeploymentConfig]
+
 - xref:../../networking/ovn_kubernetes_network_provider/enabling-multicast.adoc#nw-ovn-kubernetes-enabling-multicast[Enabling multicast for a project]
 * OpenShift SDN capabilities
+
 - xref:../../networking/openshift_sdn/assigning-egress-ips.adoc#assigning-egress-ips[Configuring egress IPs for a project]
+
 - xref:../../networking/openshift_sdn/configuring-egress-firewall.adoc#configuring-egress-firewall[Configuring an egress firewall for a project]
+
 - xref:../../networking/openshift_sdn/enabling-multicast.adoc#enabling-multicast[Enabling multicast for a project]
+
 - xref:../../networking/openshift_sdn/deploying-egress-router-layer3-redirection.adoc#deploying-egress-router-layer3-redirection[Deploying an egress router pod in redirect mode]
-* xref:../../rest_api/operator_apis/network-operator-openshift-io-v1.adoc#network-operator-openshift-io-v1[Network [operator.openshift.io/v1]]
+
+* xref:../../rest_api/operator_apis/network-operator-openshift-io-v1.adoc#network-operator-openshift-io-v1[Network [operator.openshift.io/v1]

cli_reference/rosa_cli/rosa-manage-objects-cli.adoc

@@ -29,7 +29,7 @@ include::modules/rosa-edit-objects.adoc[leveloffset=+1]
 
 [role="_additional-resources_1"]
 == Additional resources
-* See xref:../../networking/ingress-operator.adoc#configuring-ingress-controller[Configuring the Ingress Controller] for information regarding editing non-default application routers.
+* See xref:../../networking/networking_operators/ingress-operator.adoc#configuring-ingress-controller[Configuring the Ingress Controller] for information regarding editing non-default application routers.
 
 include::modules/rosa-delete-objects.adoc[leveloffset=+1]
 include::modules/rosa-install-uninstall-addon.adoc[leveloffset=+1]

getting_started/openshift-overview.adoc

@@ -90,7 +90,7 @@ of the {product-title} {product-version} control plane. See how {product-title}
 * **xref:../authentication/understanding-authentication.adoc#understanding-authentication[Manage authentication]**: Learn how user, group, and API authentication
 works in {product-title}. {product-title} supports multiple identity providers.
 
-* **xref:../networking/understanding-networking.adoc#understanding-networking[Manage networking]**: The cluster network in {product-title} is managed by the xref:../networking/cluster-network-operator.adoc#cluster-network-operator[Cluster Network Operator] (CNO). The Multus Container Network Interface adds the capability to attach xref:../networking/multiple_networks/understanding-multiple-networks.adoc#understanding-multiple-networks[multiple network interfaces] to a pod. Using
+* **xref:../networking/understanding-networking.adoc#understanding-networking[Manage networking]**: The cluster network in {product-title} is managed by the xref:../networking/networking_operators/cluster-network-operator.adoc#nw-cluster-network-operator_cluster-network-operator[Cluster Network Operator] (CNO). The Multus Container Network Interface adds the capability to attach xref:../networking/multiple_networks/understanding-multiple-networks.adoc#understanding-multiple-networks[multiple network interfaces] to a pod. Using
 xref:../networking/network_security/network_policy/about-network-policy.adoc#about-network-policy[network policy] features, you can isolate your pods or permit selected traffic.
 
 * **xref:../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Manage storage]**: {product-title} allows cluster administrators to configure persistent storage.

hosted_control_planes/hcp-deploy/hcp-deploy-virt.adoc

@@ -77,7 +77,7 @@ include::modules/hcp-metallb.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* For more information about MetalLB, see xref:../../networking/metallb/metallb-operator-install.adoc#metallb-operator-install[Installing the MetalLB Operator].
+* For more information about MetalLB, see xref:../../networking/networking_operators/metallb-operator/metallb-operator-install.adoc#metallb-operator-install_metallb-operator-install[Installing the MetalLB Operator].
 
 [id="hcp-virt-addl-resources"]
 == Configuring additional networks, guaranteed CPUs, and VM scheduling for node pools

hosted_control_planes/hcp-manage/hcp-manage-bm.adoc

@@ -24,7 +24,7 @@ include::modules/hcp-bm-ingress.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../networking/metallb/about-metallb.adoc#about-metallb[About MetalLB and the MetalLB Operator]
+* xref:../../networking/networking_operators/metallb-operator/about-metallb.adoc#about-metallb_about-metallb[About MetalLB and the MetalLB Operator]
 
 include::modules/hcp-bm-machine-health.adoc[leveloffset=+1]
 include::modules/hcp-bm-machine-health-disable.adoc[leveloffset=+1]

hosted_control_planes/hcp-manage/hcp-manage-non-bm.adoc

@@ -24,7 +24,7 @@ include::modules/hcp-bm-ingress.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../networking/metallb/about-metallb.adoc#about-metallb[About MetalLB and the MetalLB Operator]
+* xref:../../networking/networking_operators/metallb-operator/about-metallb.adoc#about-metallb_about-metallb[About MetalLB and the MetalLB Operator]
 
 include::modules/hcp-bm-machine-health.adoc[leveloffset=+1]
 include::modules/hcp-bm-machine-health-disable.adoc[leveloffset=+1]

installing/installing_bare_metal/ipi/ipi-install-overview.adoc

@@ -37,7 +37,7 @@ For installer-provisioned infrastructure installations, CoreDNS exposes port 53
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../networking/dns-operator.adoc#nw-dns-forward_dns-operator[Using DNS forwarding]
+* xref:../../../networking/networking_operators/dns-operator.adoc#nw-dns-forward_dns-operator[Using DNS forwarding]
 
 [IMPORTANT]
 ====