此内容没有您所选择的语言版本。

Release Notes and Known Issues


Red Hat CodeReady Workspaces 2.10

Release Notes and Known Issues for Red Hat CodeReady Workspaces 2.10

Michal Maléř

Robert Kratky

Fabrice Flore-Thébault

Red Hat Developer Group Documentation Team

Abstract

Information about new and noteworthy features as well as known issues in Red Hat CodeReady Workspaces 2.10.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Chapter 1. About Red Hat CodeReady Workspaces

Red Hat CodeReady Workspaces is a web-based integrated development environment (IDE). CodeReady Workspaces runs in OpenShift and is well-suited for container-based development.

CodeReady Workspaces provides:

  • an enterprise-level cloud developer workspace server,
  • a browser-based IDE,
  • ready-to-use developer stacks for popular programming languages, frameworks, and Red Hat technologies.

Red Hat CodeReady Workspaces 2.10 is based on Eclipse Che 7.32.

1.1. Supported deployment environments

This section describes the availability and the supported installation methods of CodeReady Workspaces 2.10 on OpenShift Container Platform 4.6, 3.11, and OpenShift Dedicated.

Expand
Table 1.1. Supported deployment environments for CodeReady Workspaces 2.10 on OpenShift Container Platform and OpenShift Dedicated

Platform

Architecture

Deployment method

OpenShift Container Platform 3.11

AMD64 and Intel 64 (x86_64)

crwctl

OpenShift Container Platform 4.6

AMD64 and Intel 64 (x86_64)

OperatorHub, crwctl

OpenShift Container Platform 4.6

IBM Z (s390x)

OperatorHub, crwctl

OpenShift Container Platform 4.6

IBM Power Systems (ppc64le)

OperatorHub, crwctl

OpenShift Container Platform 4.7

AMD64 and Intel 64 (x86_64)

OperatorHub, crwctl

OpenShift Container Platform 4.7

IBM Z (s390x)

OperatorHub, crwctl

OpenShift Container Platform 4.7

IBM Power Systems (ppc64le)

OperatorHub, crwctl

OpenShift Dedicated 4.7

AMD64 and Intel 64 (x86_64)

Add-On

Note

Support for deploying CodeReady Workspaces on OpenShift Container Platform on IBM Z (s390x) is currently only available as a Technology Preview feature. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For details about the level of support for Technology Preview features, see Technology Preview Features Support Scope.

1.2. Support policy

For Red Hat CodeReady Workspaces 2.10, Red Hat will provide support for deployment, configuration, and use of the product.

CodeReady Workspaces 2.10 has been tested on Chrome version 90.0.4430.72 (Official Build) (64-bit).

The main differences between CodeReady Workspaces and Eclipse Che are:

  • CodeReady Workspaces is built on RHEL8 to ensure the latest security fixes are included, compared to Alpine distributions that take a longer time to update.
  • CodeReady Workspaces uses Red Hat Single Sign-On (RH-SSO) rather than the upstream project Keycloak.
  • CodeReady Workspaces provides a smaller supported subset of plug-ins compared to Che. CodeReady Workspaces provides devfiles for working with other Red Hat technologies such as EAP and Fuse.
  • CodeReady Workspaces is supported on OpenShift Container Platform and OpenShift Dedicated; Eclipse Che can run on other Kubernetes clusters.

Red Hat provides licensing, packaging, and support. Therefore CodeReady Workspaces is considered a more stable product than the upstream Eclipse Che project.

Chapter 2. Notable enhancements

When a VS Code extension have not used environment variables, the user had to set the configuration in the devfile scope. For an extension to modify the configuration of another extension, the user had to create a separate plug-in embedding both extensions. With this release, the user can set default static configurations in the plug-in’s meta.yaml.

  • An extension can modify the configuration of another extension.

Example 2.1. Lombok and Java

The Lombok extension is defining configuration for the Java engine.

Additional resources

2.2. Using a new format to specify editors and plug-ins

Before this update, CodeReady Workspaces used the meta.yaml format.

With this update, CodeReady Workspaces is using: * Devfile v2 format to specify editors and plug-ins * an additional che-theia-plugin.yaml fragment to specify plug-ins preferences

