This documentation is for a release that is no longer maintained
See documentation for the latest supported version.Este conteúdo não está disponível no idioma selecionado.
Chapter 4. Known issues
4.1. Admin users must select the destination OpenShift project to deploy applications to OpenShift Copiar o linkLink copiado para a área de transferência!
Currently, the admin
users are unable to deploy applications from a Dev Spaces workspace to OpenShift because those users' default projects are not the same as the Dev Spaces workspace project. This problem affects all devfiles that project an example command to deployment the application to OpenShift, including Node JS or Red Hat Fuse. This problem does not affect non-administrative user accounts on OpenShift because such users only have access to one project, which is the default <username>-devspaces
namespace.
Workaround
-
Run the
oc project admin-devspaces
command as theadmin
user. -
Alternatively, use the environment variable and run
oc project $DEVWORKSPACE_NAMESPACE
to select the Dev Spaces namespace as theadmin
user.
Additional resources
4.2. Vert.x Health Check Example failing in restricted environments Copiar o linkLink copiado para a área de transferência!
Currently, deploying the Vert.x Health Check Example application by running the 6-deploy-to-openshift
command fails in disconnected environments. There is currently no workaround for this issue.
Additional resources
4.3. Private container images cannot be pulled from added container registries Copiar o linkLink copiado para a área de transferência!
Currently, pulling of a private container image fails when the image is pulled from a container registry that was added in the dashboard,
Workaround
Delete the
devworkspace-container-registry-dockercfg
Secret:oc delete secret devworkspace-container-registry-dockercfg -n <openshift-project>
$ oc delete secret devworkspace-container-registry-dockercfg -n <openshift-project>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create a new
devworkspace-container-registry-dockercfg
Secret:oc create secret docker-registry devworkspace-container-registry-dockercfg --docker-username=<username> --docker-password=<password> -n <openshift-project>
$ oc create secret docker-registry devworkspace-container-registry-dockercfg --docker-username=<username> --docker-password=<password> -n <openshift-project>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Edit the metadata of the new Secret:
labels: controller.devfile.io/devworkspace_pullsecret: 'true' controller.devfile.io/watch-secret: 'true'
labels: controller.devfile.io/devworkspace_pullsecret: 'true' controller.devfile.io/watch-secret: 'true'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional resources
4.4. Visual Studio Code on OpenShift with a self-signed TLS certificate Copiar o linkLink copiado para a área de transferência!
Currently, starting a workspace that uses the Technology Preview Visual Studio Code on OpenShift with a self-signed TLS certificate results in a blank browser tab.
Workaround
- Import the TLS certificate into the browser.
Additional resources
4.5. Workspace starting and deletion might fail Copiar o linkLink copiado para a área de transferência!
Currently, a workspace might fail to start, and then you might be unable to delete it. This is caused by a persistent volume claim (PVC) issue. Subsequently, the same problem occurs with other workspaces.
Workaround
-
Remove the
DevWorkspace
object of the first stuck workspace. - Remove the PVC that is bound to the invalid volume.
Additional resources
4.6. Conversion of CodeReady Workspaces Node.js workspaces with node-debug and node-debug2 plug-ins Copiar o linkLink copiado para a área de transferência!
Currently, using the Convert button in the OpenShift Dev Spaces dashboard to convert a Deprecated Node.js workspace with the node-debug
or node-debug2
plug-in fails. The following error message is displayed:
Workspace conversion failed. Failed to create a new workspace from the devfile, reason: Unable to resolve theia plugins ….
In OpenShift Dev Spaces 3.1, the node-debug
and node-debug2
plug-ins have been updated to js-debug
.
Workaround
-
Edit the devfile in the editor in the dashboard page. If the editor in the dashboard page is disabled, copy the devfile contents to a new
devfile.yaml
file. -
Edit your existing v1 devfile(s) to replace
ms-vscode/node-debug/latest
andms-vscode/node-debug2/latest
withms-vscode/js-debug/latest
. - Commit to a Git repository.
Start a new workspace from the edited devfile by using one of the following options:
The factory URL, using the
?new
URL parameter for starting a duplicate workspace:https://devspaces-<openshift_deployment_name>.<domain_name>#<git_repository_url>?new
https://devspaces-<openshift_deployment_name>.<domain_name>#<git_repository_url>?new
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Go to
.
Additional resources
4.7. Java Gradle sample fails in restricted environments Copiar o linkLink copiado para a área de transferência!
Currently, there is a known issue with the Java Gradle sample in restricted environments. Running the 1-build
command to build an application might result in the FAILURE: Build failed with an exception error and failure to load a native library or not resolving a plug-in artifact in plug-in repositories. This issue has no workaround.
Additional resources
4.8. Blank Welcome To Your Workspace page in Che-Theia workspaces Copiar o linkLink copiado para a área de transferência!
Currently, the Welcome To Your Workspace page in Che-Theia workspaces might appear blank when the workspace loads. This is caused by a missing self-signed TLS certificate in the browser.
Workaround
- If you use self-signed TLS certificates to connect over HTTPS to an OpenShift cluster running OpenShift Dev Spaces, import those certificates into your browser.
Additional resources
4.9. CheCluster custom resource retains its pre-upgrade name Copiar o linkLink copiado para a área de transferência!
Currently, the name of the CheCluster
custom resource remains the same as before upgrading from CodeReady Workspaces 2.15 to OpenShift Dev Spaces 3.1. Customers whose Checluster
custom resource name is codeready-workspaces
before the upgrade will find the same name after the upgrade. This issue has no workaround.
Additional resources
4.10. 502 Bad Gateway or application not available errors Copiar o linkLink copiado para a área de transferência!
When launching a sample application from the workspace, users can encounter an error message such as 502 Bad Gateway or application not available. The cause of this error is the Theia IDE displaying the notification that the application is ready before the application startup is complete.
Workaround: Wait a minute or two, and reload the browser tab.
See the related issue #21377.
Additional resources
4.11. Users cannot edit profile information in the dashboard Copiar o linkLink copiado para a área de transferência!
In CodeReady Workspaces 2.15, users were able to edit their profile information in the Account page of the dashboard. Because OpenShift OAuth is now used exclusively for user management in OpenShift Dev Spaces 3.1, users can only edit their user profile within OpenShift. The Account page in the dashboard remains for display purposes only.
Additional resources
4.12. Support for per-workspace storage strategy currently not available Copiar o linkLink copiado para a área de transferência!
Currently, the per-workspace
workspace storage strategy is not supported due to the change to the DevWorkspace engine. With migration from CodeReady Workspaces 2.15 to OpenShift Dev Spaces 3.1, existing workspaces change to the common
strategy. Setting the PVC storage size other than 10 GB is currently not possible. This issue has no workaround.
Additional resources
4.13. Error in the Cake-php sample project on IBM Power Copiar o linkLink copiado para a área de transferência!
When using the Cake-php
sample, the Configure Apache Web Server DocumentRoots
task fails with the following error: error sed: couldn’t open temporary file /etc/httpd/conf/sedSgv1Z4: Permission denied
. There is currently no workaround for this issue.
Additional resources
4.14. Upgrading a CodeReady Workspaces 2.15 instance with the DevWorkspace engine enabled (Technology Preview) Copiar o linkLink copiado para a área de transferência!
Upgrading a CodeReady Workspaces 2.15 instance with the DevWorkspace engine enabled (Technology Preview) is simpler than the upgrade procedure described in the Administration Guide.
Workaround
- Skip steps 1 and 2 in the upgrade procedure.
In step 5 of the upgrade procedure, use the following two values when setting the environment variables for the migration scripts:
-
export PRE_MIGRATION_PRODUCT_SUBSCRIPTION_NAME=codeready-workspaces2
rather than the documentedcodeready-workspaces
value -
export PRE_MIGRATION_PRODUCT_OPERATOR_NAMESPACE=openshift-operators
rather than the documentedopenshift-workspaces
value
-
-
In step 6 of the upgrade procedure, run only the
./3-subscribe.sh
and./4-wait.sh
scripts. Do not run./1-prepare.sh
and./2-migrate.sh
.
Support for deploying OpenShift Dev Spaces 3.1 with the DevWorkspace engine is available starting with OpenShift Container Platform 4.10. Administrators must upgrade clusters running earlier versions of OpenShift Container Platform to 4.10 or later before subscribing to and deploying OpenShift Dev Spaces.
Additional resources
4.15. OpenShift Connector plug-in does not allow the creation of a new component on IBM Power Copiar o linkLink copiado para a área de transferência!
On IBM Power, the list of supported image streams is missing, which causes component creation to fail. There is currently no workaround for this issue.
Additional resources
4.16. The DEBUG configuration is missing Copiar o linkLink copiado para a área de transferência!
The DEBUG panel displays No Configurations in the drop-down list because no configurations are loaded.
Workaround
- Refresh the page to display the debug configurations.
Additional resources
4.17. OpenShift Connector plug-in fails to deploy an application in a restricted environment Copiar o linkLink copiado para a área de transferência!
The OpenShift Connector plug-in fails to deploy because of the inability to access the odo
image in the disconnected environment. There is no workaround for this issue.
Additional resources
4.18. No display for a task after a networking issue Copiar o linkLink copiado para a área de transferência!
When a task is running and there is some networking issue, the terminal window is cleared and contains no text. Even when the connection is restored, the terminal remains empty and loading. There is no workaround for this issue.
Additional resources
4.19. No delegateCommandHandler error for Java with the JBoss EAP 7.3 devfile Copiar o linkLink copiado para a área de transferência!
A workspace using Java with the JBoss EAP 7.3 devfile fails with the following error message: No delegateCommandHandler for vscode.java.startDebugSession
. There is no workaround for this issue.
Additional resources
4.20. Unsupported devfiles on IBM Z and IBM Power Copiar o linkLink copiado para a área de transferência!
Currently, the following devfiles are not supported on IBM Z and IBM Power:
- .Net
- Apache Camel K by Red Hat
This issue has no workaround.
Additional resources
4.21. Workspace creation fails on unstable networks Copiar o linkLink copiado para a área de transferência!
OpenShift Dev Spaces might fail to create a workspace when the network is unstable. OpenShift Dev Spaces displays an error such as Failed to run the workspace: "Waiting for pod 'workspace9fbid1gnx7273d47.maven-545f8c9cf4-hw79f' was interrupted." This issue has no workaround.
Additional resources
4.22. Language server features are not preinstalled in Go workspaces Copiar o linkLink copiado para a área de transferência!
Currently, Golang-based workspaces do not include basic language server features such as code autocompletion.
Workaround
- Run the OpenShift Dev Spaces instance in a non-restricted environment.
- Install the required module by clicking Install in the IDE dialog box.
Additional resources
4.23. Debugging cannot be activated in Go workspaces on IBM Z and IBM Power Copiar o linkLink copiado para a área de transferência!
On IBM Z and IBM Power, the debugging features cannot be activated in the Go workspace in OpenShift Dev Spaces 3.1. Delve, the required debugger for the Go programming language, is not available for these platforms. Because the debugger doesn’t exist, attempting to use it results in a Failed to continue error message. This issue has no workaround.
Additional resources