Chapter 1. Navigating CodeReady Workspaces

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. Using the upper-right corner of Dashboard, open the user’s pop-up menu.
2. Select the Copy crwctl login command option.
3. Wait for the notification message The login command copied to clipboard to display.

4. Paste the login command into a terminal and observe a successful login:

   $ crwctl auth:login ...
   Successfully logged into <server> as <user>

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/"//'

Procedure

1. Navigate to URL where CodeReady Workspaces is deployed.

2. Save the certificate:

   1. Click the warning or open lock icon on the left of the address bar.
   2. Click Certificates and navigate to the Details tab.

   3. Select the top-level certificate, which is the needed Root certificate authority (do not export the unfolded certificate from the lower level), and export it:

      • On Linux, click the Export button.
      • On Windows, click the Save to file button.
3. Go to Google Chrome Certificates settings in the Privacy and security section and navigate to the Authorities tab.
4. Click the Import button and open the saved certificate file.
5. Select Trust this certificate for identifying websites and click the OK button.
6. After adding the CodeReady Workspaces certificate to the browser, the address bar displays the closed lock icon next to the URL, indicating a secure connection.

Procedure

1. Navigate to URL where CodeReady Workspaces is deployed.

2. Save the certificate:

   1. Click the lock icon on the left of the address bar.
   2. Click Certificates.
   3. Select the certificate to use and drag its displayed large icon to the desktop.
3. Open the Keychain Access application.
4. Select the System keychain and drag the saved certificate file to it.
5. Double-click the imported CA, then go to Trust and select When using this certificate: Always Trust.
6. Restart the browser for the added certificated to take effect.

Procedure

1. Navigate to URL where CodeReady Workspaces is deployed.

2. Save the certificate:

   1. Click the lock icon on the left of the address bar.
   2. Click the > button next to the Connection not secure warning.
   3. Click the More information button.
   4. Click the View Certificate button on the Security tab.
   5. Select the second certificate tab. The certificate Common Name should start with ingress-operator
   6. Click the PEM (cert) link and save the certificate.
3. Navigate to about:preferences, search for certificates, and click View Certificates.
4. Go to the Authorities tab, click the Import button, and open the saved certificate file.
5. Check Trust this CA to identify websites and click OK.
6. Restart Mozilla Firefox for the added certificated to take effect.
7. After adding the CodeReady Workspaces certificate to the browser, the address bar displays the closed lock icon next to the URL, indicating a secure connection.

Procedure

1. Open the Topology view to list all projects.
2. In the Select an Application search field, type workspace to list all workspaces.

3. Click the workspace to edit.

   The deployments are displayed as graphical circles surrounded by circular buttons. One of these buttons is Edit Source Code.

   
4. To edit the code of an application using CodeReady Workspaces, click the Edit Source Code button. This redirects to a workspace with the cloned source code of the application component.

Procedure

1. Open the Red Hat Applications menu by using the three-by-three matrix icon in the upper right corner of the main screen.

   The drop-down menu displays the available applications.

   
2. Click the CodeReady Workspaces link to open the CodeReady Workspaces Dashboard.