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

Preparing OpenShift 3 for installing Che

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

Installing Che on OpenShift 3 using the Operator

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

Prerequisites
Procedure
  1. Create a new project called che:

    $ oc new-project che
  2. Run the following command to create the Che instance:

    $ chectl 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 Che cluster instance: http://che-che.<OPENSHIFT_APPS_URL>.

Installing Che on OpenShift 3 using the Operator and SSL

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

Prerequisites
Procedure
  1. Create a new project called che:

    $ oc new-project che
  2. Run the following command to create the Che instance:

    $ chectl 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 Che cluster instance. The domain is now prefixed with HTTPS and using Let’s Encrypt ACME certificates: https://che-che.<OPENSHIFT_APPS_URL>.

Tags: