docs: add how to configure annotations

modules/installation-guide/nav.adoc

@@ -39,8 +39,8 @@
 ** xref:configuring-workspace-exposure-strategies.adoc[]
 ** xref:configuring-workspaces-nodeselector.adoc[]
 ** xref:configuring-che-hostname.adoc[]
-** xref:configuring-labels-for-ingresses.adoc[]
-** xref:configuring-labels-and-domains-for-routes.adoc[]
+** xref:configuring-ingresses.adoc[]
+** xref:configuring-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-ingresses.adoc

@@ -0,0 +1,6 @@
+[id="configuring-ingresses"]
+:navtitle: Configuring {orch-ingress}
+:keywords: installation-guide, configuring-ingresses
+:page-aliases: .:configuring-ingresses
+
+include::partial$proc_configuring-ingresses.adoc[]

modules/installation-guide/pages/configuring-routes.adoc

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

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

@@ -16,15 +16,15 @@ The next sections describe some specific user stories.
 
 * xref:configuring-namespace-strategies.adoc[]
 
-* xref:configuring-the-number-of-workspaces-a-user-can-run.adoc[] 
+* xref:configuring-the-number-of-workspaces-a-user-can-run.adoc[]
 
 * xref:configuring-workspaces-nodeselector.adoc[]
 
 * xref:configuring-che-hostname.adoc[]
 
-* xref:configuring-labels-for-ingresses.adoc[]
+* xref:configuring-ingresses.adoc[]
 
-* xref:configuring-labels-and-domains-for-routes.adoc[]
+* xref:configuring-routes.adoc[]
 
 * xref:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[]
 

modules/installation-guide/partials/proc_configuring-ingresses.adoc

@@ -0,0 +1,73 @@
+
+[id="configuring-ingresses_{context}"]
+= Configuring {orch-ingress}
+
+* This procedure describes how to configure labels and annotations for {orch-ingress} to organize and categorize objects by scoping and selecting.
+
+.Prerequisites
+
+* The `{orch-cli}` tool is available.
+* An instance of {prod-short} running in {orch-name}.
+
+.Procedure
+
+. To configure labels for {orch-ingress}, update the Custom Resource:
++
+IMPORTANT: Use comma to separate labels: `key1=value1,key2=value2`
++
+[subs="+quotes,+attributes"]
+----
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/cheServerIngress/labels", '\
+'"value": "__<labels for a {prod-id-short} server ingress>__"}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/auth/identityProviderIngress/labels", '\
+'"value": "__<labels for a {identity-provider} ingress>__"}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/pluginRegistryIngress/labels", '\
+'"value": "__<labels for a plug-ins registry ingress>__"}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/devfileRegistryIngress/labels",'\
+'"value": "__<labels for a devfile registry ingress>__"}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/dashboardIngress/labels",'\
+'"value": "__<labels for a dashboard ingress>__"}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/customCheProperties/CHE_INFRA_KUBERNETES_INGRESS_LABELS", '\
+'"value": "__<labels for a workspace ingress>__"}]'
+----
+. To configure annotations for {orch-ingress}, update the Custom Resource with the following commands:
++
+IMPORTANT: Use object to specify annotations: `{"key1": "value1", "key2" : "value2"}`
++
+[subs="+quotes,+attributes"]
+----
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/cheServerIngress/annotations", '\
+'"value": __<annotations for a {prod-id-short} server ingress>__}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/auth/identityProviderIngress/annotations", '\
+'"value": __<annotations for a {identity-provider} ingress>__}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/pluginRegistryIngress/annotations", '\
+'"value": __<annotations for a plug-ins registry ingress>__}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/devfileRegistryIngress/annotations",'\
+'"value": __<annotations for a devfile registry ingress>__}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/dashboardIngress/annotations",'\
+'"value": __<annotations for a dashboard ingress>__}]'
+
+$ {orch-cli} patch checluster/{prod-checluster} -n {prod-namespace} --type=json -p \
+'[{"op": "replace", "path": "/spec/server/customCheProperties/CHE_INFRA_KUBERNETES_INGRESS_ANNOTATIONS______JSON", '\
+'"value": "__<annotations for a workspace ingress in json format>__"}]'
+----