此内容没有您所选择的语言版本。
Release Notes and Known Issues
Release Notes and Known Issues for Red Hat CodeReady Workspaces 2.10
Abstract
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.
| Platform | Architecture | Deployment method |
| OpenShift Container Platform 3.11 | AMD64 and Intel 64 (x86_64) |
|
| OpenShift Container Platform 4.6 | AMD64 and Intel 64 (x86_64) |
OperatorHub, |
| OpenShift Container Platform 4.6 | IBM Z (s390x) |
OperatorHub, |
| OpenShift Container Platform 4.6 | IBM Power Systems (ppc64le) |
OperatorHub, |
| OpenShift Container Platform 4.7 | AMD64 and Intel 64 (x86_64) |
OperatorHub, |
| OpenShift Container Platform 4.7 | IBM Z (s390x) |
OperatorHub, |
| OpenShift Container Platform 4.7 | IBM Power Systems (ppc64le) |
OperatorHub, |
| OpenShift Dedicated 4.7 | AMD64 and Intel 64 (x86_64) | Add-On |
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).
Additional resources
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
- Run the CodeReady Workspaces instance in a non-restricted environment.
- 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
crwctlfrom 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
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
- Navigate to the DevWorkspace details
Edit the DevWorkspace YAML to set the endpoints attributes type to
main.endpoints: - attributes: type: main- 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
- 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-in IBM Power System Other architectures Che-Theia editor
2G
512M
OpenShift connector
2.5G
1.5G