diff --git a/modules/administration-guide/nav.adoc b/modules/administration-guide/nav.adoc index 1efb5e5a30..89fb91f059 100644 --- a/modules/administration-guide/nav.adoc +++ b/modules/administration-guide/nav.adoc @@ -75,6 +75,7 @@ *** xref:configuring-che-with-self-signed-certificate.adoc[] *** xref:importing-untrusted-tls-certificates.adoc[] *** xref:adding-labels-and-annotations.adoc[] +*** xref:configuring-workspaces-endpoints-base-domain.adoc[] ** xref:configuring-storage.adoc[] *** xref:configuring-storage-classes.adoc[] *** xref:configuring-the-storage-strategy.adoc[] diff --git a/modules/administration-guide/pages/configuring-networking.adoc b/modules/administration-guide/pages/configuring-networking.adoc index 498be817a6..a4f8011a01 100644 --- a/modules/administration-guide/pages/configuring-networking.adoc +++ b/modules/administration-guide/pages/configuring-networking.adoc @@ -12,3 +12,4 @@ include::example$snip_{project-context}-xref-configuring-che-with-self-signed-certificate.adoc[] * xref:importing-untrusted-tls-certificates.adoc[] * xref:adding-labels-and-annotations.adoc[] +* xref:configuring-workspaces-endpoints-base-domain.adoc[] \ No newline at end of file diff --git a/modules/administration-guide/pages/configuring-workspaces-endpoints-base-domain.adoc b/modules/administration-guide/pages/configuring-workspaces-endpoints-base-domain.adoc new file mode 100644 index 0000000000..b5302164ec --- /dev/null +++ b/modules/administration-guide/pages/configuring-workspaces-endpoints-base-domain.adoc @@ -0,0 +1,41 @@ +:_content-type: PROCEDURE +:description: Configuring workspace endpoints base domain +:keywords: administration guide, workspaces, networking, endpoints, domain +:navtitle: Configuring workspace endpoints base domain +:page-aliases: + +[id="configuring-workspaces-endpoints-base-domain"] += Configuring workspace endpoints base domain + +Learn how to configure the base domain for workspace endpoints. +By default, {prod-short} Operator automatically detects the base domain. To change it, you need to configure the `CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX` property in the `CheCluster` Custom Resource. +[source,yaml,subs="+quotes"] +---- +spec: + components: + cheServer: + extraProperties: + CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX: "<...>" <1> + +---- +<1> Workspace endpoints base domain, for example, `my-{prod-id-short}.example.com`. + +.Procedure + +. Configure the workspace endpoints base domain: ++ +[source,subs="+quotes,attributes"] +---- +{orch-cli} patch checluster/{prod-checluster} \ + --namespace {prod-namespace} \ + --type='merge' -p \ +'{"spec": + {"components": + {"cheServer": + {"extraProperties": + {"CHE_INFRA_OPENSHIFT_ROUTE_HOST_DOMAIN__SUFFIX": "my-{prod-id-short}.example.com"}}}}}' +---- + +.Additional resources + +* xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[] diff --git a/modules/administration-guide/pages/configuring-workspaces-globally.adoc b/modules/administration-guide/pages/configuring-workspaces-globally.adoc index 738a7d93c8..761622373c 100644 --- a/modules/administration-guide/pages/configuring-workspaces-globally.adoc +++ b/modules/administration-guide/pages/configuring-workspaces-globally.adoc @@ -19,4 +19,4 @@ This section describes how an administrator can configure workspaces globally. * xref:configuring-workspaces-nodeselector.adoc[] -* xref:configuring-allowed-urls-for-cloud-development-environments.adoc[] \ No newline at end of file +* xref:configuring-allowed-urls-for-cloud-development-environments.adoc[]