OSDOCS-16026 4 category restructure

jmanthei · jmanthei · commit 15b7cbd408f2 · 2025-10-08T15:45:38.000-05:00
diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
@@ -1647,14 +1647,18 @@ Topics:
   Dir: ingress_load_balancing
   Distros: openshift-enterprise,openshift-origin
   Topics:
-  - Name: Configuring Routes
+  - Name: Routes
     Dir: routes
     Distros: openshift-enterprise,openshift-origin
     Topics:
-    - Name: Route configuration
-      File: route-configuration
-    - Name: Secured routes
-      File: secured-routes
+    - Name: Creating basic routes
+      File: creating-basic-routes
+    - Name: Securing routes
+      File: securing-routes
+    - Name: Configuring routes
+      File: nw-configuring-routes
+    - Name: Creating advanced routes
+      File: creating-advanced-routes
   - Name: Configuring ingress cluster traffic
     Dir: configuring_ingress_cluster_traffic
     Distros: openshift-enterprise,openshift-origin
diff --git a/_topic_maps/_topic_map_osd.yml b/_topic_maps/_topic_map_osd.yml
@@ -787,13 +787,17 @@ Topics:
   Dir: ingress_load_balancing
   Distros: openshift-dedicated
   Topics:
+  - Name: Routes
+    Dir: routes
+    Topics:
+    - Name: Creating basic routes
+      File: creating-basic-routes
+    - Name: Securing routes
+      File: securing-routes
     - Name: Configuring Routes
-      Dir: routes
-      Topics:
-      - Name: Route configuration
-        File: route-configuration
-      - Name: Secured routes
-        File: secured-routes
+      File: nw-configuring-routes
+    - Name: Creating advanced Routes
+      File: creating-advanced-routes
 ---
 Name: Building applications
 Dir: applications
diff --git a/_topic_maps/_topic_map_rosa.yml b/_topic_maps/_topic_map_rosa.yml
@@ -1013,14 +1013,17 @@ Topics:
   Dir: ingress_load_balancing
   Distros: openshift-rosa
   Topics:
-  - Name: Configuring Routes
-    Dir: routes
-    Distros: openshift-rosa
-    Topics:
-    - Name: Route configuration
-      File: route-configuration
-    - Name: Secured routes
-      File: secured-routes
+   - Name: Routes
+     Dir: routes
+     Topics:
+     - Name: Creating basic routes
+       File: creating-basic-routes
+     - Name: Securing routes
+       File: securing-routes
+     - Name: Configuring Routes
+       File: nw-configuring-routes
+     - Name: Creating advanced Routes
+       File: creating-advanced-routes  - Name: Configuring Routes
 ---
 Name: Building applications
 Dir: applications
diff --git a/_topic_maps/_topic_map_rosa_hcp.yml b/_topic_maps/_topic_map_rosa_hcp.yml
@@ -1052,14 +1052,17 @@ Topics:
   Dir: ingress_load_balancing
   Distros: openshift-rosa-hcp
   Topics:
-  - Name: Configuring Routes
+  - Name: Routes
     Dir: routes
-    Distros: openshift-rosa-hcp
     Topics:
-    - Name: Route configuration
-      File: route-configuration
-    - Name: Secured routes
-      File: secured-routes
+    - Name: Creating basic routes
+      File: creating-basic-routes
+    - Name: Securing routes
+      File: securing-routes
+    - Name: Configuring Routes
+      File: nw-configuring-routes
+    - Name: Creating advanced Routes
+      File: creating-advanced-routes
 ---
 Name: Nodes
 Dir: nodes
diff --git a/applications/deployments/route-based-deployment-strategies.adoc b/applications/deployments/route-based-deployment-strategies.adoc
@@ -40,5 +40,4 @@ ifndef::openshift-rosa-hcp[]
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations].
-endif::[]
+* xref:../../networking/ingress_load_balancing/routes/nw-configuring-routes.adoc#nw-route-specific-annotations[Route-specific annotations]
diff --git a/cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-openshift-concepts.adoc b/cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-openshift-concepts.adoc
@@ -127,7 +127,7 @@ An individual route can override some defaults by providing specific configurati
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../networking/ingress_load_balancing/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]
 
 [id="cloud-experts-getting-started-openshift-concepts-imagestreams"]
 == Image streams
