The following pages and posts are tagged with

TitleExcerpt
Workspace Management Creating Workspaces The easiest way to create a workspace is to use ready to go stacks in User Dashboard. Images and configuration in these stacks is certified both for Docker and OpenShift, and these are the stacks that are used in daily functional testing. There are multiple options...
Environment variables Environment variables are defined per machine. Depending on the infrastructure, they are added either to container or Kubernetes pod definition. You can add, edit and remove environment variables either in User Dashboard or directly in workspace machine configuration: "env": { <span...
Workspace Environments
Installers What Are Installers? Installers are scripts that are injected into machines in a runtime and get executed there to: Prepare environment and download dependencies for particular software or tool Install chosen software and dependencies Launch software and tools in a certain way (arguments, mode etc) that provide extra...
Che on Kuberentes: Admin Guide Examples All examples use kubectl command. OpenShift admins should use oc RAM Single User Che server pod consumes up to 1GB RAM. The initial request is 256MB, and server pod rarely consumes more than 800MB. A typical workspace will require 2GB. So, 3GB is a...
Configuration: Kuberentes How It Works Che server behavior can be configured by passing environment variables to Che deployment. There are multiple ways to edit Che deployment to add new or edit existing envs: kubectl edit dc/che opens Che deployment yaml in nano editor (VIM is used by default) manually...
Multi-User&#58 Deploy to Kubernetes Prerequisites A Kubernetes cluster with at least 4GB RAM and RBAC: for MiniKube 0.26.0 and above minikube start --cpus 2 --memory 4096 --extra-config=apiserver.authorization-mode=RBAC for MiniKube 0.25.2 and lower minikube start --cpus 2 --memory 4096 --extra-config=apiserver.Authorization.Mode=RBAC kubectl create clusterrolebinding add-on-cluster-admin --clusterrole=cluster-admin --serviceaccount=kube-system:default ...
Single-User&#58 Deploy to Kubernetes Supported Kuberentes Flavors and Versions Tested only on MiniKube v0.25 with vm providers VirtualBox and kvm2. Pre-Reqs bash Kubernetes installation with: enabled DNS discovery; configured ingress controller. Note: you can start it on MiniKube with minikube addons enable ingress. <h2...
Che on OpenShift: Admin Guide {% include links.html %} {% include_relative admin-guide.md %} ## Create workspace objects in personal namespaces When Che is installed on OpenShift in multi-user mode, it is possible to register the OpenShift server into the Keycloak server as an identity provider, in order to allow creating workspace objects in the personal...
Projects ## Projects in Workspaces {% include links.html %} Projects are always associated with a workspace and saved in a workspace configuration: ```json "projects": [ { "description": "A basic example using Spring servlets. The app returns values entered into a submit form.", "source": { "location": "https://github.com/che-samples/web-java-spring.git", "type": "git", "parameters": {} },...
Recipes {% include links.html %} ## Supported Recipe Formats Depending on the infrastructure, Che supports the following recipes out of the box (default Che build): | **Infrastructure** | **Docker Image** | **Dockerfile** | **Composefile** | **Kubernetes yaml** | | **Docker** | Supported | Supported | Supported | Not supported | |...
Servers {% include links.html %} ## What Are Servers A server defines protocol and port of a process that runs in a machine. It also has a name and optional attributes, if this is a `special purpose` server, for example a [Language Server][TODO: language-servers]. In simple words, if you need to...
Stacks {% include links.html %} ## What Are Stacks A stack is a template of [workspace configuration][workspace-data-model] and some meta-information like scope, tags, components, description, name and ID. Stacks are used by User Dashboard to make it easy to create workspaces and well as filter sample projects compatible with a chosen...
Volumes {% include links.html %} ## Default Volumes By default workspace containers/pods start with one default volume/PVC that persists `/projects` where workspace projects are physically located. When a workspace is stopped its machines are destroyed, however, volumes stay there. ## User-Provided Volumes Your workspace may need additional volumes though, say, to...
What Is a Che Workspace? ## Workspace Eclipse Che reinvents the definition of a workspace which is usually termed as a local directory with projects and some meta-information that IDE uses to properly configure them. In Eclipse Che, a workspace is the developer environment itself represented by Docker containers, k8s pods or something else (for...
Workspace Data Model {% include links.html %} ``` environments: Map // Workspace envs. A workspace can have multiple envs defaultEnv: STRING // A workspace should have a default environment projects: [] // Projects associated with a workspace commands: [] // Commands associated with a workspace name: STRING // Workspace name that has...
Workspace REST API {% include links.html %}
Troubleshooting Workspace Start Failures {% include links.html %} Failures to start a workspace may be caused by different factors: 1. Environment recipe 2. Network conditions ## Bad Recipes When a workspace is being started, environment [recipe][recipes] is sent to Docker or OpenShift API. Che server then listens to events provided by a particular infrastructure....