Running more than one workspace at a time

This procedure describes how to run more than one workspace simultaneously. This makes it possible for multiple workspace contexts per user to run in parallel.

Prerequisites
  • The `kubectl` or `oc` tool is available.

  • An instance of Che running in Kubernetes or OpenShift.

    The following commands use the default Kubernetes namespace or OpenShift project, eclipse-che, as a user’s example for the -n option.

Procedure
  1. Change the default limit of 1 to -1 to allow an unlimited number of concurrent workspaces per user:

    • For Helm Chart deployments:

      $ helm upgrade che -n eclipse-che --set che.limits.userWorkspacesRunCount=-1
    • For Operator deployments:

      $ kubectl patch checluster eclipse-che -n eclipse-che --type merge \
        -p '{ "spec": { "server": {"customCheProperties": {"CHE_LIMITS_USER_WORKSPACES_RUN_COUNT": "-1"} } }}'
  2. Set the per-workspace or unique PVC strategy. See Configuring storage strategies.

    When using the common PVC strategy, configure the persistent volumes to use the ReadWriteMany access mode. That way, any of the user’s concurrent workspaces can read from and write to the common PVC.