Configure labels and domains to work with router sharding

modules/administration-guide/partials/proc_configuring-openshift-oauth-without-initial-user.adoc

@@ -9,14 +9,7 @@ The following procedure describes how to configure OpenShift OAuth without provi
 
 .Procedure
 
-. Deploy and update {prod-short} instance using OperatorHub and wait for the process to finish:
-+
-[subs="+quotes,+attributes"]
-----
-$ {prod-cli} server:deploy --che-operator-cr-patch-yaml=patch.yaml ...
-----
-+
-`patch.yaml` must contain the following:
+. When OperatorHub is used to deploy {prod-short} then set the following values in {prod-checluster} Custom Resource (CR):
 +
 [source,yaml,subs="+quotes"]
 ----
@@ -26,7 +19,14 @@ spec:
     initialOpenShiftOAuthUser: ''
 ----
 +
-. Set the following values in {prod-checluster} Custom Resource (CR):
+. When `{prod-cli}` tool is used to deploy {prod-short} then use `--che-operator-cr-patch-yaml` flag:
++
+[subs="+quotes,+attributes"]
+----
+$ {prod-cli} server:deploy --che-operator-cr-patch-yaml=patch.yaml ...
+----
++
+`patch.yaml` must contain the following:
 +
 [source,yaml,subs="+quotes"]
 ----

modules/installation-guide/nav.adoc

@@ -40,7 +40,7 @@
 ** xref:configuring-workspaces-nodeselector.adoc[]
 ** xref:configuring-che-hostname.adoc[]
 ** xref:configuring-labels-for-ingresses.adoc[]
-** xref:configuring-labels-for-routes.adoc[]
+** xref:configuring-labels-and-domains-for-routes.adoc[]
 ** xref:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[]
 ** xref:installing-che-using-storage-classes.adoc[]
 ** xref:importing-untrusted-tls-certificates.adoc[]

modules/installation-guide/pages/configuring-labels-and-domains-for-routes.adoc

@@ -0,0 +1,7 @@
+[id="configuring-labels-and-domains-for-routes"]
+// = Configuring Labels
+:navtitle: Configuring labels and domains for OpenShift Route
+:keywords: installation-guide, configuring-labels, configuring-domains
+:page-aliases: .:configuring-labels-and-domains-for-routes
+
+include::partial$proc_configuring-labels-and-domains-for-routes.adoc[]

modules/installation-guide/partials/assembly_advanced-configuration.adoc

@@ -24,7 +24,7 @@ The next sections describe some specific user stories.
 
 * xref:configuring-labels-for-ingresses.adoc[]
 
-* xref:configuring-labels-for-routes.adoc[]
+* xref:configuring-labels-and-domains-for-routes.adoc[]
 
 * xref:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[]
 

modules/installation-guide/partials/proc_configuring-labels-and-domains-for-routes.adoc

@@ -0,0 +1,137 @@
+
+[id="configuring-labels-for-routes_{context}"]
+= Configuring labels and domains for OpenShift Route to work with Router Sharding
+
+This procedure describes how to configure labels and domains for OpenShift Route to work with link:https://docs.openshift.com/container-platform/4.7/networking/ingress-operator.html#nw-ingress-sharding_configuring-ingress[Router Sharding].
+
+.Prerequisites
+
+* The `oc` tool is available.
+
+.Procedure
+
+. When OperatorHub is used to deploy {prod-short} then set the following values in {prod-checluster} Custom Resource (CR):
++
+[source,yaml,subs="+quotes"]
+----
+spec:
+  server:
+    devfileRegistryRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    pluginRegistryRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    cheServerRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    customCheProperties:
+      CHE_INFRA_OPENSHIFT_ROUTE_LABELS: <labels> <1>
+      CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX: <domain> <2>
+  auth:
+    identityProviderRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+----
+<1> comma separated list of labels that are used by the target ingress controller to filter the set of Routes to service
+<2> DNS name serviced by the target ingress controller
+
++
+. When `{prod-cli}` tool is used to deploy {prod-short} then use `--che-operator-cr-patch-yaml` flag:
++
+[subs="+quotes,+attributes"]
+----
+$ {prod-cli} server:deploy --che-operator-cr-patch-yaml=patch.yaml ...
+----
++
+`patch.yaml` must contain the following:
++
+[source,yaml,subs="+quotes"]
+----
+spec:
+  server:
+    devfileRegistryRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    pluginRegistryRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    cheServerRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+    customCheProperties:
+      CHE_INFRA_OPENSHIFT_ROUTE_LABELS: <labels> <1>
+      CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX: <domain> <2>
+  auth:
+    identityProviderRoute:
+      labels: <labels> <1>
+      domain: <domain> <2>
+----
+<1> comma separated list of labels that are used by the target ingress controller to filter the set of Routes to service
+<2> DNS name serviced by the target ingress controller
+
++
+. When {prod-short} is already deployed in the OpenShift cluster then use the following commands:
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/cheServerRoute/labels",'\
+'"value": "__<labels for a {prod-id-short} server route>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/cheServerRoute/domain",'\
+'"value": "__<ingress domain>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/pluginRegistryRoute/labels", '\
+'"value": "__<labels for a plugin registry route>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/auth/identityProviderRoute/domain", '\
+'"value": "__<ingress domain>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/pluginRegistryRoute/domain", '\
+'"value": "__<ingress domain>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/devfileRegistryRoute/labels", '\
+'"value": "__<labels for a devfile registry route>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/devfileRegistryRoute/domain", '\
+'"value": "__<ingress domain>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/customCheProperties/CHE_INFRA_OPENSHIFT_ROUTE_LABELS", '\
+'"value": "__<labels for a workspace routes>__"}]'
+----
++
+[subs="+quotes,+attributes"]
+----
+$ oc patch checluster {prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/customCheProperties/CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN______SUFFIX", '\
+'"value": "__<ingress domain>__"}]'
+----