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

This chapter describes how to install CodeReady Workspaces on OpenShift 3, with the CLI management tool, using the Operator method.

2.1. Preparing OpenShift 3 for installing CodeReady Workspaces

Prerequisites

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

2.2. Installing CodeReady Workspaces on OpenShift 3 using the Operator

This section describes how to install CodeReady Workspaces on OpenShift 3 with the CLI management tool, using the Operator method.

Prerequisites

Procedure

  1. Create a new project called codeready-workspaces:

    $ oc new-project codeready-workspaces
  2. 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>.

2.3. Installing CodeReady Workspaces on OpenShift 3 using the Operator and SSL

This section describes how to install CodeReady Workspaces on OpenShift 3 with the CLI management tool, using the Operator method and the SSL option.

Prerequisites

Procedure

  1. Create a new project called codeready-workspaces:

    $ oc new-project codeready-workspaces
  2. 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: https://che-che.<OPENSHIFT_APPS_URL>.