Operators are a method of packaging, deploying, and managing a Kubernetes 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 independent software vendor (ISV) content.

  • A place to encapsulate knowledge from field engineers and spread it to all users.

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(s)://che-host:che-port.

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. Run the following command to create the Che instance:

    $ chectl server:start -n <project-name> --domain=<OPENSHIFT_APPS_URL>

    To create the Che instance on demo OpenShift clusters that have not been setup with a valid certificate for the routes, run the 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 Che cluster instance. The domain is now prefixed with HTTPS and using Let’s Encrypt ACME certificates: http(s)://che-che.<OPENSHIFT_APPS_URL>

Tags: