Merge pull request #52393 from xenolinux/route

BZ1957067: Explain the route domain configuration

Author: jeana-redhat

modules/nw-creating-a-route.adoc

@@ -73,8 +73,8 @@ spec:
     kind: Service
     name: hello-openshift
 ----
-<1> `<Ingress_Domain>` is the default ingress domain name.
-<2> `targetPort` is the target port on pods that is selected by the service that this route points to.  
+<1> `<Ingress_Domain>` is the default ingress domain name. The `ingresses.config/cluster` object is created during the installation and cannot be changed. If you want to specify a different domain, you can specify an alternative cluster domain using the `appsDomain` option.
+<2> `targetPort` is the target port on pods that is selected by the service that this route points to.
 
 +
 [NOTE]

modules/nw-ingress-configuring-application-domain.adoc

@@ -43,7 +43,7 @@ spec:
   domain: apps.example.com            <1>
   appsDomain: <test.example.com>      <2>
 ----
-<1> Default domain
+<1> Specifies the default domain. You cannot modify the default domain after installation.
 <2> Optional: Domain for {product-title} infrastructure to use for application routes. Instead of the default prefix, `apps`, you can use an alternative prefix like `test`.
 +
 . Verify that an existing route contains the domain name specified in the `appsDomain` field by exposing the route and verifying the route domain change:

networking/routes/route-configuration.adoc

@@ -42,7 +42,7 @@ include::modules/nw-throughput-troubleshoot.adoc[leveloffset=+1]
 * xref:../../nodes/edge/nodes-edge-remote-workers.adoc#nodes-edge-remote-workers-latency[Latency spikes or temporary reduction in throughput to remote workers]
 
 
-* xref:../../networking/ingress-operator.adoc#nw-ingress-controller-configuration-parameters_configuring-ingress[Ingress Controller configuration 
+* xref:../../networking/ingress-operator.adoc#nw-ingress-controller-configuration-parameters_configuring-ingress[Ingress Controller configuration
 parameters]
 endif::[]
 
@@ -66,3 +66,8 @@ include::modules/nw-ingress-edge-route-default-certificate.adoc[leveloffset=+1]
 include::modules/nw-ingress-reencrypt-route-custom-cert.adoc[leveloffset=+1]
 
 include::modules/nw-router-configuring-dual-stack.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../networking/ingress-operator.adoc#configuring-ingress[Specifying an alternative cluster domain using the appsDomain option]