From 574445cd6f5cbd2922a2b76767c760b6a2430055 Mon Sep 17 00:00:00 2001 From: Anatolii Bazko Date: Wed, 25 Mar 2026 09:53:25 +0100 Subject: [PATCH 1/2] docs: add article for configuring direct namespace creation on OpenShift Document the new `createNamespaceDirectly` CheCluster CR option that allows creating standard Kubernetes namespaces instead of using the OpenShift ProjectRequest API. Related: eclipse-che/che-operator#2104 Co-Authored-By: Claude Opus 4.6 --- ...irect-namespace-creation-on-openshift.adoc | 39 +++++++++++++++++++ .../configuring-namespace-provisioning.adoc | 3 +- 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc diff --git a/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc b/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc new file mode 100644 index 0000000000..7ee94728ec --- /dev/null +++ b/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc @@ -0,0 +1,39 @@ +:_content-type: PROCEDURE +:description: Configuring {prod-short} to create standard {orch-namespace}s instead of OpenShift projects +:keywords: administration guide, configuring, namespace, openshift, project +:navtitle: Configuring direct {orch-namespace} creation on OpenShift +:page-aliases: + +[id="configuring-direct-namespace-creation-on-openshift"] += Configuring direct {orch-namespace} creation on OpenShift + +By default, on {ocp} clusters, {prod-short} uses the OpenShift ProjectRequest API to create user {orch-namespace}s. +The ProjectRequest API triggers any cluster-specific Project Templates configured by the cluster administrator. + +If you want {prod-short} to create standard {kubernetes} {orch-namespace}s directly, bypassing the ProjectRequest API and its associated Project Templates, you can enable the `createNamespaceDirectly` option. + +.Prerequisites + +* An active `{prod-cli}` session with administrative permissions to the destination {ocp} cluster. See xref:installing-the-chectl-management-tool.adoc[]. + +.Procedure + +* Configure the `CheCluster` Custom Resource. See xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]. ++ +[source,yaml,subs="+quotes,+attributes"] +---- +spec: + devEnvironments: + defaultNamespace: + createNamespaceDirectly: true +---- + +.Verification + +* Start a workspace and verify that {prod-short} creates a standard {kubernetes} {orch-namespace} instead of an OpenShift project. + +.Additional resources + +* xref:configuring-namespace-provisioning.adoc[] + +* xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[] diff --git a/modules/administration-guide/pages/configuring-namespace-provisioning.adoc b/modules/administration-guide/pages/configuring-namespace-provisioning.adoc index 0502e2f333..395587a338 100644 --- a/modules/administration-guide/pages/configuring-namespace-provisioning.adoc +++ b/modules/administration-guide/pages/configuring-namespace-provisioning.adoc @@ -15,4 +15,5 @@ You can modify {prod-short} behavior by: * xref:configuring-workspace-target-namespace.adoc[] * xref:provisioning-namespaces-in-advance.adoc[] -* xref:configuring-a-user-namespace.adoc[] \ No newline at end of file +* xref:configuring-a-user-namespace.adoc[] +* xref:configuring-direct-namespace-creation-on-openshift.adoc[] \ No newline at end of file From 6b433f9a6d11e5c79fb075423dd2e162e48def02 Mon Sep 17 00:00:00 2001 From: Anatolii Bazko Date: Wed, 25 Mar 2026 10:03:11 +0100 Subject: [PATCH 2/2] docs: add article for configuring direct namespace creation on OpenShift Add a procedure article documenting the new `createNamespaceDirectly` CheCluster CR option that allows administrators to configure Che to create standard Kubernetes Namespaces instead of using the OpenShift ProjectRequest API. Source: https://github.com/eclipse-che/che-operator/pull/2104 Co-Authored-By: Claude Opus 4.6 --- modules/administration-guide/nav.adoc | 1 + ...onfiguring-direct-namespace-creation-on-openshift.adoc | 8 ++++---- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/modules/administration-guide/nav.adoc b/modules/administration-guide/nav.adoc index 6b19ae5c1f..e8c2df46fe 100644 --- a/modules/administration-guide/nav.adoc +++ b/modules/administration-guide/nav.adoc @@ -41,6 +41,7 @@ *** xref:configuring-workspace-target-namespace.adoc[] *** xref:provisioning-namespaces-in-advance.adoc[] *** xref:configuring-a-user-namespace.adoc[] +*** xref:configuring-direct-namespace-creation-on-openshift.adoc[] ** xref:configuring-server-components.adoc[] *** xref:mounting-a-secret-as-a-file-or-an-environment-variable-into-a-container.adoc[] *** xref:advanced-configuration-options-for-the-che-server-component.adoc[] diff --git a/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc b/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc index 7ee94728ec..ca885b065f 100644 --- a/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc +++ b/modules/administration-guide/pages/configuring-direct-namespace-creation-on-openshift.adoc @@ -1,11 +1,11 @@ :_content-type: PROCEDURE -:description: Configuring {prod-short} to create standard {orch-namespace}s instead of OpenShift projects +:description: Configuring {prod-short} to create standard {orch-namespace}s instead of {ocp} projects :keywords: administration guide, configuring, namespace, openshift, project -:navtitle: Configuring direct {orch-namespace} creation on OpenShift +:navtitle: Configuring direct {orch-namespace} creation on {ocp} :page-aliases: [id="configuring-direct-namespace-creation-on-openshift"] -= Configuring direct {orch-namespace} creation on OpenShift += Configuring direct {orch-namespace} creation on {ocp} By default, on {ocp} clusters, {prod-short} uses the OpenShift ProjectRequest API to create user {orch-namespace}s. The ProjectRequest API triggers any cluster-specific Project Templates configured by the cluster administrator. @@ -30,7 +30,7 @@ spec: .Verification -* Start a workspace and verify that {prod-short} creates a standard {kubernetes} {orch-namespace} instead of an OpenShift project. +* Start a workspace and verify that {prod-short} creates a standard {kubernetes} {orch-namespace} instead of an {ocp} project. .Additional resources