procedures: Configuring workspace target namespace, Provisioning namespaces

antora.yml

@@ -80,6 +80,7 @@ asciidoc:
     prod-operator-image-name: che-operator
     prod-operator: che-operator
     prod-prev-ver: "previous minor version"
+    prod-service-account: che
     prod-short: Che
     prod-stable-channel: stable
     prod-stable-channel-catalog-source: community-operators

modules/administration-guide/nav.adoc

@@ -37,7 +37,8 @@
 ** xref:configuring-workspaces-globally.adoc[]
 *** xref:configuring-the-number-of-workspaces-that-a-user-can-create.adoc[]
 *** xref:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[]
-*** xref:configuring-namespace-strategies.adoc[]
+*** xref:configuring-workspace-target-namespace.adoc[]
+*** xref:provisioning-namespaces.adoc[]
 *** xref:configuring-workspaces-nodeselector.adoc[]
 ** xref:caching-images-for-faster-workspace-start.adoc[]
 *** xref:defining-the-list-of-images-to-pull.adoc[]

modules/administration-guide/pages/configuring-che.adoc

@@ -6,29 +6,5 @@
 [id="configuring-che_{context}"]
 = Configuring {prod-short}
 
-The following chapter describes configuration methods and options for {prod}.
-
-* xref:advanced-configuration-options-for-the-che-server-component.adoc[] describes advanced configuration methods to use when the previous method is not applicable.
-
-Specific use-cases:
-
-* xref:configuring-namespace-strategies.adoc[]
-
-* xref:configuring-the-number-of-workspaces-that-a-user-can-create.adoc[]
-
-* xref:configuring-workspaces-nodeselector.adoc[]
-
-* xref:configuring-che-hostname.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[]
-
-* xref:mounting-a-secret-as-a-file-or-an-environment-variable-into-a-container.adoc[]
+This section describes configuration methods and options for {prod}.
 

modules/administration-guide/pages/configuring-workspace-target-namespace.adoc

@@ -0,0 +1,58 @@
+:_content-type: CONCEPT
+:navtitle: Configuring workspace target {orch-namespace}
+:keywords: administration guide, configuring, namespace
+:page-aliases: installation-guide:configuring-namespace-strategies, configuring-namespace-strategies
+
+[id="configuring-workspace-target-namespace_{context}"]
+= Configuring workspace target {orch-namespace}
+
+For each user, {prod-short} isolates the workspaces in a {orch-namespace}.
+You can configure the {orch-namespace} name template.
+
+{prod-short} server checks usernames and IDs for compatibility with {orch-name} objects naming convention before creating a {orch-namespace} from a template:
+
+* The `<username>` or `<userid>` placeholder is mandatory.
+* Incompatible usernames or IDs are reduced to the nearest valid name by replacing groups of unsuitable symbols with the `-` symbol. 
+* The `<userid>` placeholder is evaluated into a 14 character long string.
+* When using `<userid>`, the addition of a random 6-symbol suffix prevents IDs from collisions. The result is stored in preferences for reuse.
+* {kubernetes} limits the length of a {orch-namespace} name to 63 characters (this includes the evaluated placeholders). Additionally, the names (after placeholder evaluation) must be valid DNS names.
+* OpenShift limits the length further to 49 characters.
+
+.User workspaces {orch-namespace} name template examples
+====
+[%header,cols="1,1"]  
+|=== 
+|User workspaces {orch-namespace} name template
+|Resulting {orch-namespace} example
+
+|`<username>-{prod-id-short}` (default)
+|user1-{prod-id-short}
+
+|`<userid>-namespace` 
+|`cge1egvsb2nhba-namespace-ul1411` 
+
+|`<userid>-aka-<username>-namespace`
+|`cgezegvsb2nhba-aka-user1-namespace-6m2w2b`
+|=== 
+====
+
+
+.Procedure
+
+* Set the `server.workspaceNamespaceDefault` property in CheCluster Custom Resource:
++
+[source,yaml,subs="+quotes,+attributes"]
+----
+kind: CheCluster
+apiVersion: org.eclipse.che/v1
+# ...
+spec:
+  server:
+    workspaceNamespaceDefault: __<workspaceNamespaceDefault_value>__
+# ...
+----
+
+.Additional resources
+
+* xref:understanding-the-checluster-custom-resource.adoc[]
+

modules/administration-guide/pages/configuring-workspaces-globally.adoc

@@ -6,7 +6,14 @@
 [id="configuring-workspaces-globally_{context}"]
 = Configuring workspaces globally
 
+This section describes how an administrator can configure workspaces globally.
+
 * xref:configuring-the-number-of-workspaces-that-a-user-can-create.adoc[]
+
 * xref:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[]
-* xref:configuring-namespace-strategies.adoc[]
+
+* xref:configuring-workspace-target-namespace.adoc[]
+
+* xref:provisioning-namespaces.adoc[]
+
 * xref:configuring-workspaces-nodeselector.adoc[]