diff --git a/networking/ingress_load_balancing/routes/creating-advanced-routes.adoc b/networking/ingress_load_balancing/routes/creating-advanced-routes.adoc
@@ -0,0 +1,24 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="creating-advanced-routes"]
+ = Creating advanced routes
+
+toc::[]
+
+You can create secure routes with the ability to use several types of TLS termination to serve certificates to the client. The following sections describe how to create re-encrypt, edge, and passthrough routes with custom certificates.
+
+
+//Creating an edge route with a custom certificate
+include::modules/nw-ingress-creating-an-edge-route-with-a-custom-certificate.adoc[leveloffset=+1]
+
+//Creating a reencrypt route with a custom certificate
+include::modules/nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate.adoc[leveloffset=+1]
+
+//Creating a passthrough route
+include::modules/nw-ingress-creating-a-passthrough-route.adoc[leveloffset=+1]
+
+//Creating a route using the destination CA certificate
+include::modules/nw-ingress-reencrypt-route-custom-cert.adoc[leveloffset=+1]
+
+//Creating a route with externally managed certificates
+include::modules/nw-ingress-route-secret-load-external-cert.adoc[leveloffset=+1]
diff --git a/networking/ingress_load_balancing/routes/creating-basic-routes.adoc b/networking/ingress_load_balancing/routes/creating-basic-routes.adoc
@@ -0,0 +1,13 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="creating-basic-routes"]
+= Creating basic routes
+:context: configuring-routes
+
+toc::[]
+
+If you have unencrypted HTTP, you can create a basic route with a route object.
+
+include::modules/nw-creating-a-route.adoc[leveloffset=+1]
+
+include::modules/nw-path-based-routes.adoc[leveloffset=+1]
diff --git a/networking/ingress_load_balancing/routes/nw-configuring-routes.adoc b/networking/ingress_load_balancing/routes/nw-configuring-routes.adoc
@@ -0,0 +1,27 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="nw-configuring-routes"]
+= Configuring routes
+:context: configuring-routes
+
+toc::[]
+
+You can use annotations, headers, cookies, and more to customize your route configuration.
+
+//Configuring route timeouts
+include::modules/nw-configuring-route-timeouts.adoc[leveloffset=+1]
+
+//HTTP header configuration
+include::modules/nw-http-header-configuration.adoc[leveloffset=+1]
+
+//Setting or deleting http headers
+include::modules/nw-route-set-or-delete-http-headers.adoc[leveloffset=+1]
+
+//Using cookies to keep route statefulness
+include::modules/nw-using-cookies-keep-route-statefulness.adoc[leveloffset=+1]
+
+//Annotating a route with a cookie name
+include::modules/nw-annotating-a-route-with-a-cookie-name.adoc[leveloffset=+2]
+
+//Additional annotations (to be separated into modules with more detail at a later date)
+include::modules/nw-route-specific-annotations.adoc[leveloffset=+1]
diff --git a/networking/ingress_load_balancing/routes/securing-routes.adoc b/networking/ingress_load_balancing/routes/securing-routes.adoc
@@ -0,0 +1,21 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="securing-routes"]
+= Securing routes
+:context: configuring-routes
+
+[toc]
+
+You can secure a route with HTTP strict transport security (HSTS).
+
+//HTTP Strict Transport Security
+include::modules/nw-enabling-hsts.adoc[leveloffset=+1]
+
+//Enabling HTTP strict transport security per-route
+include::modules/nw-enabling-hsts-per-route.adoc[leveloffset=+2]
+
+//Disabling HTTP strict transport security per-route
+include::modules/nw-disabling-hsts.adoc[leveloffset=+2]
+
+//Enforcing HTTP strict transport security per-domain
+include::modules/nw-enforcing-hsts-per-domain.adoc[leveloffset=+2]
diff --git a/security/cert_manager_operator/cert-manager-securing-routes.adoc b/security/cert_manager_operator/cert-manager-securing-routes.adoc
@@ -6,14 +6,14 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-In the {product-title}, the route API is extended to provide a configurable option to reference TLS certificates via secrets. With xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[externally managed certificates] enabled, you can minimize errors from manual intervention, streamline the certificate management process, and enable the {product-title} router to promptly serve the referenced certificate.
+In the {product-title}, the route API is extended to provide a configurable option to reference TLS certificates via secrets. With xref:../../networking/ingress_load_balancing/routes/creating-advanced-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[externally managed certificates] enabled, you can minimize errors from manual intervention, streamline the certificate management process, and enable the {product-title} router to promptly serve the referenced certificate.
 
 include::modules/cert-manager-configuring-routes.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[Creating a route with externally managed certificate]
+* xref:../../networking/ingress_load_balancing/routes/nw-configuring-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[Creating a route with externally managed certificate]
 
 * xref:../../security/cert_manager_operator/cert-manager-operator-issuer-acme.adoc#cert-manager-operator-issuer-acme[Configuring an ACME issuer]
diff --git a/security/certificates/service-serving-certificate.adoc b/security/certificates/service-serving-certificate.adoc
@@ -12,7 +12,7 @@ include::modules/customize-certificates-add-service-serving.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* You can use a service certificate to configure a secure route using reencrypt TLS termination. For more information, see xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate_secured-routes[Creating a re-encrypt route with a custom certificate].
+* You can use a service certificate to configure a secure route using reencrypt TLS termination. For more information, see xref:../../networking/ingress_load_balancing/routes/creating-advanced-routes.adoc#nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate_secured-routes[Creating a re-encrypt route with a custom certificate].
 
 include::modules/customize-certificates-add-service-serving-configmap.adoc[leveloffset=+1]
 
diff --git a/service_mesh/v2x/ossm-route-migration.adoc b/service_mesh/v2x/ossm-route-migration.adoc
@@ -14,5 +14,5 @@ include::modules/ossm-migrating-from-ior-to-explicitly-managed-routes.adoc[level
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-creating-a-route_route-configuration[Creating an HTTP-based Route]
+* xref:../../networking/ingress_load_balancing/routes/creating-basic-routes.adoc#nw-creating-a-route_route-configuration[Creating an HTTP-based Route]
 * xref:../../service_mesh/v2x/ossm-traffic-manage.adoc#ossm-auto-route_traffic-management[Understanding automatic routes]
diff --git a/service_mesh/v2x/ossm-traffic-manage.adoc b/service_mesh/v2x/ossm-traffic-manage.adoc
@@ -57,7 +57,7 @@ include::modules/ossm-auto-route-annotations.adoc[leveloffset=+2]
 
 ifdef::openshift-enterprise[]
 .Additional resources
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations].
+* xref:../../networking/ingress_load_balancing/routes/nw-configuring-routes.adoc#nw-route-specific-annotations[Route-specific annotations].
 endif::[]
 
 include::modules/ossm-auto-route-enable.adoc[leveloffset=+2]