This format enables to define: * dependencies between plug-ins * sidecar options * plug-in preferences

Additional resources

Editors in che-editors.yaml are defined using the devfile v2 specification, rather than the legacy meta.yaml syntax

Additional resources

2.4. Redesign of the Create Workspace landing page

The landing page is named Create Workspace rather than Get Started Page. The Quick Add tab includes an Import from Git section.

Additional resources

The per-user namespace strategy is the unique namespace strategy available in CodeReady Workspaces 2.10. Support for other namespace strategies is removed. The CodeReady Workspaces Operator does not allow upgrading installations using a namespace strategy other than per-user.

Additional resources

Latest python extension includes Jupyter support. This feature is available in CodeReady Workspaces.

Additional resources

All namespace strategies except the per-user strategy are unsupported.

This results in:

  • Improving security.
  • Better administration control over the assigned resource to a user using namespace quotas.
  • Elimination of the need to duplicate sensitive information using Kubernetes secrets, as with the per-workspace strategy.

Additional resources

When all workspaces of a user are deleted, delete the PVC to free storage (common storage strategy).

Additional resources

Before this update, when a user didn’t have enough privileges to create a namespace, the workspace start failed. With this update, CodeReady Workspaces always uses the CodeReady Workspaces ServiceAccount to creates the user namespace. An administrator can configure CodeReady Workspaces to create the namespace using the user token.

Additional resources

Support for deploying CodeReady Workspaces on OpenShift Container Platform on IBM Power Systems is no longer a Technology Preview feature. CodeReady Workspaces 2.10 is fully supported on IBM Power Systems infrastructure.

Additional resources

Chapter 3. Bug fixes

The Resources Monitor Plug-in has enough permissions to read Pod information.

Additional resources

3.2. Propagate errors from DevWorkspace Routing

Propagate the specific reason the controller cannot reconcile Components and WorkspaceRoutings into the condition message.

Additional resources

3.3. Dashboard explains failures happening on pre-load

Before this update, when the Dashboard failed to pre-load data, it didn’t show any error message. With this update, it displays an error message describing the reason of the failure.

Additional resources

3.4. Fixing Git cloning failure behind a proxy

Before this update, when running CodeReady Workspaces behind a proxy, cloning a git repository failed. With this update, when the editor is Che-Theia, cloning a git repository when running CodeReady Workspaces behind a proxy is possible.

Additional resources

Chapter 4. Known issues

Delve, a debugger for the Go programming language, is not available for IBM Z and IBM Power Systems architecture. Therefore, debugging features cannot be activated in the Go workspace in CodeReady Workspaces 2.10. An attempt to activate this feature results in the Failed to continue error message.

Workaround

  • Delve debugger is not available for IBM Z and IBM Power Systems architectures, therefore cannot be used.

Additional resources

In a workspace created using the default Go devfile, some features fail because additional tools are missing. For instance, Auto-complete is unavailable.

Procedure

  1. Run the CodeReady Workspaces instance in a non-restricted environment.
  2. Install the required module using the Install button of the pop-up window in the IDE.

Additional resources

The failure caused by a lack of OpenShift Container Platform cluster resources is accompanied by a misleading error message:

Your session has expired. Please, log in to CodeReady Workspaces again to get access to your OpenShift account.

This message will be fixed in the upcoming release.

Workaround

  • Provide more resources to the OpenShift Container Platform cluster.

Additional resources

If you start a task from My workspace multiple times, the task doesn’t end properly. The IDE displays a spinning-wheel icon as a replacement for the "✓" marker. As a consequence, the subsequent task execution can’t be started.

Workaround

  • Execute a task in the My workspace environment once.

Additional resources

4.5. Failing to run the PHP debug

CodeReady Workspaces fails to run the PHP debug. PHP is a technology preview feature.

Additional resources

4.6. Get-Started devfiles have incorrect source location

Get-Started devfiles have incorrect source location after the switch from multi-host to single-host exposure strategy.

Additional resources

When building the devfile registry, the build process updates the devfiles to set the source location of the artifact archives. When specifying multiple registries, the build process doesn’t update the archive source location in the devfiles properly.

Example 4.1. Deployment using multiple registries

The Developer Sandbox enables the community registry and the CodeReady Workspaces registry.

