Eclipse Che can be installed from OpenShift OperatorHub.

Installing Che on OpenShift 4

Procedure

To install Che on OpenShift 4:

  1. Create the che project:

    1. Click the Projects tab and click the Create Project button.

      open shift create project

    2. In the Name field, type che and click the Create button.

      create project button

  2. Install the operator:

    1. In the left panel, expand Catalog and click OperatorHub.

      catalog operatorhub

    2. In the Search by keyword field, type eclipse che.

      eclipse che in openshift creation

    3. Click Eclipse Che.

      select eclipse che in openshift

    4. Click the Install button in the Eclipse Che pop-up window.

      install eclipse che in openshift

    5. In the A specific namespace on the cluster field, in the cluster drop-down list, select che. Click the Subscribe button.

      eclipse che create operator subscription

      The operator is successfully installed and is available in the Installed Operators section.

      eclipse che overview

  3. Deploy Che:

    1. Navigate to the Catalog → Installed Operators section.

      eclipse che installed operators

      Eclipse Che is displayed as an installed operator having the InstallSucceeded status.

    2. To deploy Che, click Eclipse Che in the list of installed operators.

      eclipse che overview provided apis

    3. Click the Create New link in Provided APIs section.

      cc eclipse che cluster

    4. Leave the default values as they are and click the Create button in the bottom-left corner of the window.

      create che cluster intalled operators

      The Eclipse Che cluster is created.

      eclipse che cluster create che cluster

  4. Track the Che deployment:

    1. Click the eclipse-che cluster.

      eclipse che cluster overview

    2. Click the Resources tab.

      eclipse che resources tab

      The user can also track the deployment using the command line and the following two commands:

      $ oc project che
$ oc get pods
NAME                            READY     STATUS    RESTARTS   AGE
che-8495f4946b-jrzdc            0/1       Running   0          86s
che-operator-578765d954-99szg   1/1       Running   0          42m
keycloak-74fbfb9654-g9vp5       1/1       Running   0          4m32s
postgres-5d579c6847-w6wx5       1/1       Running   0          5m14s

Viewing che-operator logs

  1. To view the che-operator logs, run the following command:

    $ oc logs --tail=10 -f che-operator-578765d954-99szg
time="2019-07-12T09:48:29Z" level=info msg="Exec successfully completed"
time="2019-07-12T09:48:29Z" level=info msg="Updating eclipse-che CR with status: provisioned with OpenShift identity provider: true"
time="2019-07-12T09:48:29Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: che"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: custom"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: Deployment, name: che"
time="2019-07-12T09:48:30Z" level=info msg="Updating eclipse-che CR with status: Che API: Unavailable"
time="2019-07-12T09:48:30Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:48:30Z" level=info msg="Waiting for deployment che. Default timeout: 420 seconds"

  2. To obtain the Eclipse Che URL, wait for the logs to show the following information:

    time="2019-07-12T09:50:13Z" level=info msg="Updating eclipse-che CR with Eclipse Che server URL: http://che-che.apps.cluster-fre-f0a2.fre-f0a2.openshiftworkshop.com"
time="2019-07-12T09:50:13Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:50:13Z" level=info msg="Eclipse Che is now available at: http://che-che.apps.cluster-fre-f0a2.fre-f0a2.openshiftworkshop.com"
time="2019-07-12T09:50:13Z" level=info msg="Updating eclipse-che CR with version: 7.0.0-RC-2.0"

    The URL is also displayed in the Eclipse Che cluster on the Installed Operators window in the ECLIPSE CHE URL field.

    eclipse che url filef overview

  3. Click the Eclipse Che URL link to display the Eclipse Che login page.

    eclipse che login page

  4. To log in, use OpenShift OAuth or register as a new user. To use OAuth, the user must grant permissions to log in to Eclipse Che.

    authorize access for eclipse che openshift

  5. Update the account information.

    update account information eclipse che

    Once logged in, the user can create a workspace using the Eclipse Che Dashboard.

    eclipse che loading
    eclipse che loading

Enabling SSL on OpenShift 4

Procedure

To enable SSL on Openshift 4:

  1. Toggle the TLS MODE switch to True.

    set that value to true enabeling tls mode
    tls mode true

  2. Click Confirm change.

  3. In the Resources section, the pods are restarted.

    resource section pods are restarted

  4. Click the ECLIPSE CHE URL link.

    eclipse che url link

    Notice that the link is redirected to HTTPS.

    link is redirected to https

    A valid Let’s Encrypt certificate is available, and Che is available on HTTPS.

che running on openshift v4
Figure 1. An example of Eclipse Che running on OpenShift v4.1 with SSL
Tags: