Chapter 2. Installing CodeReady Workspaces on OpenShift 3 using the Operator

Procedure

1. Log in to OpenShift. See Basic Setup and Login.

   $ oc login

2. Run the following command to verify that the version of the oc OpenShift CLI management tool is 3.11:

   $ oc version
   oc v3.11.0+0cbc58b

3. Run the following commands to create a dummy project to find the URL that this OpenShift instance is using to deploy applications.

   $ oc new-project hello-world
   $ oc new-app centos/httpd-24-centos7~https://github.com/openshift/httpd-ex
   $ oc expose svc/httpd-ex
   $ oc get route httpd-ex
   NAME     HOST/PORT                                                PATH     SERVICES PORT     TERMINATION WILDCARD
   httpd-ex httpd-ex-hello-world.apps.rhpds311.openshift.opentlc.com httpd-ex          8080-tcp             None

4. Extract the domain from httpd-ex-hello-world.apps.rhpds311.openshift.opentlc.com. It is the part after the first name: apps.rhpds311.openshift.opentlc.com. Remember this URL as <OPENSHIFT_APPS_URL>.

5. Remove the dummy project:

   $ oc delete project hello-world

Procedure

1. Run the following command to create the CodeReady Workspaces instance:

   $ crwctl server:start --platform=openshift --installer=operator \
     --domain=<OPENSHIFT_APPS_URL>

Verification steps

1. The output of the previous command ends with:

   Command server:start has completed successfully.

2. Navigate to the CodeReady Workspaces cluster instance: http://che-che.<OPENSHIFT_APPS_URL>.

Procedure

1. Run the following command to create the CodeReady Workspaces instance:

   $ crwctl server:start --platform=openshift --installer=operator --domain=<OPENSHIFT_APPS_URL> --tls

Verification steps

1. The output of the previous command ends with:

   Command server:start has completed successfully.

2. Navigate to the CodeReady Workspaces cluster instance. The domain is now prefixed with HTTPS and using Let’s Encrypt ACME certificates: http(s)://codeready-workspaces.<OPENSHIFT_APPS_URL>