Installing Che on OpenShift 3 using the Operator

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

A running instance of OpenShift 3.11.
Administrator rights on this OpenShift 3 instance.
The oc OpenShift 3.11 CLI management tool is installed and configured. See Installing the OpenShift 3.11 CLI.
The chectl CLI management tool is installed. See Installing the chectl CLI management tool.

Procedure

Log in to OpenShift. See Basic Setup and Login.
```
$ oc login
```
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
```

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

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>.
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

A running instance of OpenShift 3.11.
Administrator rights on this OpenShift 3 instance.
The oc OpenShift 3.11 CLI management tool is installed and configured. See Installing the OpenShift 3.11 CLI.
The chectl CLI management tool is installed. See Installing the chectl CLI management tool.
The URL for applications on this OpenShift instance is known as <OPENSHIFT_APPS_URL>. See Preparing OpenShift 3 for installing Che.

Procedure

Create a new project called che:
```
$ oc new-project che
```

Run the following command to create the Che instance:

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

Verification steps

The output of the previous command ends with:

Command server:start has completed successfully.

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

A running instance of OpenShift 3.11.
Administrator rights on this OpenShift 3 instance.
The oc OpenShift 3.11 CLI management tool is installed and configured. See Installing the OpenShift 3.11 CLI.
The chectl CLI management tool is installed. See Installing the chectl CLI management tool.
The URL for applications on this OpenShift instance is known as <OPENSHIFT_APPS_URL>. See Preparing OpenShift 3 for installing Che.

Procedure

Create a new project called che:
```
$ oc new-project che
```

Run the following command to create the Che instance:

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

Verification steps

The output of the previous command ends with:

Command server:start has completed successfully.

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: