Release notes and known issues
Release notes and known issues for Red Hat OpenShift Dev Spaces 3.26
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, and JetBrains desktop IntelliJ IDEA Ultimate, PyCharm, WebStorm, RubyMine, CLion, GoLand, PhpStorm, and Rider editors.
- 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.26 is based on Eclipse Che 7.113.
1.1. Supported platforms Copy linkLink copied to clipboard!
OpenShift Dev Spaces runs on OpenShift 4.15–4.21 on the following CPU architectures:
-
AMD64 and Intel 64 (
x86_64) -
IBM Z (
s390x) -
IBM Power (
ppc64le) -
ARMv8 (
arm64)
Additional resources
1.2. Support policy Copy linkLink copied to clipboard!
For Red Hat OpenShift Dev Spaces 3.26, 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. Improved editor grouping and sorting on the user dashboard Copy linkLink copied to clipboard!
With this release, the Choose an Editor view on the user dashboard is improved. Editors are now neatly grouped and sorted to provide better usability and a more organized selection process.
This update ensures that you can quickly find and select your preferred development environment from the available grouped options.
Additional resources
2.2. Enforcing container memory and CPU caps for workspace pods Copy linkLink copied to clipboard!
With this release, you can set maximum resource limits and requests for workspace containers by using the spec.DevWorkspace.containerResourceCaps field in the CheCluster custom resource (CR). This update ensures that you do not create workspaces with excessive CPU or memory requirements at the devfile level.
Additional resources
2.3. Workspace renaming is available from the Overview tab Copy linkLink copied to clipboard!
With this release, you can rename your workspaces directly from the Overview tab in the dashboard. This update introduces a consistent user experience by using a new reusable copy-to-clipboard component.
You can edit a workspace name when the workspace is in the Stopped or Failed state. The dashboard validates new names for length, naming patterns, and duplicates to ensure accuracy before you save your changes.
Additional resources
2.4. Improved PVC full error handling Copy linkLink copied to clipboard!
With this release, per-user storage error handling is improved through new persistent volume claim (PVC) error detection and guided recovery steps. If a workspace fails to start because the PVC storage is full, you see a clear error message that identifies the workspace name and the root cause.
The guided recovery provides a direct link to the OpenShift Console PVC management view and a YAML snippet to help you expand the PVC manually. These steps ensure that you can resolve storage issues quickly to restart your workspace.
Additional resources
2.5. che-code editor now based on VS Code version 1.104.3 Copy linkLink copied to clipboard!
The che-code editor, which is based on Visual Studio Code - Open Source (Code - OSS), is now updated to version 1.104.3.
For more infomation, see link"https://code.visualstudio.com/updates/v1_104[VS Code release notes].
Additional resources
2.6. Improved connection instructions for VS Code (SSHD) Copy linkLink copied to clipboard!
With this release, the landing page for connecting to a workspace by using VS Code (SSHD) is improved. The update enhances the presentation with better styling and adds copy-to-clipboard functionality for commands and configuration snippets.
The landing page now includes direct links for required tools and authentication. Additionally, the instructions provide guidance for Windows users where applicable, ensuring a smoother connection process across different operating systems.
Additional resources
2.7. DevWorkspace Operator is updated to version 0.39.0 Copy linkLink copied to clipboard!
The DevWorkspace Operator component is updated to version 0.39.0. This version provides important fixes and enhancements to Dev Spaces.
For more information, see the DevWorkspace Operator changelog.
Additional resources
2.8. Improved clarity for IDE binary download messages Copy linkLink copied to clipboard!
With this release, the Downloading IDE binaries… (it can take a few minutes) message is displayed only when it is relevant.
This message no longer appears on the Starting workspace page for the default VS Code editor. This update ensures that you receive accurate information about the workspace startup process and avoids unnecessary confusion.
Additional resources
Chapter 3. Bug fixes Copy linkLink copied to clipboard!
3.1. Updated branding for better user experience Copy linkLink copied to clipboard!
With this release, custom logo rendering on the user dashboard is improved. This update resolves an issue where base64-encoded images appeared blurry and ensures that images remain sharp on the loading page.
The dashboard now supports multiple image formats, including JPG, PNG, GIF, WebP, and SVG. Additionally, this update introduces dynamic loader image selection and includes a "Loading…" fallback for SVG files to ensure a smooth visual experience.
Additional resources
3.2. Resolved project cloning failure for custom samples with SSH URLs Copy linkLink copied to clipboard!
An issue is resolved where project cloning failed when you defined custom getting-started samples by using an SSH URL for the Git repository. Previously, attempting to launch a custom sample with an SSH URL resulted in a 403 error during the cloning process.
With this fix, you can successfully launch custom samples that use SSH URLs. This update ensures a consistent workspace creation flow when you use custom sample configurations.
Additional resources
3.3. Improved authorization error message Copy linkLink copied to clipboard!
Before this update, advanced authorization errors displayed an unhelpful "Error [object Object]" message. As a consequence, users could not determine the cause of authorization failures. With this release, the proper authorization error message is displayed. As a result, you receive clear and actionable information about authorization issues.
Additional resources
3.4. Resolved Save button behavior in user preferences Copy linkLink copied to clipboard!
An issue is resolved where the Save button was not correctly disabled in the User Preferences section of the dashboard. When Git configuration settings are already applied, the Save button is now correctly disabled.
This fix ensures consistent dashboard behavior when you refresh the page or switch between different preference tabs.
Additional resources
3.5. Close and Stop button correctly stops active workspaces Copy linkLink copied to clipboard!
Before this update, the Close and Stop button did not always stop the active Dev Workspace. As a consequence, workspaces could continue running after the IDE was closed. With this release, the button behavior is corrected to ensure proper workspace termination. As a result, closing the IDE reliably stops the associated workspace.
Additional resources
3.6. Tools running in terminals prevent workspace idle termination Copy linkLink copied to clipboard!
Before this update, long-running tasks in terminals did not prevent workspace idle termination. As a consequence, workspaces could shut down while important processes were still executing. With this release, tools running in terminals are properly detected and prevent workspace idling. As a result, long-running terminal tasks complete without interruption.
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.
4.1. Kiro SSH local-to-remote support Copy linkLink copied to clipboard!
Red Hat OpenShift Dev Spaces now includes native support for the Kiro editor as a local-to-remote SSH IDE. This update introduces a dedicated editor definition tile in the dashboard, allowing you to connect a local Kiro desktop application directly to running workspaces.
Known issues
The Kiro desktop application (version 0.8.206) might encounter a connection error after you sign in with a Google account. The error message indicates "Too many authentication failures," and logs show that all configured authentication methods failed.
-
For authentication failures, check the SSHD logs at
/tmp/sshd.logwithin the DevWorkspace development container.
Workaround
Sign in to the Kiro desktop application by using an AWS Builder ID instead of a Google account.
Connecting to a remote workspace by using a local Kiro (desktop) editor is a Technology Preview feature only. 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 more information about the support scope of Red Hat Technology Preview features, see the Technology Preview Features Support Scope documentation.
Additional resources
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. Incompatibility with OpenShift BYO External Authentication Copy linkLink copied to clipboard!
The Red Hat OpenShift Dev Spaces Operator does not currently support OpenShift clusters configured with Bring Your Own (BYO) External Authentication.
Dev Spaces currently relies on the built-in OpenShift OAuth server. Configurations that replace the built-in OAuth server with external corporate OIDC Identity Providers (IdPs) are not supported in this release.
Additional resources
7.2. Workspaces using Visual Studio Code (desktop) editor ignores idling timeouts Copy linkLink copied to clipboard!
There is a known issue with the desktop version of Visual Studio Code editor. Workspaces using these editor ignore idling timeouts specified by CheCluster properties such as secondsOfRunBeforeIdling and secondsOfInactivityBeforeIdling. There is currently no workaround available.
Additional resources
7.3. "504 Gateway Time-out" error Copy linkLink copied to clipboard!
There is a known issue affecting the use of IntelliJ IDEA Ultimate IDE on the arm64 architecture. When you start a workspace in the IDE, the following error message appears: "504 Gateway Time-out". There is no workaround available.
Additional resources
7.4. "PostStartHook failed" error Copy linkLink copied to clipboard!
There is a known issue with using the Ansible sample on the `arm64`architecture. The Ansible sample fails to start and the following error message appears: "Error creating DevWorkspace deployment: Detected unrecoverable event FailedPostStartHook: PostStartHook failed." There is no workaround available.
Additional resources
7.5. .NET sample fails to start on arm64 architecture Copy linkLink copied to clipboard!
There is a known issue where the .NET sample fails to start on the arm64 architecture because there is no quay.io/devspaces/dotnet-90 image available for arm64. There is no workaround available.
Additional resources
7.6. 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.7. 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.8. 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.
- Is it possible to configure OpenShift Dev Spaces to use open-vsx.org?
Yes, but this is not the default configuration. While you can connect to the public Open VSX Registry, consider these factors:
- Service limits: API usage is organized into defined tiers. The Eclipse Foundation implements these limits to protect infrastructure from high-frequency automated traffic and to provide consistent service quality for all users. For more information, see Rate Limits and Usage Tiers and the open-vsx.org wiki.
Security and stability: The public registry does not have an official service-level agreement (SLA) and poses potential security risks from unvetted extensions.
For a secure, stable, and high-performance environment, use a self-hosted registry with a curated set of extensions that meet your organization's requirements.
For a secure, stable, and high-performance environment, use a self-hosted registry with a curated set of extensions that meet your organization's requirements.Copy to Clipboard Copied! Toggle word wrap Toggle overflow