| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| <title>CheCluster Custom Resource fields reference :: Eclipse Che Documentation</title> |
| <link rel="canonical" href="https://www.eclipse.org/che/docs/stable/administration-guide/checluster-custom-resource-fields-reference/"> |
| <meta name="description" content="`CheCluster` Custom Resource fields reference"> |
| <meta name="keywords" content="administration guide, checluster, custom resource"> |
| <meta name="generator" content="Antora 3.0.2"> |
| <link rel="stylesheet" href="../../../../docs/_/css/site.css"> |
| <link rel="stylesheet" href="../../../../docs/_/css/extra.css"> |
| <link rel="stylesheet" href="../../../../docs/_/font-awesome-4.7.0/css/font-awesome.min.css"> |
| <link rel="icon" href="../../../../docs/_/img/favicon.ico" type="image/x-icon"> |
| <script>var uiRootPath = '../../../../docs/_'</script> |
| <script async src="https://www.googletagmanager.com/gtag/js?id=UA-37306001-2"></script> |
| <script>function gtag(){dataLayer.push(arguments)};window.dataLayer=window.dataLayer||[];gtag('js',new Date());gtag('config','UA-37306001-2')</script> |
| <script>var uiRootPath = '../../../../docs/_'</script> |
| </head> |
| <body class="article"> |
| <header class="header"> |
| <nav class="navbar"> |
| <div class="navbar-brand"> |
| <div class="navbar-item"> |
| <button class="navbar-burger" data-target="topbar-nav"> |
| <span></span> |
| <span></span> |
| <span></span> |
| </button> |
| <img src="../../../../docs/_/img/icon-eclipse-che.svg" class="navbar-logo" alt="Eclipse Che logo"> |
| <a href="https://www.eclipse.org/che/docs/index.html">Eclipse Che Documentation</a> |
| </div> |
| </div> |
| <div id="topbar-nav" class="navbar-menu"> |
| <div class="navbar-end"> |
| <div class="navbar-item search hide-for-print"> |
| <div id="search-field" class="field"> |
| <input id="search-input" type="text" placeholder="Search the docs"> |
| </div> |
| </div> |
| <a class="navbar-item" href="https://www.eclipse.org/che/">Home</a> |
| <a class="navbar-item" href="https://che.eclipseprojects.io/">Blog</a> |
| <a class="navbar-item" href="https://github.com/eclipse/che">Source Code</a> |
| </div> |
| </div> |
| </nav> |
| </header> |
| <div class="body"> |
| <div class="nav-container" data-component="docs" data-version="stable"> |
| <aside class="nav"> |
| <div class="panels"> |
| <div class="nav-panel-menu is-active" data-panel="menu"> |
| <nav class="nav-menu"> |
| <h3 class="title"><a href="../../overview/introduction-to-eclipse-che/">Documentation</a></h3> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="0"> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../overview/introduction-to-eclipse-che/">Introduction to Che</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="0"> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../hosted-che/hosted-che/">Eclipse Che hosted by Red Hat</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../hosted-che/try-in-web-ide-github-action/">Try in Web IDE GitHub action</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="0"> |
| <button class="nav-item-toggle"></button> |
| <span class="nav-text">User Guide</span> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/adopting-che/">Adopting Che</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/developer-workspaces/">Developer workspaces</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/first-time-contributors/">Badge for first-time contributors</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/benefits-of-pull-requests-review-in-che/">Reviewing pull and merge requests</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/user-onboarding/">User onboarding</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/starting-a-new-workspace-with-a-clone-of-a-git-repository/">Starting a new workspace with a clone of a Git repository</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/optional-parameters-for-the-urls-for-starting-a-new-workspace/">Optional parameters for the URLs for starting a new workspace</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/basic-actions-you-can-perform-on-a-workspace/">Basic actions you can perform on a workspace</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/authenticating-yourself-to-a-git-server-from-a-workspace/">Authenticating yourself to a Git server from a workspace</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../end-user-guide/customizing-workspace-components/">Customizing workspace components</a> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../end-user-guide/selecting-an-ide/">Selecting an IDE</a> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/using-credentials-and-configurations-in-workspaces/">Using credentials and configurations in workspaces</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/using-a-git-credentials-store/">Using a Git credentials store</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/enabling-artifact-repositories-in-a-restricted-environment/">Enabling artifact repositories in a restricted environment</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-maven-artifact-repositories/">Maven</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-gradle-artifact-repositories/">Gradle</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-npm-artifact-repositories/">npm</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-python-artifact-repositories/">Python</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-go-artifact-repositories/">Go</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../end-user-guide/enabling-nuget-artifact-repositories/">NuGet</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/creating-image-pull-secrets/">Creating image pull Secrets</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/mounting-secrets/">Mounting Secrets</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/mounting-configmaps/">Mounting ConfigMaps</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../end-user-guide/requesting-persistent-storage-for-workspaces/">Requesting persistent storage for workspaces</a> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/integrating-with-kubernetes/">Integrating with Kubernetes</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/automatic-token-injection/">Automatic Kubernetes token injection</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/navigating-che-from-openshift-developer-perspective/">Navigating Che from OpenShift Developer Perspective</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/navigating-openshift-web-console-from-che/">Navigating OpenShift web console from Che</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../end-user-guide/troubleshooting-che/">Troubleshooting Che</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/viewing-che-workspaces-logs/">Viewing Che workspaces logs</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/investigating-failures-at-a-workspace-start-using-the-verbose-mode/">Troubleshooting workspace start failures</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/troubleshooting-slow-workspaces/">Troubleshooting slow workspaces</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../../end-user-guide/troubleshooting-network-problems/">Troubleshooting network problems</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../end-user-guide/adding-a-vscode-extension/">Adding a Visual Studio Code extension to a workspace</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="0"> |
| <button class="nav-item-toggle"></button> |
| <span class="nav-text">Administration Guide</span> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../preparing-the-installation/">Preparing the installation</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../supported-platforms/">Supported platforms</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../architecture-overview/">Architecture</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../server-components/">Server components</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../che-operator/">Che operator</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../devworkspace-operator/">Dev Workspace operator</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../gateway/">Gateway</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../dashboard/">User dashboard</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../devfile-registries/">Devfile registries</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../che-server/">Che server</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../postgresql/">PostgreSQL</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../plug-in-registry/">Plug-in registry</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../user-workspaces/">User workspaces</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../calculating-che-resource-requirements/">Calculating Che resource requirements</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../installing-che/">Installing Che</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../installing-the-chectl-management-tool/">Installing the chectl management tool</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../installing-che-on-openshift-using-cli/">Installing Che on OpenShift using CLI</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../installing-che-on-openshift-using-the-web-console/">Installing Che on OpenShift using the web console</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../installing-che-in-a-restricted-environment/">Installing Che in a restricted environment</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../installing-che-locally/">Installing Che locally</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../installing-che-on-red-hat-openshift-local/">Installing Che on Red Hat OpenShift Local</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../installing-che-on-minikube/">Installing Che on Minikube</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-che/">Configuring Che</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../understanding-the-checluster-custom-resource/">Understanding the <code>CheCluster</code> Custom Resource</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../using-chectl-to-configure-the-checluster-custom-resource-during-installation/">Using chectl to configure the <code>CheCluster</code> Custom Resource during installation</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../using-the-cli-to-configure-the-checluster-custom-resource/">Using the CLI to configure the CheCluster Custom Resource</a> |
| </li> |
| <li class="nav-item is-current-page" data-depth="3"> |
| <a class="nav-link" href="./"><code>CheCluster</code> Custom Resource fields reference</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-namespace-provisioning/">Configuring namespaces</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-workspace-target-namespace/">Configuring namespace name</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../provisioning-namespaces-in-advance/">Provisioning namespaces in advance</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-server-components/">Configuring server components</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../mounting-a-secret-as-a-file-or-an-environment-variable-into-a-container/">Mounting a Secret or a ConfigMap as a file or an environment variable into a Eclipse Che container</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../advanced-configuration-options-for-the-che-server-component/">Advanced configuration options for Che server</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-workspaces-globally/">Configuring workspaces globally</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-the-number-of-workspaces-that-a-user-can-create/">Configuring the number of workspaces that a user can create</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../deploying-che-with-support-for-git-repositories-with-self-signed-certificates/">Git with self-signed certificates</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-workspaces-nodeselector/">Configuring workspaces nodeSelector</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../caching-images-for-faster-workspace-start/">Caching images for faster workspace start</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../defining-the-list-of-images-to-pull/">Defining the list of images</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../defining-the-memory-parameters-for-the-image-puller/">Defining the memory settings</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../installing-image-puller-on-openshift-using-the-web-console/">Installing Image Puller on OpenShift using the web console</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../installing-image-puller-on-openshift-using-cli/">Installing Image Puller on OpenShift using CLI</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-observability/">Configuring observability</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../che-theia-workspaces/">Che-Theia workspaces</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../the-woopra-telemetry-plugin/">The Woopra telemetry plug-in</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../creating-a-telemetry-plugin/">Creating a telemetry plug-in</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-server-logging/">Configuring server logging</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../collecting-logs-using-chectl/">Collecting logs using chectl</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../monitoring-with-prometheus-and-grafana/">Monitoring with Prometheus and Grafana</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../installing-prometheus-and-grafana/">Installing Prometheus and Grafana</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../monitoring-the-dev-workspace-operator/">Monitoring the Dev Workspace Operator</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../monitoring-che/">Monitoring Che Server</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-networking/">Configuring networking</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-che-hostname/">Configuring Che hostname</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../importing-untrusted-tls-certificates/">Importing untrusted TLS certificates to Che</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-ingresses/">Configuring Kubernetes Ingress</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-routes/">Configuring OpenShift Route</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../configuring-storage/">Configuring storage</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../installing-che-using-storage-classes/">Installing Che using storage classes</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../branding/">Branding</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../branding-che-theia/">Branding Che-Theia</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../managing-identities-and-authorizations/">Managing identities and authorizations</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../oauth-for-github-gitlab-or-bitbucket/">OAuth for GitHub, GitLab, or Bitbucket</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../configuring-oauth-2-for-github/">Configuring OAuth 2.0 for GitHub</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../configuring-oauth-2-for-gitlab/">Configuring OAuth 2.0 for GitLab</a> |
| </li> |
| <li class="nav-item" data-depth="4"> |
| <a class="nav-link" href="../configuring-oauth-1-for-bitbucket/">Configuring OAuth 1.0 for Bitbucket</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../configuring-the-administrative-user/">Configuring the administrative user</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../removing-user-data/">Removing user data</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../managing-workloads-using-the-che-server-api/">Using the Che server API</a> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../upgrading-che/">Upgrading Che</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../upgrading-the-chectl-management-tool/">Upgrading the chectl management tool</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../upgrading-che-7-41-on-openshift/">Upgrading Che 7.41 on Red Hat OpenShift</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../specifying-the-update-approval-strategy/">Specifying the update approval strategy</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../upgrading-che-using-the-web-console/">Upgrading Che using the OpenShift web console</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../upgrading-che-using-the-cli-management-tool/">Upgrading Che using the CLI management tool</a> |
| </li> |
| <li class="nav-item" data-depth="2"> |
| <a class="nav-link" href="../upgrading-che-using-the-cli-management-tool-in-restricted-environment/">Upgrading Che in a restricted environment</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../uninstalling-che/">Uninstalling Che</a> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="0"> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../extensions/extensions/">Extensions</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="2"> |
| <button class="nav-item-toggle"></button> |
| <a class="nav-link" href="../../extensions/openshift-connector-overview/">OpenShift Connector</a> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../extensions/features-of-openshift-connector/">Features of OpenShift Connector</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../extensions/installing-openshift-connector-in-che/">Installing OpenShift Connector in Eclipse Che</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../extensions/authenticating-with-openshift-connector-from-che/">Authenticating with OpenShift Connector from Eclipse Che</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../extensions/creating-components-with-openshift-connector-in-che/">Creating Components with OpenShift Connector in Eclipse Che</a> |
| </li> |
| <li class="nav-item" data-depth="3"> |
| <a class="nav-link" href="../../extensions/connecting-source-code-from-github-to-a-openshift-component-using-openshift-connector/">Connecting source code from GitHub to a OpenShift Component</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="nav-item" data-depth="0"> |
| <ul class="nav-list"> |
| <li class="nav-item" data-depth="1"> |
| <a class="nav-link" href="../../glossary/che-glossary/">Che glossary</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </nav> |
| </div> |
| <div class="nav-panel-explore" data-panel="explore"> |
| <div class="context"> |
| <span class="title">Documentation</span> |
| <span class="version">stable</span> |
| </div> |
| <ul class="components"> |
| <li class="component is-current"> |
| <a class="title" href="../../overview/introduction-to-eclipse-che/">Documentation</a> |
| <ul class="versions"> |
| <li class="version"> |
| <a href="../../../next/overview/introduction-to-eclipse-che/">next</a> |
| </li> |
| <li class="version"> |
| <a href="../../../che-7/overview/introduction-to-eclipse-che/">old (7.41)</a> |
| </li> |
| <li class="version is-current is-latest"> |
| <a href="../../overview/introduction-to-eclipse-che/">stable</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| </div> |
| </aside> |
| </div> |
| <main class="article"> |
| <div class="toolbar" role="navigation"> |
| <button class="nav-toggle"></button> |
| <a href="../../overview/introduction-to-eclipse-che/" class="home-link"></a> |
| <nav class="breadcrumbs" aria-label="breadcrumbs"> |
| <ul> |
| <li><a href="../../overview/introduction-to-eclipse-che/">Documentation</a></li> |
| <li>Administration Guide</li> |
| <li><a href="../configuring-che/">Configuring Che</a></li> |
| <li><a href="../understanding-the-checluster-custom-resource/">Understanding the <code>CheCluster</code> Custom Resource</a></li> |
| <li><a href="./"><code>CheCluster</code> Custom Resource fields reference</a></li> |
| </ul> |
| </nav> |
| <div class="page-versions"> |
| <button class="version-menu-toggle" title="Show other versions of page">stable</button> |
| <div class="version-menu"> |
| <a class="version" href="../../../next/administration-guide/checluster-custom-resource-fields-reference/">next</a> |
| <a class="version is-missing" href="../../../che-7/overview/introduction-to-eclipse-che/">old (7.41)</a> |
| <a class="version is-current" href="./">stable</a> |
| </div> |
| </div> |
| <div class="edit-this-page"><a href="https://github.com/eclipse/che-docs/edit/7.50.x/modules/administration-guide/pages/checluster-custom-resource-fields-reference.adoc">Edit this Page</a></div> |
| </div> |
| <div class="content"> |
| <aside class="toc sidebar" data-title="Contents" data-levels="2"> |
| <div class="toc-menu"></div> |
| </aside> |
| <article class="doc"> |
| <h1 class="page"><code>CheCluster</code> Custom Resource fields reference</h1> |
| <div class="paragraph"> |
| <p>This section describes all fields available to customize the <code>CheCluster</code> Custom Resource.</p> |
| </div> |
| <div class="ulist"> |
| <ul> |
| <li> |
| <p><a href="#a-minimal-checluster-custom-resource-example_che">A minimal <code>CheCluster</code> Custom Resource example.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-server-settings_che"><code>CheCluster</code> Custom Resource <code>server</code> settings, related to the Che server component.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-database-settings_che"><code>CheCluster</code> Custom Resource <code>database</code> configuration settings related to the database used by Che.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-auth-settings_che">Custom Resource <code>auth</code> configuration settings related to authentication used by Che.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-storage-settings_che"><code>CheCluster</code> Custom Resource <code>storage</code> configuration settings related to persistent storage used by Che.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-k8s-settings_che"><code>CheCluster</code> Custom Resource <code>k8s</code> configuration settings specific to Che installations on Kubernetes or OpenShift.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-metrics-settings_che"><code>CheCluster</code> Custom Resource <code>metrics</code> settings, related to the Che metrics collection used by Che.</a></p> |
| </li> |
| <li> |
| <p><a href="#checluster-custom-resource-status-settings_che"><code>CheCluster</code> Custom Resource <code>status</code> defines the observed state of Che installation</a></p> |
| </li> |
| </ul> |
| </div> |
| <div id="a-minimal-checluster-custom-resource-example_che" class="exampleblock"> |
| <div class="title">Example 1. A minimal <code>CheCluster</code> Custom Resource example.</div> |
| <div class="content"> |
| <div class="listingblock"> |
| <div class="content"> |
| <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">apiVersion: org.eclipse.che/v1 |
| kind: CheCluster |
| metadata: |
| name: eclipse-che |
| spec: |
| auth: |
| externalIdentityProvider: false |
| database: |
| externalDb: false |
| server: |
| selfSignedCert: false |
| gitSelfSignedCert: false |
| tlsSupport: true |
| storage: |
| pvcStrategy: 'common' |
| pvcClaimSize: '1Gi'</code></pre> |
| </div> |
| </div> |
| </div> |
| </div> |
| <div class="paragraph"> |
| <p><!-- vale off --></p> |
| </div> |
| <table id="checluster-custom-resource-server-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 1. <code>CheCluster</code> Custom Resource <code>server</code> settings, related to the Che server component.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">airGapContainerRegistryHostname</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Optional host name, or URL, to an alternate container registry to pull images from. This value overrides the container registry host name defined in all the default container images involved in a Che deployment. This is particularly useful to install Che in a restricted environment.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">airGapContainerRegistryOrganization</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Optional repository name of an alternate container registry to pull images from. This value overrides the container registry organization defined in all the default container images involved in a Che deployment. This is particularly useful to install Che in a restricted environment.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">allowUserDefinedWorkspaceNamespaces</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Defines that a user is allowed to specify a Kubernetes namespace, or an OpenShift project, which differs from the default. It’s NOT RECOMMENDED to set to <code>true</code> without OpenShift OAuth configured. The OpenShift infrastructure also uses this property.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheClusterRoles</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">A comma-separated list of ClusterRoles that will be assigned to Che ServiceAccount. Each role must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label. Be aware that the Che Operator has to already have all permissions in these ClusterRoles to grant them.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheDebug</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Enables the debug mode for Che server. Defaults to <code>false</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheFlavor</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Specifies a variation of the installation. The options are <code>che</code> for upstream Che installations or <code>devspaces</code> for Red Hat OpenShift Dev Spaces (formerly Red Hat CodeReady Workspaces) installation</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheHost</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public host name of the installed Che server. When value is omitted, the value it will be automatically set by the Operator. See the <code>cheHostTLSSecret</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheHostTLSSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Name of a secret containing certificates to secure ingress or route for the custom host name of the installed Che server. The secret must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label. See the <code>cheHost</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used in Che deployment. This does NOT include the container image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheImagePullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the image pull policy used in Che deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheImageTag</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the tag of the container image used in Che deployment. Omit it or leave it empty to use the default image tag provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheLogLevel</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Log level for the Che server: <code>INFO</code> or <code>DEBUG</code>. Defaults to <code>INFO</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheServerIngress</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The Che server ingress custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheServerRoute</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The Che server route custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheWorkspaceClusterRole</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Custom cluster role bound to the user for the Che workspaces. The role must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label. The default roles are used when omitted or left blank.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">customCheProperties</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Map of additional environment variables that will be applied in the generated <code>che</code> ConfigMap to be used by the Che server, in addition to the values already generated from other fields of the <code>CheCluster</code> custom resource (CR). When <code>customCheProperties</code> contains a property that would be normally generated in <code>che</code> ConfigMap from other CR fields, the value defined in the <code>customCheProperties</code> is used instead.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardCpuLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU limit used in the dashboard deployment. In cores. (500m = .5 cores). Default to 500m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardCpuRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU request used in the dashboard deployment. In cores. (500m = .5 cores). Default to 100m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used in the dashboard deployment. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardImagePullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the image pull policy used in the dashboard deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardIngress</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Dashboard ingress custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardMemoryLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory limit used in the dashboard deployment. Defaults to 256Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardMemoryRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory request used in the dashboard deployment. Defaults to 16Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dashboardRoute</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Dashboard route custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryCpuLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU limit used in the devfile registry deployment. In cores. (500m = .5 cores). Default to 500m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryCpuRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU request used in the devfile registry deployment. In cores. (500m = .5 cores). Default to 100m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used in the devfile registry deployment. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryIngress</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. The devfile registry ingress custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryMemoryLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory limit used in the devfile registry deployment. Defaults to 256Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryMemoryRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory request used in the devfile registry deployment. Defaults to 16Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryPullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the image pull policy used in the devfile registry deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryRoute</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. The devfile registry route custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryUrl</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated in favor of <code>externalDevfileRegistries</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">disableInternalClusterSVCNames</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Disable internal cluster SVC names usage to communicate between components to speed up the traffic and avoid proxy issues.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">externalDevfileRegistries</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">External devfile registries, that serves sample, ready-to-use devfiles. Configure this in addition to a dedicated devfile registry (when <code>externalDevfileRegistry</code> is <code>false</code>) or instead of it (when <code>externalDevfileRegistry</code> is <code>true</code>)</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">externalDevfileRegistry</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Instructs the Operator on whether to deploy a dedicated devfile registry server. By default, a dedicated devfile registry server is started. When <code>externalDevfileRegistry</code> is <code>true</code>, no such dedicated server will be started by the Operator and configure at least one devfile registry with <code>externalDevfileRegistries</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">externalPluginRegistry</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Instructs the Operator on whether to deploy a dedicated plugin registry server. By default, a dedicated plugin registry server is started. When <code>externalPluginRegistry</code> is <code>true</code>, no such dedicated server will be started by the Operator and you will have to manually set the <code>pluginRegistryUrl</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gitSelfSignedCert</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">When enabled, the certificate from <code>che-git-self-signed-cert</code> ConfigMap will be propagated to the Che components and provide particular configuration for Git. Note, the <code>che-git-self-signed-cert</code> ConfigMap must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">nonProxyHosts</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">List of hosts that will be reached directly, bypassing the proxy. Specify wild card domain use the following form <code>.<DOMAIN></code> and <code>|</code> as delimiter, for example: <code>localhost|.my.host.com|123.42.12.32</code> Only use when configuring a proxy is required. Operator respects OpenShift cluster wide proxy configuration and no additional configuration is required, but defining <code>nonProxyHosts</code> in a custom resource leads to merging non proxy hosts lists from the cluster proxy configuration and ones defined in the custom resources. See the doc <a href="https://docs.openshift.com/container-platform/4.4/networking/enable-cluster-wide-proxy.html" class="bare">https://docs.openshift.com/container-platform/4.4/networking/enable-cluster-wide-proxy.html</a>. See also the <code>proxyURL</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryCpuLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU limit used in the plugin registry deployment. In cores. (500m = .5 cores). Default to 500m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryCpuRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU request used in the plugin registry deployment. In cores. (500m = .5 cores). Default to 100m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used in the plugin registry deployment. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryIngress</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Plugin registry ingress custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryMemoryLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory limit used in the plugin registry deployment. Defaults to 256Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryMemoryRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory request used in the plugin registry deployment. Defaults to 16Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryPullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the image pull policy used in the plugin registry deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryRoute</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Plugin registry route custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryUrl</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL of the plugin registry that serves sample ready-to-use devfiles. Set this ONLY when a use of an external devfile registry is needed. See the <code>externalPluginRegistry</code> field. By default, this will be automatically calculated by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">proxyPassword</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Password of the proxy server. Only use when proxy configuration is required. See the <code>proxyURL</code>, <code>proxyUser</code> and <code>proxySecret</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">proxyPort</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Port of the proxy server. Only use when configuring a proxy is required. See also the <code>proxyURL</code> and <code>nonProxyHosts</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">proxySecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The secret that contains <code>user</code> and <code>password</code> for a proxy server. When the secret is defined, the <code>proxyUser</code> and <code>proxyPassword</code> are ignored. The secret must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">proxyURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">URL (protocol+host name) of the proxy server. This drives the appropriate changes in the <code>JAVA_OPTS</code> and <code>https(s)_proxy</code> variables in the Che server and workspaces containers. Only use when configuring a proxy is required. Operator respects OpenShift cluster wide proxy configuration and no additional configuration is required, but defining <code>proxyUrl</code> in a custom resource leads to overrides the cluster proxy configuration with fields <code>proxyUrl</code>, <code>proxyPort</code>, <code>proxyUser</code> and <code>proxyPassword</code> from the custom resource. See the doc <a href="https://docs.openshift.com/container-platform/4.4/networking/enable-cluster-wide-proxy.html" class="bare">https://docs.openshift.com/container-platform/4.4/networking/enable-cluster-wide-proxy.html</a>. See also the <code>proxyPort</code> and <code>nonProxyHosts</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">proxyUser</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">User name of the proxy server. Only use when configuring a proxy is required. See also the <code>proxyURL</code>, <code>proxyPassword</code> and <code>proxySecret</code> fields.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">selfSignedCert</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. The Che Operator will automatically detect whether the router certificate is self-signed and propagate it to other components, such as the Che server.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverCpuLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU limit used in the Che server deployment In cores. (500m = .5 cores). Default to 1.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverCpuRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the CPU request used in the Che server deployment In cores. (500m = .5 cores). Default to 100m.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverExposureStrategy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Sets the server and workspaces exposure type. Possible values are <code>multi-host</code>, <code>single-host</code>, <code>default-host</code>. Defaults to <code>multi-host</code>, which creates a separate ingress, or OpenShift routes, for every required endpoint. <code>single-host</code> makes Che exposed on a single host name with workspaces exposed on subpaths. Read the docs to learn about the limitations of this approach. Also consult the <code>singleHostExposureType</code> property to further configure how the Operator and the Che server make that happen on Kubernetes. <code>default-host</code> exposes the Che server on the host of the cluster. Read the docs to learn about the limitations of this approach.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverMemoryLimit</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory limit used in the Che server deployment. Defaults to 1Gi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverMemoryRequest</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the memory request used in the Che server deployment. Defaults to 512Mi.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">serverTrustStoreConfigMapName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Name of the ConfigMap with public certificates to add to Java trust store of the Che server. This is often required when adding the OpenShift OAuth provider, which has HTTPS endpoint signed with self-signed cert. The Che server must be aware of its CA cert to be able to request it. This is disabled by default. The Config Map must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">singleHostGatewayConfigMapLabels</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The labels that need to be present in the ConfigMaps representing the gateway configuration.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">singleHostGatewayConfigSidecarImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The image used for the gateway sidecar that provides configuration to the gateway. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">singleHostGatewayImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The image used for the gateway in the single host mode. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">tlsSupport</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. Instructs the Operator to deploy Che in TLS mode. This is enabled by default. Disabling TLS sometimes cause malfunction of some Che components.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">useInternalClusterSVCNames</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated in favor of <code>disableInternalClusterSVCNames</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspaceDefaultComponents</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Default components applied to DevWorkspaces. These default components are meant to be used when a Devfile does not contain any components.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspaceDefaultEditor</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The default editor to workspace create with. It could be a plugin ID or a URI. The plugin ID must have <code>publisher/plugin/version</code>. The URI must start from <code>http</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspaceNamespaceDefault</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Defines Kubernetes default namespace in which user’s workspaces are created for a case when a user does not override it. It’s possible to use <code><username></code>, <code><userid></code> and <code><workspaceid></code> placeholders, such as che-workspace-<username>. In that case, a new namespace will be created for each user or workspace.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspacePodNodeSelector</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The node selector that limits the nodes that can run the workspace pods.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspacePodTolerations</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The pod tolerations put on the workspace pods to limit where the workspace pods can run.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspacesDefaultPlugins</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Default plug-ins applied to Devworkspaces.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-database-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 2. <code>CheCluster</code> Custom Resource <code>database</code> configuration settings related to the database used by Che.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresContainerResources</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL container custom settings</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresDb</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL database name that the Che server uses to connect to the DB. Defaults to <code>dbche</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresHostName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL Database host name that the Che server uses to connect to. Defaults is <code>postgres</code>. Override this value ONLY when using an external database. See field <code>externalDb</code>. In the default case it will be automatically set by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresPassword</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL password that the Che server uses to connect to the DB. When omitted or left blank, it will be set to an automatically generated value.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresPort</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL Database port that the Che server uses to connect to. Defaults to 5432. Override this value ONLY when using an external database. See field <code>externalDb</code>. In the default case it will be automatically set by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The secret that contains PostgreSQL`user` and <code>password</code> that the Che server uses to connect to the DB. When the secret is defined, the <code>chePostgresUser</code> and <code>chePostgresPassword</code> are ignored. When the value is omitted or left blank, the one of following scenarios applies: 1. <code>chePostgresUser</code> and <code>chePostgresPassword</code> are defined, then they will be used to connect to the DB. 2. <code>chePostgresUser</code> or <code>chePostgresPassword</code> are not defined, then a new secret with the name <code>postgres-credentials</code> will be created with default value of <code>pgche</code> for <code>user</code> and with an auto-generated value for <code>password</code>. The secret must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">chePostgresUser</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">PostgreSQL user that the Che server uses to connect to the DB. Defaults to <code>pgche</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">externalDb</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Instructs the Operator on whether to deploy a dedicated database. By default, a dedicated PostgreSQL database is deployed as part of the Che installation. When <code>externalDb</code> is <code>true</code>, no dedicated database will be deployed by the Operator and you will need to provide connection details to the external DB you are about to use. See also all the fields starting with: <code>chePostgres</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">postgresImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used in the PostgreSQL database deployment. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">postgresImagePullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the image pull policy used in the PostgreSQL database deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">postgresVersion</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Indicates a PostgreSQL version image to use. Allowed values are: <code>9.6</code> and <code>13.3</code>. Migrate your PostgreSQL database to switch from one version to another.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pvcClaimSize</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Size of the persistent volume claim for database. Defaults to <code>1Gi</code>. To update pvc storageclass that provisions it must support resize when Che has been already deployed.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-auth-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 3. Custom Resource <code>auth</code> configuration settings related to authentication used by Che.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">debug</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Debug internal identity provider.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">externalIdentityProvider</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Instructs the Operator on whether or not to deploy a dedicated Identity Provider (Keycloak or RH SSO instance). Instructs the Operator on whether to deploy a dedicated Identity Provider (Keycloak or RH-SSO instance). By default, a dedicated Identity Provider server is deployed as part of the Che installation. When <code>externalIdentityProvider</code> is <code>true</code>, no dedicated identity provider will be deployed by the Operator and you will need to provide details about the external identity provider you are about to use. See also all the other fields starting with: <code>identityProvider</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gatewayAuthenticationSidecarImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Gateway sidecar responsible for authentication when NativeUserMode is enabled. See <a href="https://github.com/oauth2-proxy/oauth2-proxy">oauth2-proxy</a> or <a href="https://github.com/openshift/oauth-proxy">openshift/oauth-proxy</a>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gatewayAuthorizationSidecarImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Gateway sidecar responsible for authorization when NativeUserMode is enabled. See <a href="https://github.com/brancz/kube-rbac-proxy">kube-rbac-proxy</a> or <a href="https://github.com/openshift/kube-rbac-proxy">openshift/kube-rbac-proxy</a></p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gatewayHeaderRewriteSidecarImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Sidecar functionality is now implemented in Traefik plugin.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderAdminUserName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Overrides the name of the Identity Provider administrator user. Defaults to <code>admin</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderClientId</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Name of a Identity provider, Keycloak or RH-SSO, <code>client-id</code> that is used for Che. Override this when an external Identity Provider is in use. See the <code>externalIdentityProvider</code> field. When omitted or left blank, it is set to the value of the <code>flavour</code> field suffixed with <code>-public</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderContainerResources</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Identity provider container custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Overrides the container image used in the Identity Provider, Keycloak or RH-SSO, deployment. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderImagePullPolicy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Overrides the image pull policy used in the Identity Provider, Keycloak or RH-SSO, deployment. Default value is <code>Always</code> for <code>nightly</code>, <code>next</code> or <code>latest</code> images, and <code>IfNotPresent</code> in other cases.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderIngress</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Ingress custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderPassword</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Overrides the password of Keycloak administrator user. Override this when an external Identity Provider is in use. See the <code>externalIdentityProvider</code> field. When omitted or left blank, it is set to an auto-generated password.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderPostgresPassword</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Password for a Identity Provider, Keycloak or RH-SSO, to connect to the database. Override this when an external Identity Provider is in use. See the <code>externalIdentityProvider</code> field. When omitted or left blank, it is set to an auto-generated password.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderPostgresSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. The secret that contains <code>password</code> for the Identity Provider, Keycloak or RH-SSO, to connect to the database. When the secret is defined, the <code>identityProviderPostgresPassword</code> is ignored. When the value is omitted or left blank, the one of following scenarios applies: 1. <code>identityProviderPostgresPassword</code> is defined, then it will be used to connect to the database. 2. <code>identityProviderPostgresPassword</code> is not defined, then a new secret with the name <code>che-identity-postgres-secret</code> will be created with an auto-generated value for <code>password</code>. The secret must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderRealm</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Name of a Identity provider, Keycloak or RH-SSO, realm that is used for Che. Override this when an external Identity Provider is in use. See the <code>externalIdentityProvider</code> field. When omitted or left blank, it is set to the value of the <code>flavour</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderRoute</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Route custom settings.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. The secret that contains <code>user</code> and <code>password</code> for Identity Provider. When the secret is defined, the <code>identityProviderAdminUserName</code> and <code>identityProviderPassword</code> are ignored. When the value is omitted or left blank, the one of following scenarios applies: 1. <code>identityProviderAdminUserName</code> and <code>identityProviderPassword</code> are defined, then they will be used. 2. <code>identityProviderAdminUserName</code> or <code>identityProviderPassword</code> are not defined, then a new secret with the name <code>che-identity-secret</code> will be created with default value <code>admin</code> for <code>user</code> and with an auto-generated value for <code>password</code>. The secret must have <code>app.kubernetes.io/part-of=che.eclipse.org</code> label.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityProviderURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL of the Identity Provider server (Keycloak / RH-SSO server). Set this ONLY when a use of an external Identity Provider is needed. See the <code>externalIdentityProvider</code> field. By default, this will be automatically calculated and set by the Operator.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">identityToken</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Identity token to be passed to upstream. There are two types of tokens supported: <code>id_token</code> and <code>access_token</code>. Default value is <code>id_token</code>. This field is specific to Che installations made for Kubernetes only and ignored for OpenShift.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">initialOpenShiftOAuthUser</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. For operating with the OpenShift OAuth authentication, create a new user account since the kubeadmin can not be used. If the value is true, then a new OpenShift OAuth user will be created for the HTPasswd identity provider. If the value is false and the user has already been created, then it will be removed. If value is an empty, then do nothing. The user’s credentials are stored in the <code>openshift-oauth-user-credentials</code> secret in 'openshift-config' namespace by Operator. Note that this solution is Openshift 4 platform-specific.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">nativeUserMode</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Enables native user mode. Currently works only on OpenShift and DevWorkspace engine. Native User mode uses OpenShift OAuth directly as identity provider, without Keycloak.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">oAuthClientName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Name of the OpenShift <code>OAuthClient</code> resource used to setup identity federation on the OpenShift side. Auto-generated when left blank. See also the <code>OpenShiftoAuth</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">oAuthScope</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Access Token Scope. This field is specific to Che installations made for Kubernetes only and ignored for OpenShift.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">oAuthSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Name of the secret set in the OpenShift <code>OAuthClient</code> resource used to setup identity federation on the OpenShift side. Auto-generated when left blank. See also the <code>OAuthClientName</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">openShiftoAuth</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Enables the integration of the identity provider (Keycloak / RHSSO) with OpenShift OAuth. Empty value on OpenShift by default. This will allow users to directly login with their OpenShift user through the OpenShift login, and have their workspaces created under personal OpenShift namespaces. WARNING: the <code>kubeadmin</code> user is NOT supported, and logging through it will NOT allow accessing the Che Dashboard.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">updateAdminPassword</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Forces the default <code>admin</code> Che user to update password on first login. Defaults to <code>false</code>.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-storage-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 4. <code>CheCluster</code> Custom Resource <code>storage</code> configuration settings related to persistent storage used by Che.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">postgresPVCStorageClassName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Storage class for the Persistent Volume Claim dedicated to the PostgreSQL database. When omitted or left blank, a default storage class is used.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">preCreateSubPaths</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Instructs the Che server to start a special Pod to pre-create a sub-path in the Persistent Volumes. Defaults to <code>false</code>, however it will need to enable it according to the configuration of your Kubernetes cluster.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pvcClaimSize</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Size of the persistent volume claim for workspaces. Defaults to <code>10Gi</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pvcJobsImage</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Overrides the container image used to create sub-paths in the Persistent Volumes. This includes the image tag. Omit it or leave it empty to use the default container image provided by the Operator. See also the <code>preCreateSubPaths</code> field.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pvcStrategy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Persistent volume claim strategy for the Che server. This Can be:`common` (all workspaces PVCs in one volume), <code>per-workspace</code> (one PVC per workspace for all declared volumes) and <code>unique</code> (one PVC per declared volume). Defaults to <code>common</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">workspacePVCStorageClassName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Storage class for the Persistent Volume Claims dedicated to the Che workspaces. When omitted or left blank, a default storage class is used.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-k8s-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 5. <code>CheCluster</code> Custom Resource <code>k8s</code> configuration settings specific to Che installations on Kubernetes or OpenShift.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">ingressClass</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Ingress class that will define the which controller will manage ingresses. Defaults to <code>nginx</code>. NB: This drives the <code>kubernetes.io/ingress.class</code> annotation on Che-related ingresses.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">ingressDomain</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Global ingress domain for a Kubernetes cluster. This MUST be explicitly specified: there are no defaults.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">ingressStrategy</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. Strategy for ingress creation. Options are: <code>multi-host</code> (host is explicitly provided in ingress), <code>single-host</code> (host is provided, path-based rules) and <code>default-host</code> (no host is provided, path-based rules). Defaults to <code>multi-host</code> Deprecated in favor of <code>serverExposureStrategy</code> in the <code>server</code> section, which defines this regardless of the cluster type. When both are defined, the <code>serverExposureStrategy</code> option takes precedence.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">securityContextFsGroup</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The FSGroup in which the Che Pod and workspace Pods containers runs in. Default value is <code>1724</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">securityContextRunAsUser</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">ID of the user the Che Pod and workspace Pods containers run as. Default value is <code>1724</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">singleHostExposureType</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated. The value of this flag is ignored. When the serverExposureStrategy is set to <code>single-host</code>, the way the server, registries and workspaces are exposed is further configured by this property. The possible values are <code>native</code>, which means that the server and workspaces are exposed using ingresses on K8s or <code>gateway</code> where the server and workspaces are exposed using a custom gateway based on <a href="https://doc.traefik.io/traefik/">Traefik</a>. All the endpoints whether backed by the ingress or gateway <code>route</code> always point to the subpaths on the same domain. Defaults to <code>native</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">tlsSecretName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Name of a secret that will be used to setup ingress TLS termination when TLS is enabled. When the field is empty string, the default cluster certificate will be used. See also the <code>tlsSupport</code> field.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-metrics-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 6. <code>CheCluster</code> Custom Resource <code>metrics</code> settings, related to the Che metrics collection used by Che.</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">enable</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Enables <code>metrics</code> the Che server endpoint. Default to <code>true</code>.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| <table id="checluster-custom-resource-status-settings_che" class="tableblock frame-all grid-all stretch"> |
| <caption class="title">Table 7. <code>CheCluster</code> Custom Resource <code>status</code> defines the observed state of Che installation</caption> |
| <colgroup> |
| <col style="width: 28.5714%;"> |
| <col style="width: 71.4286%;"> |
| </colgroup> |
| <thead> |
| <tr> |
| <th class="tableblock halign-left valign-top">Property</th> |
| <th class="tableblock halign-left valign-top">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheClusterRunning</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Status of a Che installation. Can be <code>Available</code>, <code>Unavailable</code>, or <code>Available, Rolling Update in Progress</code>.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL to the Che server.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">cheVersion</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Current installed Che version.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">dbProvisioned</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Indicates that a PostgreSQL instance has been correctly provisioned or not.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devfileRegistryURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL to the devfile registry.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">devworkspaceStatus</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The status of the Devworkspace subsystem</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gitHubOAuthProvisioned</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Indicates whether an Identity Provider instance, Keycloak or RH-SSO, has been configured to integrate with the GitHub OAuth.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">gitServerTLSCertificateConfigMapName</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">The ConfigMap containing certificates to propagate to the Che components and to provide particular configuration for Git.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">helpLink</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">A URL that points to some URL where to find help related to the current Operator status.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">keycloakProvisioned</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Indicates whether an Identity Provider instance, Keycloak or RH-SSO, has been provisioned with realm, client and user.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">keycloakURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL to the Identity Provider server, Keycloak or RH-SSO,.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">message</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">A human readable message indicating details about why the Pod is in this condition.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">openShiftOAuthUserCredentialsSecret</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">OpenShift OAuth secret in <code>openshift-config</code> namespace that contains user credentials for HTPasswd identity provider.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">openShiftoAuthProvisioned</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Indicates whether an Identity Provider instance, Keycloak or RH-SSO, has been configured to integrate with the OpenShift OAuth.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">pluginRegistryURL</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">Public URL to the plugin registry.</p></td> |
| </tr> |
| <tr> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">reason</p></td> |
| <td class="tableblock halign-left valign-top"><p class="tableblock">A brief CamelCase message indicating details about why the Pod is in this state.</p></td> |
| </tr> |
| </tbody> |
| </table> |
| </article> |
| </div> |
| </main> |
| </div> |
| <footer class="footer"> |
| <div> |
| <a href="https://www.eclipse.org/che/sitemap.xml" target="_blank">Site Map</a> | |
| <a href="https://www.eclipse.org" target="_blank">Eclipse Foundation</a> | |
| <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">Privacy Policy</a> | |
| <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">Terms of Use</a> | |
| <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">Eclipse Public License</a> | |
| <a href="https://www.eclipse.org/legal" target="_blank">Legal Resources</a></div> |
| </footer> |
| |
| <script src="../../../../docs/_/js/site.js"></script> |
| <script async src="../../../../docs/_/js/vendor/highlight.js"></script> |
| <script src="../../../../docs/_/js/vendor/lunr.js"></script> |
| <script src="../../../../docs/_/js/search-ui.js" id="search-ui-script" data-site-root-path="../../../.." data-snippet-length="142" data-stylesheet="../../../../docs/_/css/search.css"></script> |
| <script async src="../../../../search-index.js"></script> |
| </body> |
| </html> |
