Merge pull request #85271 from dfitzmau/OSDOCS-12303-phase3-16

[enterprise-4.16] OSDOCS-12303-phase3: Restructure the Networking docs for Operators

Author: dfitzmau

_topic_maps/_topic_map.yml

@@ -1326,14 +1326,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
@@ -1344,16 +1358,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
@@ -1396,8 +1400,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
@@ -1412,15 +1414,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
@@ -1644,12 +1637,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

@@ -816,33 +816,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: OpenShift OVN default CNI network provider
-  Dir: ovn_kubernetes_network_provider
+- Name: Networking Operators
+  Dir: networking_operators
+  Distros: openshift-dedicated
   Topics:
-  - Name: About the OpenShift OVN network plugin
-    File: about-ovn-kubernetes
-# TODO OSDOCS-11397: The next file was not present in OSD initially, need to verify if it applies
-  # - Name: Configuring an egress IP address
-  #   File: configuring-egress-ips-ovn
-  - Name: Enabling multicast for a project
-    File: enabling-multicast
-# - Name: OpenShift SDN default CNI network provider
-#   Dir: openshift_sdn
-#   Topics:
-#   - Name: Enabling multicast for a project
-#     File: enabling-multicast
+  - 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
@@ -869,6 +850,16 @@ Topics:
       File: deleting-network-policy
     - Name: Configuring multitenant isolation with network policy
       File: multitenant-network-policy
+- Name: OVN-Kubernetes network plugin
+  Dir: ovn_kubernetes_network_provider
+  Topics:
+  - Name: About the OVN-Kubernetes network plugin
+    File: about-ovn-kubernetes
+- Name: OpenShift SDN network plugin
+  Dir: ovn_kubernetes_network_provider
+  Topics:
+  - Name: Enabling multicast for a project
+    File: enabling-multicast
 - Name: Configuring Routes
   Dir: routes
   Topics:

_topic_maps/_topic_map_rosa.yml

@@ -1084,25 +1084,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: OpenShift OVN default CNI network provider
-  Dir: ovn_kubernetes_network_provider
-  Topics:
-  - Name: About the OpenShift OVN network plugin
-    File: about-ovn-kubernetes
-  - Name: Configuring an egress IP address
-    File: configuring-egress-ips-ovn
-  - Name: Enabling multicast for a project
-    File: enabling-multicast
+  - 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
@@ -1141,8 +1128,18 @@ 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:
+  - Name: About the OVN-Kubernetes network plugin
+    File: about-ovn-kubernetes
+  - Name: Configuring an egress IP address
+    File: configuring-egress-ips-ovn
+- Name: OpenShift SDN network plugin
+  Dir: ovn_kubernetes_network_provider
+  Topics:
+  - Name: Enabling multicast for a project
+    File: enabling-multicast
 - Name: Configuring Routes
   Dir: routes
   Topics:

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

@@ -26,6 +26,11 @@ include::modules/rosa-create-objects.adoc[leveloffset=+1]
 * See xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-aws-prereqs.adoc#rosa-security-groups_prerequisites[Additional custom security groups] for information about security group requirements.
 
 include::modules/rosa-edit-objects.adoc[leveloffset=+1]
+
+[role="_additional-resources_1"]
+== Additional resources
+* 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]
 include::modules/rosa-list-objects.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 CNO uses iptables rules in xref:../networking/openshift_sdn/configuring-kube-proxy.adoc#configuring-kube-proxy[kube-proxy] to direct traffic between nodes and pods running on those nodes. 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.

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]
 ====

installing/installing_bare_metal_ipi/ipi-install-prerequisites.adoc

@@ -44,7 +44,7 @@ include::modules/ipi-install-network-requirements.adoc[leveloffset=+1]
 [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]
 
 include::modules/ipi-install-configuring-nodes.adoc[leveloffset=+1]
 

installing/installing_gcp/installing-gcp-user-infra.adoc

@@ -148,6 +148,6 @@ include::modules/cluster-telemetry.adoc[leveloffset=+1]
 
 == Next steps
 
-* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
-* If necessary, you can xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting].
-* xref:../../networking/ingress-operator.adoc#nw-ingress-controller-configuration-gcp-global-access_configuring-ingress[Configure Global Access for an Ingress Controller on GCP].
+* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
+* If necessary, you can xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting]
+* xref:../../networking/networking_operators/ingress-operator.adoc#nw-ingress-controller-configuration-gcp-global-access_configuring-ingress[Configuring Global Access for an Ingress Controller on {gcp-short}]

networking/cidr-range-definitions.adoc

@@ -65,7 +65,7 @@ You can expand the range after cluster installation.
 
 [role="_additional-resources"]
 .Additional resources
-* xref:../networking/cluster-network-operator.adoc#nw-operator-cr-cno-object_cluster-network-operator[Cluster Network Operator configuration]
+* xref:../networking/networking_operators/cluster-network-operator.adoc#nw-operator-cr_cluster-network-operator[Cluster Network Operator configuration]
 * xref:../networking/configuring-cluster-network-range.adoc#configuring-cluster-network-range[Configuring the cluster network range]
 endif::openshift-enterprise[]
 

networking/configuring_ingress_cluster_traffic/configuring-ingress-cluster-traffic-ingress-controller.adoc

@@ -79,7 +79,7 @@ include::modules/nw-ingress-sharding-route-configuration.adoc[leveloffset=+2]
 
 * xref:../../scalability_and_performance/optimization/routing-optimization.adoc#baseline-router-performance_routing-optimization[Baseline Ingress Controller (router) performance]
 
-* xref:../../networking/ingress-operator.adoc#configuring-ingress[Ingress Operator in {product-title}]
+* xref:../../networking/networking_operators/ingress-operator.adoc#configuring-ingress-controller[Configuring the Ingress Controller]
 
 * xref:../../installing/installing_bare_metal/installing-bare-metal.adoc#installing-bare-metal[Installing a cluster on bare metal]