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

Operators are a method of packaging, deploying, and managing a OpenShift application which also provide the following:

  • Repeatability of installation and upgrade.
  • Constant health checks of every system component.
  • Over-the-air (OTA) updates for OpenShift components and ISV content.
  • A place to encapsulate knowledge from field engineers and spread it to all users.

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

2.1. 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 to install via the Operator with SSL (HTTPS) enabled.

As of 2.1.1, SSL/TLS is enabled by default as it is required by the Che-Theia IDE.

Prerequisites

Procedure

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

    $ oc login

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

    $ crwctl server:start -n <openshift_namespace>
    Note

    To create the CodeReady Workspaces instance on OpenShift clusters that have not been configured with a valid certificate for the routes, run the crwctl command with the --self-signed-cert flag.

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: https://codeready-<openshift_deployment_name>.<domain_name>. The domain uses Let’s Encrypt ACME certificates.