Chapter 1. Installing CodeReady Workspaces on OpenShift Container Platform 4

1. Open the OpenShift web console.
2. In the left panel, navigate to Projects.
3. Click the Create Project button.

4. Enter the project details:

   • In the Name field, type codeready.
   • In the Display Name field, type Red Hat CodeReady Workspaces.
5. Click the Create button.

1. Open the OpenShift web console.
2. In the left panel, navigate to the Operators OperatorHub section.
3. In the Search by keyword field, type Red Hat CodeReady Workspaces.
4. Click on the Red Hat CodeReady Workspaces tile.
5. Click the Install button in the Red Hat CodeReady Workspaces pop-up window.
6. In the A specific namespace on the cluster field, in the cluster drop-down list, select the namespace into which the previous version of the CodeReady Workspaces Operator was installed.
7. Click the Subscribe button.
8. In the left panel, navigate to the Operators Installed Operators section.
9. Red Hat CodeReady Workspaces is displayed as an installed Operator having the InstallSucceeded status.
10. Click on the Red Hat CodeReady Workspaces name in the list of installed operators.
11. Navigate to the Overview tab.
12. In the Conditions sections at the bottom of the page, wait for this message: install strategy completed with no errors.
13. Navigate to the Events tab.
14. Wait for this message: install strategy completed with no errors.

1. Open the OpenShift web console.
2. Navigate to the Operators Installed Operators section.
3. Click Red Hat CodeReady Workspaces in the list of installed operators.
4. Click the Create Instance link in Provided APIs section.
5. The Create CodeReady Workspaces Cluster page is displayed.
6. Leave the default values as they are.
7. Click the Create button in the bottom-left corner of the window.

8. The codeready cluster is created.

   

Procedure

1. Open the OpenShift web console.
2. Navigate to the Operators Installed Operators section.
3. Click Red Hat CodeReady Workspaces in the list of installed operators.
4. Navigate to the CodeReady Workspaces Cluster tab.

5. Click codeready-workspaces CheCluster in the table.

   The Overview tab is displayed.

6. Watch the content of the Message field. The field contain error messages, if any. The expected content is None.

7. Navigate to the Resources tab.

   The screen displays the state of the resources assigned to the CodeReady Workspaces deployment.

   

Procedure

1. Open the OpenShift web console.
2. In the left panel, navigate to the Operators Installed Operators section.
3. Click the Red Hat CodeReady Workspaces Operator tile.

4. Click codeready-workspaces CheCluster in the table.

   The Overview tab is displayed.

5. Read the value of the CodeReady Workspaces URL field.

Procedure

1. Run the following commands to select the crw project:

   $ oc project <project_name>

2. Run the following commands to get the name and status of the Pods running in the selected project:

   $ oc get pods

3. Check that the status of all the Pods is Running.

   NAME                            READY     STATUS    RESTARTS   AGE
   codeready-8495f4946b-jrzdc            0/1       Running   0          86s
   codeready-operator-578765d954-99szc   1/1       Running   0          42m
   keycloak-74fbfb9654-g9vp5       1/1       Running   0          4m32s
   postgres-5d579c6847-w6wx5       1/1       Running   0          5m14s

4. To see the state of the CodeReady Workspaces cluster deployment, run:

   $ oc logs --tail=10 -f `oc get pods -o name | grep operator`

   Example output of the command:

   time="2019-07-12T09:48:29Z" level=info msg="Exec successfully completed"
   time="2019-07-12T09:48:29Z" level=info msg="Updating eclipse-che CR with status: provisioned with OpenShift identity provider: true"
   time="2019-07-12T09:48:29Z" level=info msg="Custom resource eclipse-che updated"
   time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: che"
   time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: custom"
   time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: Deployment, name: che"
   time="2019-07-12T09:48:30Z" level=info msg="Updating eclipse-che CR with status: CodeReady Workspaces API: Unavailable"
   time="2019-07-12T09:48:30Z" level=info msg="Custom resource eclipse-che updated"
   time="2019-07-12T09:48:30Z" level=info msg="Waiting for deployment che. Default timeout: 420 seconds"

Procedure

1. To retrieve the CodeReady Workspaces cluster URL from the checluster CR (Custom Resource), run:

   $ oc get checluster --output jsonpath='{.items[0].status.cheURL}'

2. Alternatively, to retrieve the CodeReady Workspaces cluster URL from the OpenShift logs, run:

   $ oc logs --tail=10 `(oc get pods -o name | grep operator)` | \
     grep "available at" | \
     awk -F'available at: ' '{print $2}' | sed 's/"//'

1. Open the OpenShift web console.
2. In the left panel, navigate to the Operators Installed Operators section.
3. Click on the Red Hat CodeReady Workspaces Operator tile.
4. Click on eclipse-che in the table.
5. Navigate to the Overview tab.
6. Toggle the TLS MODE switch to True.

7. Click Confirm change.

   
8. Navigate to the Resources tab.
9. Wait that the Pods are restarted.
10. Navigate to the Overview tab.
11. Click the Red Hat CodeReady Workspaces URL link.
12. Notice that the link is redirected to HTTPS.
13. The browser displays the Red Hat CodeReady Workspaces Dashboard using a valid Let’s Encrypt certificate.

Procedure

1. Navigate to the Red Hat CodeReady Workspaces URL to display the Red Hat CodeReady Workspaces login page.
2. Choose the OpenShift OAuth option.
3. The Authorize Access page is displayed.
4. Click on the Allow selected permissions button.
5. Update the account information: specify the Username, Email, First name and Last name fields and click the Submit button.

Procedure

1. Navigate to the Red Hat CodeReady Workspaces URL to display the Red Hat CodeReady Workspaces login page.
2. Choose the Register as a new user option.
3. Update the account information: specify the Username, Email, First name and Last name field and click the Submit button.

Procedure

1. Navigate to https://developers.redhat.com/products/codeready-workspaces/download.
2. Download the CodeReady Workspaces CLI management tool archive for version 2.1.
3. Extract the archive.
4. Place the extracted binary in your $PATH.