From 86f9e27c64f40653d154eadf790746c5467d3a03 Mon Sep 17 00:00:00 2001 From: Michal Vala Date: Mon, 23 Sep 2019 13:43:20 +0200 Subject: [PATCH 1/3] installation guide - namespace per user strategy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Michal Vala Co-Authored-By: Robert Krátký --- ...proc_configuring-namespace-strategies.adoc | 34 +++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc index 78f4b5655a..11caa04540 100644 --- a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc +++ b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc @@ -1,27 +1,27 @@ [id="configuring-namespace-strategies_{context}"] = Configuring namespace strategies -This paragraph is the procedure module introduction: a short description of the procedure. +NOTE: The term _namespace_ (Kubernetes) is used interchangeably with _project_ (OpenShift). -[discrete] -== Prerequisites +=== One Namespace per User strategy -* A bulleted list of conditions that must be satisfied before the user starts following this assembly. -* You can also link to other modules or assemblies the user must follow before starting this assembly. -* Delete the section title and bullets if the assembly has no prerequisites. +The strategy isolates each user in their own namespace. -[discrete] -== Procedure +To use the strategy, set the `CHE_INFRA_KUBERNETES_NAMESPACE` variable on Kubernetes or the `CHE_INFRA_OPENSHIFT_PROJECT` variable on OpenShift. The value must contain one or more user identifiers. Currently supported identifiers are `__` and `__`. -. Start each step with an active verb. +.Example +To assign namespace names composed of a `che-ws` prefix and individual usernames (`che-ws-user1`, `che-ws-user2`), set: -. Include one command or action per step. +[subs="+quotes"] +---- +CHE_INFRA_KUBERNETES_NAMESPACE=che-ws-____ +---- -. Use an unnumbered bullet (*) if the procedure includes only one step. +[IMPORTANT] +==== +Using the _One Namespace per User_ strategy with the `common` PVC strategy only works correctly when the user runs not more than one workspace at a time. To enforce this limit, set: -[discrete] -== Additional resources - -* A bulleted list of links to other material closely related to the contents of the procedure module. -* For more details on writing procedure modules, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]. -* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]. +---- +CHE_LIMITS_USER_WORKSPACES_RUN_COUNT=1 +---- +==== From 45429c10914ac4ab20721fbf5cdb0210c579e8c3 Mon Sep 17 00:00:00 2001 From: Michal Vala Date: Mon, 30 Sep 2019 09:31:05 +0200 Subject: [PATCH 2/3] namespace strategies page metadata Signed-off-by: Michal Vala --- .../proc_configuring-namespace-strategies.adoc | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc index 11caa04540..49b60d978f 100644 --- a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc +++ b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc @@ -1,4 +1,16 @@ -[id="configuring-namespace-strategies_{context}"] +--- +title: Configuring namespace strategies +keywords: +tags: [] +sidebar: che_7_docs +permalink: che-7/configuring-namespace-strategies/ +folder: che-7/installation-guide +summary: +--- + +:parent-configuring-namespace-strategies: {context} + +[id="configuring-namespace-strategies"] = Configuring namespace strategies NOTE: The term _namespace_ (Kubernetes) is used interchangeably with _project_ (OpenShift). From 176dc0c9e0b18e53d0d9c379f17a793455010931 Mon Sep 17 00:00:00 2001 From: Michal Vala Date: Mon, 30 Sep 2019 14:31:45 +0200 Subject: [PATCH 3/3] document One namespace per workspace and One namespace for all workspaces strategies Signed-off-by: Michal Vala --- ...proc_configuring-namespace-strategies.adoc | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc index 49b60d978f..c69bce1b6f 100644 --- a/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc +++ b/src/main/pages/che-7/installation-guide/proc_configuring-namespace-strategies.adoc @@ -15,6 +15,30 @@ summary: NOTE: The term _namespace_ (Kubernetes) is used interchangeably with _project_ (OpenShift). +=== One Namespace per Workspace strategy + +The strategy creates new namespace for each new workspace. Name of new namespace is workspace's id. + +To use the strategy, unset or leave empty `CHE_INFRA_KUBERNETES_NAMESPACE` variable on Kubernetes or `CHE_INFRA_OPENSHIFT_PROJECT` variable on Openshift. +[subs="+quotes"] +---- +CHE_INFRA_KUBERNETES_NAMESPACE= +---- + +=== One Namespace for all Workspaces strategy + +The strategy uses one predefined namespace for all workspaces. + +To use the strategy, set the `CHE_INFRA_KUBERNETES_NAMESPACE` variable on Kubernetes or the `CHE_INFRA_OPENSHIFT_PROJECT` variable on Openshift. The value must be name of desired namespace that you want to use. + +.Example +To have all workspaces created in `che-workspaces` namespace, set: +[subs="+quotes"] +---- +CHE_INFRA_KUBERNETES_NAMESPACE=che-workspaces +---- + + === One Namespace per User strategy The strategy isolates each user in their own namespace.