Deploying CodeReady Workspaces on the IBM Cloud

This short article describes how to deploy CodeReady Workspaces on OpenShift on IBM Cloud. The deployment is pretty straight forward with one exception which is explained below. Knowing this trick can save you some time and it makes the first time experience more enjoyable.

As stated on the home page, Red Hat CodeReady Workspaces is a collaborative Kubernetes-native development solution that delivers OpenShift workspaces and in-browser IDE for rapid cloud application development.

Most of the instructions below can be used for all OpenShift installations, for example for CodeReady Containers to run OpenShift locally. The mentioned trick is only necessary for the IBM Cloud.

To get started, create an IBM Cloud account and create an OpenShift cluster as described in the documentation.

Once your cluster has been provisioned, open the OpenShift Web Console and create a new project.

Give your project a name, for example ‘codereadyworkspaces’.

On the operator hub page find the operator ‘Red Hat CodeReady Workspaces’.

Click ‘Install’.

Make sure your project is selected and click ‘Subscribe’.

Wait until the status is ‘Succeeded’, then open the operator. This shouldn’t take longer than 1-2 minutes.

On the ‘CodeReady Workspaces Cluster’ tab click on ‘Create CheCluster’.

Keep all defaults and click ‘Create’.

The creation of the cluster takes some time. In my case on the IBM Cloud roughly five minutes. For some reason the status on the page below stayed ‘Unknown’ even long after five minutes. Simply ignore it and open the cluster.

Instead check for the status on the next page. Once the cluster will be ready, you’ll see the URL in the right column.

When you open the Workspaces URL for the first time, you need to grant permisssions.

The next dialog is the confusing part. DO NOT simply use the default name of your user. It contains special characters which will lead to issues later. This name will be used as Kubernetes namespace name which does not accept special characters.

Instead use plain text for your user name.

That’s it! You’ve successfully installed CodeReady Workspaces. Have fun.