Release notes and known issues
Release notes and known issues for Red Hat OpenShift Dev Spaces 3.21
Abstract
Making open source more inclusive Copy linkLink copied to clipboard!
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 OpenShift Dev Spaces Copy linkLink copied to clipboard!
Red Hat OpenShift Dev Spaces provides web-based development environments on Red Hat OpenShift with an enterprise-level setup:
- Cloud Development Environments (CDE) server
- IDEs such as Microsoft Visual Studio Code - Open Source, JetBrains IntelliJ IDEA Community and desktop IntelliJ IDEA Ultimate, PyCharm, WebStorm, RubyMine, CLion editors as a Technology Preview.
- Containerized environments with popular programming languages, frameworks, and Red Hat technologies
Red Hat OpenShift Dev Spaces is well-suited for container-based development.
Red Hat OpenShift Dev Spaces 3.21 is based on Eclipse Che 7.102.
1.1. Supported platforms Copy linkLink copied to clipboard!
OpenShift Dev Spaces runs on OpenShift 4.14–4.18 on the following CPU architectures:
-
AMD64 and Intel 64 (
x86_64) -
IBM Z (
s390x) -
IBM Power (
ppc64le)
Additional resources
1.2. Support policy Copy linkLink copied to clipboard!
For Red Hat OpenShift Dev Spaces 3.21, Red Hat will provide support for deployment, configuration, and use of the product.
Additional resources
1.3. Differences between Red Hat OpenShift Dev Spaces and Eclipse Che Copy linkLink copied to clipboard!
There are some differences between Red Hat OpenShift Dev Spaces and the upstream project on which it is based, Eclipse Che:
- OpenShift Dev Spaces is supported only on Red Hat OpenShift.
- OpenShift Dev Spaces is based on Red Hat Enterprise Linux and is regularly updated to include the latest security fixes.
- OpenShift Dev Spaces provides getting-started samples supported in the air-gap mode with languages and technologies such as Quarkus, Lombok, NodeJS, Python, DotNet, Golang, and C/C++. Community samples are available at the Devfile registry page.
- OpenShift Dev Spaces uses OpenShift OAuth for user login and management.
Red Hat provides licensing and packaging to ensure enterprise-level support for OpenShift Dev Spaces.
Chapter 2. New features and enhancements Copy linkLink copied to clipboard!
2.1. Allow concealing editors on the User Dashboard Copy linkLink copied to clipboard!
Starting from this release, the admin can conceal particular editors on the User Dashboard using the dedicated environment variable CHE_HIDE_EDITORS_BY_ID in the Custom Resource :
spec:
components:
dashboard:
deployment:
containers:
- env:
- name: CHE_HIDE_EDITORS_BY_ID
value: che-incubator/che-webstorm-server/latest, che-incubator/che-webstorm-server/next,
che-incubator/che-rubymine-server/latest, che-incubator/che-rubymine-server/next,
che-incubator/che-pycharm-server/latest, che-incubator/che-pycharm-server/next,
che-incubator/che-clion-server/latest, che-incubator/che-clion-server/next,
che-incubator/che-idea-server/latest, che-incubator/che-idea-server/next,
che-incubator/che-idea/latest, che-incubator/che-idea/next
Learn more about this feature in the official documentation.
Additional resources
2.2. Update Traefik version to v3.3.5 Copy linkLink copied to clipboard!
Traefik version used by the operator has been updated to the v.3.3.5 version. More details about the new version are available in the official Traefik release notes.
Additional resources
2.3. Update to Fabric8 Kubernetes Client 7.1.0 Copy linkLink copied to clipboard!
Fabric8 Kubernetes Client used in the che-server component has been updated to the latest 7.1.0version. More details about the new version are available in the official Fabric8 Kubernetes Client release notes.
Additional resources
2.4. Hide deprecated IntelliJ IDEA Community edition from the dashboard by default Copy linkLink copied to clipboard!
By default, the deprecated Projector-based IntelliJ IDEA Community edition is hidden on the User Dashboard from this release on, and will be completely removed in future releases. To enable the deprecated editor on the User Dashboard in the current version, use the dedicated environment variable CHE_SHOW_DEPRECATED_EDITORS in the Custom Resource:
spec:
components:
dashboard:
deployment:
containers:
- env:
- name: CHE_SHOW_DEPRECATED_EDITORS
value: true
Additional resources
2.5. Allow to provide a URL parameter filter on Dashboard Copy linkLink copied to clipboard!
With this release, you can add an optional filter URL parameter on the Create Workspace page of the User Dashboard, and display only a portion of samples based on a particular technology e.g. Quarkus dashboard/#/create-workspace?filter=quarkus
Additional resources
2.6. Support creating CDEs by pointing directly to a devfile.yaml on GitHub Copy linkLink copied to clipboard!
Starting from this release, you can create a Cloud DeveloperEnvironment (CDE) by using a GitHub repository URL of a directory with a devfile, or a GitHub repository URL directly pointing to the devfile. Previously, you could only use URLs of the GitHub repository, branch, and tag, as well as raw devfile URLs to create a CDE.
The name of the devfile must be devfile.yaml or .devfile.yaml.
Additional resources
Chapter 3. Bug fixes Copy linkLink copied to clipboard!
3.1. Error when connecting to Ansible Lightspeed from Ansible extension Copy linkLink copied to clipboard!
Previously, there was a defect related to the connection to the Lightspeed service when you used the Ansible extension. Following error message would appear: "Error: invalid_request. Invalid redirect URI." This defect has been fixed in this release.
Additional resources
3.2. Post start events execute in alphabetic order rather than listed sequence, leading to potential confusion Copy linkLink copied to clipboard!
Previously, postStart commands were executed based on alphabetical order rather than the sequence in which they were listed in the devfile, leading to potential confusion, especially when a specific execution order is expected based on the listed sequence. Starting from this release, the execution happens in sequential order in the way the commands are listed in the postStart section of a devfile:
postStart:
- command-one
- command-two
- command-three
Additional resources
3.3. Setting disableWorkspaceCaBundleMount: true doesn’t stop mounting certificates into /etc/pki/ca-trust/extracted/pem/ dir Copy linkLink copied to clipboard!
Previously, setting disableWorkspaceCaBundleMount: true property in the Custom Resource (CR) did not stop mounting certificates into /etc/pki/ca-trust/extracted/pem/ directory. The defect has been fixed in this release.
Additional resources
3.4. Workspace is not deleted when another workspace is running in the same user namespace Copy linkLink copied to clipboard!
Previously, when you deleted a workspace while using the per-user PVC strategy, the workspace might not have been deleted correctly if another workspace was running. In this release, a warning message will appear in such situations with a suggestion to stop running workspaces before you delete any.
Additional resources
3.5. Error redirect page when accepting OAuth2 factory on Bitbucket server Copy linkLink copied to clipboard!
Previously, when accepting Bitbucket server’s OAuth2 prompt, there was an unexpected error redirect page with the error stack trace: {"message":"Cannot invoke \"String.length()\" because \"this.input\" is null","trace"}. The defect has been fixed in this release.
Additional resources
3.6. Setting controller.devfile.io/storage-type attribute to ephemeral in devfile doesn’t use ephemeral storage Copy linkLink copied to clipboard!
The regression related to the controller.devfile.io/storage-type: ephemeral attribute has been fixed in this release, and Cloud Development Environments (CDEs) created from devfiles with this attribute now correctly use the emptyDir volumes.
Additional resources
3.7. Git history wiped out after workspace pod crash Copy linkLink copied to clipboard!
Previously, there was a defect related to the loss of all Git history if a workspace pod was restarted with a default devfile when the persistent storage strategy specified in the CheCluster was per-workspace. The defect has been fixed in this release.
Additional resources
3.8. Workspaces created with ubi9-based image failed to start with JetBrains IntelliJ IDEA (desktop) Copy linkLink copied to clipboard!
Before this release, it was not possible to use the desktop version of the JetBrains IntelliJ IDEA to connect to a workspace with a ubi9-based image over the JetBrains Gateway application. This defect has been fixed with this release.
To use JetBrains Getaway successfully with ubi9-based images, make sure you meet the following requirements:
- JetBrains Gateway application version 2025.x is installed.
- Dev Workspaces Gateway plugin version 0.0.10 is installed.
Additional resources
Chapter 4. Technology Preview Copy linkLink copied to clipboard!
Technology Preview features provide early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process. However, these features are not fully supported under Red Hat Subscription Level Agreements, may not be functionally complete, and are not intended for production use. As Red Hat considers making future iterations of Technology Preview features generally available, we will attempt to resolve any issues that customers experience when using these features. See: Technology Preview support scope.
None.
Chapter 5. Deprecated functionalities Copy linkLink copied to clipboard!
None.
Chapter 6. Removed functionalities Copy linkLink copied to clipboard!
None.
Chapter 7. Known issues Copy linkLink copied to clipboard!
7.1. Error when starting a workspace in Dev Spaces deployed to OpenShift Platform 4.18 Copy linkLink copied to clipboard!
There is a known issue affecting workspaces in Dev Spaces deployed to OpenShift Platform 4.18. When you start the workspace, the following error message appears: "Error creating DevWorkspace deployment: Container tools has state ImagePullBackOff".
Workaround
- Restart the workspace.
Additional resources
7.2. Workspaces using JetBrains IDEs ignore idling timeouts Copy linkLink copied to clipboard!
There is a known issue with the desktop versions of JetBrains IDEs. Workspaces using these IDEs ignore idling timeouts specified by CheCluster properties such as secondsOfRunBeforeIdling, and secondsOfInactivityBeforeIdling. There is currently no workaround available.
Additional resources
7.3. JetBrains editors cause workspace startup failure on IBM Power and IBM Z Copy linkLink copied to clipboard!
There is currently a known issue affecting the use of the desktop versions of JetBrains IDEs with IBM Power, and IBM Z architectures. The downloaded JetBrains IDE binaries are not multi-arch, causing workspace startup to fail. There is currently no workaround available.
Additional resources
7.4. Error when re-opening a running workspace in JetBrains IntelliJ IDEA (desktop) Copy linkLink copied to clipboard!
There is currently a known issue affecting workspaces running in the desktop version of JetBrains IntelliJ IDEA. If you close the IDE while the workspace is still running, you will receive the following error messages after re-opening the IDE: "There was an error in the connection provider", and "No connection handle was returned". There are multiple workarounds available.
Workaround
- Open the workspace locally using the JetBrains Gateway plugin for Dev Spaces.
- Restart the workspace.
- Restart the computer.
Additional resources
7.5. Non-admin users can’t fetch list of workspaces with the JetBrains Gateway plugin Copy linkLink copied to clipboard!
There is currently a known issue affecting workspaces created by non-admin users and the JetBrains Gateway plugin. If you create workspaces in Dev Spaces as a non-admin user and use the same account to access Dev Spaces locally on your computer through the JetBrains Getaway plugin, the fetched list of workspaces will be empty. There is currently no workaround available.
Additional resources
7.6. Workspaces using JetBrains IntelliJ IDEA editor fail to start in air-gapped environment Copy linkLink copied to clipboard!
There’s currently a known issue affecting workspaces using JetBrains Intellij IDEA in an air-gapped environment. If you choose JetBrains IntelliJ IDEA as your editor and try starting a workspace, the workspace startup will fail. A workaround is available.
Workaround
-
Whitelist JetBrains editor binary CDN host
download-cdn.jetbrains.com.
Additional resources
7.7. Refresh token mode causes cyclic reload of the workspace start page Copy linkLink copied to clipboard!
There is a known issue when experimental refresh token mode is applied using the CHE_FORCE_REFRESH_PERSONAL_ACCESS_TOKEN property for the GitHub and Microsoft Azure DevOps OAuth providers. This causes the workspace starts to reload the dashboard cyclically, creating a new personal access token on each page restart. The refresh token mode works correctly for 'GitLab' and 'BitBucket' OAuth providers.
Additional resources
Chapter 8. Frequently asked questions Copy linkLink copied to clipboard!
- Is it possible to deploy applications from OpenShift Dev Spaces to an OpenShift cluster?
- OpenShift user token is automatically injected into workspace containers which makes it possible to run oc CLI commands against OpenShift cluster.
- For best performance, what is the recommended storage to use for Persistent Volumes used with OpenShift Dev Spaces?
- Use block storage.
- Is it possible to deploy more than one OpenShift Dev Spaces instance on the same cluster?
- Only one OpenShift Dev Spaces instance can be deployed per cluster.
- Is it possible to install OpenShift Dev Spaces offline (that is, disconnected from the internet)?
- See Installing Red Hat OpenShift Dev Spaces in restricted environments on OpenShift.
- Is it possible to use non-default certificates with OpenShift Dev Spaces?
- You can use self-signed or public certificates. See Importing untrusted TLS certificates.
- Is it possible to run multiple workspaces simultaneously?
- See Enabling users to run multiple workspaces simultaneously.