Developer workspaces

Eclipse Che provides developer workspaces with everything needed to a code, build, test, run, and debug applications. To allow that, the developer workspaces provide four main components:

  1. The source code of a project.

  2. A web-based IDE.

  3. Tool dependencies, needed by developers to work on a project

  4. Application runtime: a replica of the environment where the application runs in production

Pods manage each component of a Che workspace. Therefore, everything running in a Che workspace is running inside containers. This makes a Che workspace highly portable.

The embedded browser-based IDE is the point of access for everything running in a Che workspace. This makes a Che workspace easily shareable.

By default, it is possible to run only one workspace at a time. To change the default value, see: Users workspace limits.
Table 1. Features and benefits
Features Traditional IDE workspaces Eclipse Che workspaces

Configuration and installation required

Yes.

No.

Embedded tools

Partial. IDE plug-ins need configuration. Dependencies need installation and configuration. Example: JDK, Maven, Node.

Yes. Plug-ins provide their dependencies.

Application runtime provided

No. Developers have to manage that separately.

Yes. Application runtime is replicated in the workspace.

Shareable

No. Or not easily

Yes. Developer workspaces are shareable with a URL.

Versionable

No

Yes. Devfiles exist with project source code.

Accessible from anywhere

No. Installation is needed.

Yes. Only requires a browser.

To start a Che workspace, following options are available:

Use the Dashboard to discover Che 7.19:

Use a devfile as the preferred way to start a Che 7.19 workspace:

Use the browser-based IDE as the preferred way to interact with a Che 7.19 workspace. For an alternative way to interact with a Che 7.19 workspace, see: Remotely accessing workspaces.

It is common for code repositories to display badges in their README files that describe various aspects of the project, such as its test coverage, latest build status, link to documentation, and other things. For example, the Che GitHub README has the following badges:

eclipse che badges

To make the process of using Che easier, the following badge is available: Factory Badge

Use this badge and link it to a Che instance to quickly open a developer workspace.

Including the developer workspace badge in a README

Procedure

Add a link to your repository in the project README file. Using che.openshift.io as an example Che host, and a GitHub repository:

[![Contribute](https://www.eclipse.org/che/contribute.svg)](https://che.openshift.io/f?url=https://github.com/org/repository)

The snippet above creates a badge that opens a developer workspace of the repository at https://github.com/org/repository in che.openshift.io. To open a workspace in your Che installation, substitute your URL and repository:

[![Contribute](https://www.eclipse.org/che/contribute.svg)](https://your-che-host.com/f?url=https://your-repository-url)