This documentation is for a release that is no longer maintained
See documentation for the latest supported version.Release notes and known issues
Release notes and known issues for Red Hat OpenShift Dev Spaces 3.10
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 IntelliJ IDEA Community (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.10 is based on Eclipse Che 7.77.
1.1. Supported platforms Copy linkLink copied to clipboard!
OpenShift Dev Spaces runs on OpenShift 4.12–4.14 on the following CPU architectures:
-
AMD64 and Intel 64 (
x86_64) -
IBM Power (
ppc64le) and IBM Z (s390x)
Additional resources
1.2. Support policy Copy linkLink copied to clipboard!
For Red Hat OpenShift Dev Spaces 3.10, 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 devfiles for working with languages and technologies such as Quarkus, Lombok, NodeJS, Python, DotNet, Golang, C/C++, and PHP. You can find the latest sample projects in the devspaces-devfileregistry container image sources.
- 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. GitHub Device Authentication support for extensions in Microsoft Visual Studio Code - Open Source Copy linkLink copied to clipboard!
With this release, you can use GitHub Device Authentication in Microsoft Visual Studio Code - Open Source to activate extensions. For more information about this feature, check GitHub device activation flow.
The GitHub Copilot extension can now be activated using GitHub Device Authentication. To activate it, follow these steps:
- Authenticate to GitHub using the new "Device Authentication" command.
- Install the GitHub Copilot extension by uploading the VSIX file. You must repeat the upload for every new workspace.
The GitHub Copilot VSIX file is currently only available on the Visual Studio Marketplace. Before using the file, verify that you are complying with Visual Studio Marketplace terms of use and GitHub Copilot license.
Additional resources
2.2. Simultaneous configuration of OAuth for GitHub Enterprise Server and GitHub SaaS Copy linkLink copied to clipboard!
With this release, you can configure the OAuth flow for GitHub Enterprise Server and GitHub SaaS simultaneously. More details about this feature can be found in this demo video.
Additional resources
2.3. Default protocol for routes generated for Microsoft Visual Studio Code - Open Source editor Copy linkLink copied to clipboard!
With this release, routes generated for the Microsoft Visual Studio Code - Open Source editor use HTTPS protocol by default.
Additional resources
2.4. Configuring .gitconfig user name and email from the User Dashboard Copy linkLink copied to clipboard!
With this release, you can use the User Dashboard to configure the user name and email that will be used in the workspace '.gitconfig' settings.
Additional resources
2.5. Improved "Backend is not available" error message Copy linkLink copied to clipboard!
Before this release, backend issues resulted in a generic "Backend is not available" error message displayed on the User Dashboard. With this update, the error includes the HTTP error code and the affected endpoint.
Additional resources
2.6. Automatic Dashboard redirection after stopping a workspace from Microsoft Visual Studio Code - Open Source Copy linkLink copied to clipboard!
With this release, when you stop a workspace from the Microsoft Visual Studio Code - Open Source editor, you are automatically redirected to the User Dashboard.
Additional resources
2.7. Enhanced OAuth integration when a user does not grant permissions Copy linkLink copied to clipboard!
With this release, if you reject an SCM provider authorization request while creating or starting an existing workspace, your choice is saved in the workspace-preferences config-map in the namespace. During the subsequent workspaces startups, the prompt to proceed with the OAuth authorization for the rejected SCM provider no longer appears.
Additional resources
2.8. Support for devfile API events.preStop Copy linkLink copied to clipboard!
With this release, you can specify preStop events in the devfile that will be executed before stopping the workspace. Similar to postStart, multiple devfile commands can be specified as preStop:
events:
preStop:
- first-command
- second-command
- third-command
events:
preStop:
- first-command
- second-command
- third-command
Additional resources
2.9. SSH key configuration from the User Dashboard Copy linkLink copied to clipboard!
With this release, you can configure your SSH key from the User Dashboard.
Additional resources
Chapter 3. Bug fixes Copy linkLink copied to clipboard!
3.1. Enabling persistence of home directory breaks Universal Developer Image home directory, PATH, and environment variables Copy linkLink copied to clipboard!
Before this update, enabling the persistence of the home directory broke the Universal Developer image home directory, PATH, and environment variables. With this update, this issue is fixed.
Additional resources
3.2. "No PersonalAccessTokenFetcher configured" error message appears in re-opened workspaces Copy linkLink copied to clipboard!
Before this update, re-opening an existing workspace resulted in a "No PersonalAccessTokenFetcher configured" error message. With this update, the token is refreshed on a workspace restart.
Additional resources
3.3. Workspace start error after rejecting SCM authorization Copy linkLink copied to clipboard!
Before this update, rejecting SCM authorization led to an error appearing at workspace start. With this update, the workspace starts correctly.
If you reject the authorization, you can not use git push in the workspace without an additional setup.
Additional resources
3.4. "Unauthorized" error message when opening the IDE Copy linkLink copied to clipboard!
Before this update, an "Unauthorized" error message would occasionally appear at the 'Open IDE" phase of the workspace start. With this update, the issue is fixed.
Additional resources
3.5. "Bearer Token Authorization" errors from the Dashboard Copy linkLink copied to clipboard!
Before this update, the "Bearer Token Authorization" error would occasionally appear in the dashboard. With this update, retry request implementation solves the issue.
Additional resources
3.6. Starting Microsoft Azure DevOps Git repositories with white space characters in the URL Copy linkLink copied to clipboard!
Before this update, it was not possible to start a workspace based on the Microsoft Azure DevOps Git repositories with white space characters in the URL. With this update, the issue is fixed.
Additional resources
3.7. Builds failing due to missing common tooling config directories in UDI Copy linkLink copied to clipboard!
Before this update, builds would fail because of missing common tooling config directories. With this update, the following directories are pre-created in the default UDI with the correct permissions allowing users to write into them from the workspace:
-
Maven:
/home/user/.m2/ -
Pip:
/home/user/.config/pip/ -
Cargo:
/home/user/.cargo/ -
PHP:
/home/user/.composer/ -
.NET:
/home/user/.nuget
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. Microsoft Visual Studio Code - Open Source extensions not automatically installed Copy linkLink copied to clipboard!
There is a known issue where automatic installation of the recommended Microsoft Visual Studio Code - Open Source extensions fails if you’re using a Java or Ansible sample.
Workaround
- Refresh the workspace tab in the browser.
Additional resources
7.2. FIPS compliance update Copy linkLink copied to clipboard!
There’s a known issue with FIPS compliance that results in certain cryptographic modules not being FIPS-validated. Below is a list of requirements and limitations for using FIPS with OpenShift Dev Spaces:
Required cluster and operator updates
Update your Red Hat OpenShift Container Platform installation to the latest z-stream update for 4.11, 4.12, or 4.13 as appropriate. If you do not already have FIPS enabled, you will need to uninstall and reinstall.
Once the cluster is up and running, install OpenShift Dev Spaces 3.7.1 (3.7-264) and verify that the latest DevWorkspace operator bundle 0.21.2 (0.21-7) or newer is also installed and updated. See https://catalog.redhat.com/software/containers/devworkspace/devworkspace-operator-bundle/60ec9f48744684587e2186a3
Golang compiler in UDI image
The Universal Developer Image (UDI) container includes a golang compiler, which was built without the CGO_ENABLED=1 flag. The check-payload scanner ( https://github.com/openshift/check-payload ) will throw an error, but this can be safely ignored provided that anything you build with this compiler sets the correct flag CGO_ENABLED=1 and does NOT use extldflags -static or -tags no_openssl.
The resulting binaries can be scanned and should pass without error.
Statically linked binaries
You can find statically linked binaries not related to cryptography in these two containers:
- code-rhel8
- idea-rhel8.
As they are not related to cryptography, they do not affect FIPS compliance.
Helm support for FIPS
The UDI container includes the helm binary, which was not compiled with FIPS support. If you are in a FIPS environment do not use helm.
Additional resources
7.3. Debugger does not work in the .NET sample Copy linkLink copied to clipboard!
Currently, the debugger in Microsoft Visual Studio Code - Open Source does not work in the .NET sample.
Workaround
Use a different image from the following sources:
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?
-
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 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.