Release notes and known issues
Release notes and known issues for Red Hat OpenShift Dev Spaces 3.5
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 is a web-based integrated development environment (IDE). OpenShift Dev Spaces runs in OpenShift and is well-suited for container-based development.
OpenShift Dev Spaces 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 OpenShift Dev Spaces 3.5 is based on Eclipse Che 7.60.
1.1. Supported platforms Copy linkLink copied to clipboard!
OpenShift Dev Spaces runs on OpenShift 4.10–4.12 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.5, Red Hat will provide support for deployment, configuration, and use of the product.
Additional resources
1.3. Differences between Eclipse Che and Red Hat OpenShift Dev Spaces Copy linkLink copied to clipboard!
The main differences between OpenShift Dev Spaces and Eclipse Che are:
- OpenShift Dev Spaces is built on RHEL8 to ensure the latest security fixes are included, compared to Alpine distributions that take a longer time to update.
- OpenShift Dev Spaces uses OpenShift OAuth for user login and management.
- OpenShift Dev Spaces provides a smaller supported subset of plug-ins compared to Che.
- OpenShift Dev Spaces provides devfiles for working with other Red Hat technologies such as JBoss EAP and Fuse.
- OpenShift Dev Spaces is supported on OpenShift Container Platform, OpenShift Dedicated, and Red Hat OpenShift Service on AWS (ROSA); Eclipse Che can also run on other Kubernetes clusters.
Red Hat provides licensing, packaging, and support. Therefore, OpenShift Dev Spaces is considered a more stable product than the upstream Eclipse Che project.
Chapter 2. New features and enhancements Copy linkLink copied to clipboard!
2.1. Configuring remotes using a factory URL Copy linkLink copied to clipboard!
With this update, you can configure the Git remotes of a new workspace created by using the factory URL. The remotes query parameter can be set to a comma-separated list of Git remotes, with an optional name for each.
Additional resources
2.2. Limiting the number of workspaces per user Copy linkLink copied to clipboard!
With this update, administrators can set a limit on the total number of workspaces, and running workspaces per user by using the following parameters in the CheCluster Custom Resource:
-
spec.devEnvironments.maxNumberOfWorkspacesPerUser -
spec.devEnvironments.maxNumberOfRunningWorkspacesPerUser
For example:
spec:
devEnvironments:
maxNumberOfWorkspacesPerUser: 5
maxNumberOfRunningWorkspacesPerUser: 2
spec:
devEnvironments:
maxNumberOfWorkspacesPerUser: 5
maxNumberOfRunningWorkspacesPerUser: 2
Additional resources
2.3. Git Services tab in the dashboard User Preferences page Copy linkLink copied to clipboard!
With this update, a Git Services tab is added to the User Preferences page in the dashboard. This tab lists the Git providers that you as a user have granted access to. Supported Git providers are GitHub (github.com and Enterprise), GitLab (SaaS and Server), Bitbucket (Cloud and Server), and Microsoft Azure Repos.
You can revoke access for GitHub through the menu in the Git Services tab. This feature isn’t available for other Git providers.
Additional resources
2.4. Installation of pre-release versions of OpenShift Dev Spaces Copy linkLink copied to clipboard!
With this update, administrators can run dsc server:deploy --olm-channel=… to install unreleased and unsupported versions of OpenShift Dev Spaces from the release candidate (latest) channel or the CI build (next) channel.
Additional resources
2.5. GUI improvement in the default IDE for when a workspace stops Copy linkLink copied to clipboard!
This enhancement improves the GUI of the OpenShift Dev Spaces build of Microsoft Visual Studio Code - Open Source for stopped workspaces. A new dialog notifies the user that the workspace has stopped and displays the cause. The dialog offers the user two buttons: return to the dashboard or restart the workspace.
Additional resources
2.6. Support for Microsoft Azure Repos of Microsoft Azure DevOps Services Copy linkLink copied to clipboard!
With this update, users can start workspaces from public and private Git repositories hosted on Microsoft Azure Repos. Git repository maintainers can include devfiles in Git repositories that are hosted on Microsoft Azure Repos. Administrators can configure OAuth 2.0 for Microsoft Azure DevOps Services. Where OAuth configuration by an administrator is not permitted, users can use Microsoft Azure DevOps Services tokens as a workaround. This update adds Microsoft Azure Repos to the range of Git providers that OpenShift Dev Spaces already supports, including GitHub (github.com and Enterprise), GitLab (SaaS and Server), and Bitbucket (Cloud and Server).
Additional resources
2.7. Selecting the ephemeral storage strategy in CheCluster Copy linkLink copied to clipboard!
With this update, administrators can set devEnvironments.storage.pvcStrategy: ephemeral in the CheCluster Custom Resource as the default storage strategy for new workspaces of all users. This setting does not affect users' existing workspaces.
Users can select the ephemeral storage strategy per workspace through the storage-type setting in the dashboard.
Additional resources
2.8. Dev Workspace Operator accepts devfile volume sizes for per-workspace storage strategy Copy linkLink copied to clipboard!
With this update, Dev Workspace Operator accepts the volume size specified in the devfile volume when the persistent volume (PV) is created per-workspace. The PV size is determined by summing the size of all devfile volumes. When the PV is created per-user, the volume size is ignored.
Additional resources
2.9. Specifying workspace startup timeout Copy linkLink copied to clipboard!
With this update, administrators can specify the workspace startup timeout in the CheCluster Custom Resource by entering a value for spec.devEnvironments.startTimeoutSeconds.
Additional resources
2.10. Changing workspace pod scheduler in the CheCluster Custom Resource Copy linkLink copied to clipboard!
With this update, administrators can replace the default OpenShift scheduler of a workspace pod with an alternative scheduler by configuring the spec.devEnvironments.podSchedulerName value in the CheCluster Custom Resource. The alternative scheduler is applied to all newly started workspaces.
Additional resources
Chapter 3. Bug fixes Copy linkLink copied to clipboard!
3.1. Fixed workspace creation from a public repository on GitLab server instances without OAuth Copy linkLink copied to clipboard!
Before this update, the creation of a workspace from a public repository hosted on a GitLab server instance without configured OAuth was failing. With this update, the issue is fixed.
Additional resources
3.2. Creating a workspace from a devfile with Kubernetes and Openshift components Copy linkLink copied to clipboard!
Before this update, there was an issue affecting devfiles with Kubernetes and OpenShift components that caused workspace creation to fail. With this update, the issue is fixed.
Additional resources
3.3. Fixed RBAC checks for Kubernetes and Openshift components specified in devfiles Copy linkLink copied to clipboard!
Before this update, workspaces failed with devfiles that had components of type Kubernetes and OpenShift due to misconfigured Subject Access Review tests by the Dev Workspace Operator. With this update, the issue has been resolved.
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!
5.1. Deprecation of the Eclipse Theia editor in workspaces Copy linkLink copied to clipboard!
In OpenShift Dev Spaces 3.5, use of the Eclipse Theia editor in workspaces is deprecated. Red Hat will provide limited bug fixes and support for Eclipse Theia in OpenShift Dev Spaces during the current release lifecycle. Eclipse Theia will no longer receive enhancements for OpenShift Dev Spaces and will be removed from OpenShift Dev Spaces in the next release.
Microsoft Visual Studio Code - Open Source is the default editor with air gap support.
Additional resources
Chapter 6. Removed functionalities Copy linkLink copied to clipboard!
None.
Chapter 7. Known issues Copy linkLink copied to clipboard!
7.1. Upgrading OpenShift Dev Spaces from 3.5 to 3.6 might require manual steps Copy linkLink copied to clipboard!
There is a known issue when updating to version 3.6: clusters that were updated to devspacesoperator.v3.5.0-0.1682130576.p require additional steps from administrators as a workaround.
Workaround
- Go to the OpenShift web console.
Delete your existing Red Hat OpenShift Dev Spaces Operator subscription and the
devspacesCSV.NoteThis does not remove any of the deployed pods or running workspaces.
- Install the latest Red Hat OpenShift Dev Spaces Operator subscription.
- Wait until all pods are replaced by new ones before opening the dashboard or loading workspaces.
Alternatively, you can use the oc command-line tool.
Additional resources
7.2. Duplicate workspaces cannot be created after upgrading from OpenShift Dev Spaces 3.4 Copy linkLink copied to clipboard!
Currently, users are unable to create multiple workspaces from the same dashboard sample or Git repository URL after upgrading OpenShift Dev Spaces from version 3.4.
Administrators must ask users before the upgrade to push their latest workspace changes to their Git repositories and to be prepared to delete and recreate workspaces after the upgrade.
Workaround
Use a relevant option:
-
Update your devfile with
generateNamerather thanfixedNameto have a unique name generated for each new workspace. - Delete any previous workspaces from the same sample or Git repository before creating a new one.
Additional resources
7.3. Incorrect user name and email in commit messages for some users Copy linkLink copied to clipboard!
There is currently a known issue for users who are using a Kubernetes Secret with their Git-provider credentials. The user name and email for Git operations in worspaces for those users are currently taken from the user-profile Secret of the <user>-devspaces namespace.
This known issue does not impact Git-provider OAuth that has been configured by administrators.
Workaround
In the editor terminal of the running workspace, run the following commands to set your commit author name and email:
git commit config --global user.name <your_name> git commit config --global user.email <your_email>
git commit config --global user.name <your_name> git commit config --global user.email <your_email>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional resources
7.4. 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 that is available from the following sources:
Additional resources
7.5. New workspaces based on Bitbucket.org-hosted repositories fail to start without a v2 devfile Copy linkLink copied to clipboard!
Currently, new workspaces based on a Bitbucket.org-hosted repository fail to start if the repository contains no devfile or a v1 devfile. The result is the Failed to create the workspace error message.
Workaround
- If the repository does not contain a devfile, add a v2.1 devfile to the repository.
- If the repository contains a v1 devfile, migrate the devfile from v1 to v2.1. See https://devfile.io/docs/2.1.0/migrating-to-devfile-v2.
Additional resources
Chapter 8. Frequently asked questions Copy linkLink copied to clipboard!
- Is it possible to deploy applications to an OpenShift cluster from OpenShift Dev Spaces?
-
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.