Workaround

  • Build the registries specifying one unique registry.

Additional resources

The crwctl binaries don’t run on IBM Z and IBM Power Systems. These platforms are available uniquely as targets to deploy CodeReady Workspaces to.

Workaround

  • Run crwctl from a supported platform.

Additional resources

4.9. Workspace creation failing on unstable networks

CodeReady Workspaces is intermittently failing to create a workspace when the network is unstable. CodeReady Workspaces displays following error:

Failed to run the workspace: "Waiting for pod 'workspace9fbid1gnx7273d47.maven-545f8c9cf4-hw79f' was interrupted."

Additional resources

4.10. Unsupported devfiles on IBM Z and IBM Power Systems

These devfiles are not supported on IBM Z and IBM Power Systems:

  • EAP for OpenJDK 8
  • .Net
  • Fuse

Workaround

  • Don’t use unsupported languages on IBM Z and IBM Power Systems.

Additional resources

4.11. Technology preview support for IBM Z

Support for deploying CodeReady Workspaces on OpenShift Container Platform on IBM Z is available as a Technology Preview feature. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not suggest using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

Additional resources

The activation of the Appliance for Apache Camel K by Red Hat extension fails with the error message:

Activating extension `Appliance for Apache Camel K by Red Hat` failed: Dependent extension `redhat.vscode-commons` is not installed.

Additional resources

CodeReady Workspaces fails to start a workspace with a factory when the workspace is defined using the devfile 2.0 (DevWorkspace) specification. Then, CodeReady Workspaces displays the following error message:

Getting workspace detail data failed. Failed to fetch the workspace sprin-petclinic, reason: Could not retrieve the main URL for the running workspace.

Workaround

  1. Navigate to the DevWorkspace details
  2. Edit the DevWorkspace YAML to set the endpoints attributes type to main.

    endpoints:
      - attributes:
          type: main
  3. Restart the DevWorkspace.

Additional resources

The Python language server functionality does not work, and an error message is displayed while invoking the autocomplete and error highlighting functions.

Additional resources

The OpenShift Connector plug-in fails to deploy because of the inability to access the odo image in the disconnected environment.

Additional resources

4.16. Debug configuration missing

Debug configurations are not loaded. The Debug panel displays:

No Configurations

Workaround

  • Refresh the page, and the debug configurations appear.

Additional resources

After patching a CodeReady Workspaces 2.10 instances from multi-host to single-host, the "Create Workspace" Dashboard page displays incomplete UI with missing icons.

Workaround

Re-deploy the devfile registry Pod after the update.

Additional resources

Bitbucket factory URL fails for public repositories outside OpenShift Container Platform for CodeReady Workspaces without Bitbucket OAuth enabled.

Workaround

  1. Add the TLS sefl-signed certificate to the CodeReady Workspaces instance, see Importing untrusted TLS certificates to CodeReady Workspaces.

Additional resources

Chapter 5. Frequently asked questions

Is it possible to deploy applications to an OpenShift cluster from CodeReady Workspaces?
Yes. The user must log in to the OpenShift cluster from their running workspace using oc login.
For best performance, what is the recommended storage to use for Persistent Volumes used with CodeReady Workspaces?
Use block storage.
Is it possible to deploy more than one CodeReady Workspaces instance on the same cluster?
It is not recommended. This feature is subject to removal in a future release.
Is it possible to install CodeReady Workspaces offline (that is, disconnected from the internet)?
Yes. See Installing CodeReady Workspaces in restricted environments.
Is it possible to use non-default certificates with CodeReady Workspaces?
Yes, you can use self-signed or public certificates. See Installing CodeReady Workspaces on OpenShift Container Platform 3.11.
Is it possible to run multiple workspaces simultaneously?
Yes. See Configuring the number of workspaces a user can run.
What specific changes have been implemented for IBM Power Systems?

The memory limit for some plug-ins has been increased, to give Pods sufficient RAM to run.

Expand
Table 5.1. Example memory limits differences between IBM Power System and other architectures
Plug-inIBM Power SystemOther architectures

Che-Theia editor

2G

512M

OpenShift connector

2.5G

1.5G

Legal Notice

Copyright © 2021 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部