Eclipse Che hosted by Red Hat

This section describes procedures to get started with Eclipse Che hosted by Red Hat - https://workspaces.openshift.com

About Eclipse Che hosted by Red Hat

Eclipse Che hosted by Red Hat is an open-source product based on Eclipse Che that is running on OpenShift Dedicated. The new service is part of the Developer Sandbox for Red Hat OpenShift offering, and is using CodeReady Workspaces, which is built upon Eclipse Che and is optimized for Red Hat OpenShift and Red Hat Linux.

Differences between Eclipse Che and CodeReady Workspaces

Red Hat CodeReady Workspaces is the product that is built from the Eclipse Che project. The product is normally two versions behind the project. Red Hat also provides licensing, packaging, and support, so CodeReady Workspaces is considered a more stable product than the upstream Eclipse Che project. More details about the difference between Eclipse Che and Red Hat CodeReady Workspaces can be found on the official documentation.

Eclipse Che and Red Hat CodeReady Workspaces share all of the features - all the product’s functionality is available in the project and vice versa. However, not all the upstream plugins are available in the CodeReady Workspaces. To use an unsupported plugin inside the CodeReady Workspaces, one needs to explicitly point to the raw meta.yaml of the plugin from the devfile. The procedure is described in the Adding a VS Code extension using the workspace configuration section.

Terms of service

Eclipse Che hosted by Red Hat has the following usage limits and terms of service:

  • Storage: 10 GB

  • RAM: 7 GB

  • Concurrent workspaces: 1

  • Number of workspaces: Unlimited

  • Number of projects per workspace: Unlimited

  • Usage time limit: 30 days

    The account will be active for 30 days. At the end of the active period, the access will be revoked and all the data will be deleted. All existing workspaces will be lost. To start using Eclipse Che hosted by Red Hat again, a user must re-register.
  • Maximum time for a running workspace: 8 hours

    Eclipse Che hosted by Red Hat automatically stops workspaces that run more than 8 hours regardless of activity.
  • Workspace idling time: 30 minutes

    If there are no interactions with the IDE, the workspace will be stopped after 30 minutes.

Registering to Eclipse Che hosted by Red Hat

This section describes how to register to Eclipse Che hosted by Red Hat.

Procedure
  1. Navigate to Developer Sandbox for Red Hat OpenShift.

  2. Register with an existing OpenShift Online, Red Hat Developer Program, or Red Hat Customer Portal account, or create a new Red Hat account.

  3. Verify the telephone number

A valid telephone number is required for reducing the creation of fraudulent accounts on the Developer Sandbox for Red Hat OpenShift. Red Hat will not use this information for any other reason, and you will never receive a telephone call from Red Hat or any third-party as a result of trying the sandbox.
  1. Once the account is provisioned, Eclipse Che hosted by Red Hat will be ready for use from both Developer Sandbox and https://workspaces.openshift.com pages.

Creating a workspace from the user dashboard

This section describes how to create a workspace from the user dashboard in Eclipse Che hosted by Red Hat.

Prerequisites
Procedure
  1. Navigate to workspaces.openshift.com.

  2. Once login, the redirect to the user dashboard will happen.

  3. Click the Add Workspace button and create a "Custom Workspace" using Devfile, or choose the "Get Started" tab, and pick one of the existing samples.

Additional resources

Creating a workspace from a template on the official Eclipse Che website

This section describes how to create a workspace from a predefined template.

Various programming languages and frameworks are supported.

Prerequisites
Procedure
  1. Navigate to the templates registry.

  2. Choose the required type of a workspace.

  1. Click the Launch Workspace button.

The workspace is created and displayed in the Eclipse Che hosted by Red hat.

getting started devfile

Contributing to GitHub projects from Eclipse Che hosted by Red Hat

This section describes how to contribute to GitHub projects from Eclipse Che hosted by Red Hat.

Prerequisites
  • A workspace running in Eclipse Che hosted by Red Hat, including a project imported from GitHub.

  • The SSH Plug-in is available in the workspace.

Procedure
  1. Generate an SSH key pair with the SSH Plug-in.

  2. Upload the public key to the GitHub account. For details, see the Adding a new SSH key to your GitHub account procedure.

Frequently Asked Questions (FAQs) and Troubleshooting

FAQs

Eclipse Che hosted by Red Hat is part of the Developer Sandbox for Red Hat OpenShift offering. The common FAQs are available on the Developer Sandbox for Red Hat OpenShift website.

Troubleshooting

Unexpected error during login

If an unexpected error during login happens the workaround is refreshing the page:

We are sorry... Unexpected error when authenticating with identity provider

To authenticate to https://workspaces.openshift.com, one needs to allow cookies from the static.developers.redhat.com. In case these cookies are blocked (by a browser extension like Privacy Badger), authentication will fail.

Telemetry

Telemetry is enabled in Eclipse Che hosted by Red Hat, so Woopra / Segment tracking scripts must be explicitly allowed in case being blocked by a browser extension:

In case, the browser is running in the incognito mode the third-party cookies must be explicitly unblocked:

unblock third party cookies

Otherwise, the workspace startup will fail.

Additional resources