Installing Che on OpenShift 4 using OperatorHub

This section describes how to install Che using the Che Operator available in OpenShift 4 web console.

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

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

Prerequisites
  • An administrator account on a running instance of OpenShift 4.

Installing the Eclipse Che Operator

Eclipse Che Operator provides all the resources for running Che, such as PostgreSQL, Keycloak, image registries, and the Che server, and it also configures all these services.

Prerequisites
  • Access to the OpenShift web console on the cluster.

Procedure
  1. In the left panel, navigate to the OperatorsOperatorHub page.

  2. In the Filter by keyword field, enter Eclipse Che.

  3. Click the Eclipse Che tile.

  4. In the Eclipse Che pop-up window, click the Install button.

  5. On the Install Operator page, click the Install button.

Verification steps
  1. To verify that the Eclipse Che Operator has installed correctly, in the left panel, navigate to the OperatorsInstalled Operators page.

  2. On the Installed Operators page, click the Eclipse Che name and navigate to the Details tab.

  3. In the ClusterServiceVersion details section, wait for the following messages:

    • Status: Succeeded

    • Status reason: install strategy completed with no errors

  4. Navigate to the Events tab and wait for the following message: install strategy completed with no errors.

Creating an instance of the Eclipse Che Operator

Follow this procedure to install Eclipse Che with the default configuration. To modify the configuration, see Configuring the Che installation.

Procedure
  1. In the left panel, click Operators, then click Installed Operators.

  2. On the Installed Operators page, click the Eclipse Che name.

  3. On the Operator details page, in the Details tab, click the Create instance link in the Provided APIs section.

    This navigates you to the Create CheCluster page, which contains the configuration needed to create a Che instance, stored in the CheCluster Custom Resource.

  4. Create the eclipse-che cluster by using the Create button at the end of the page using the default values.

  5. On the Operator details page, in the Eclipse Che Cluster tab, click the eclipse-che link.

  6. Navigate to the eclipse-che instance using the link displayed under the Eclipse Che URL output.

    The installation might take more than 5 minutes. The URL appears when the Eclipse Che installation finishes.

Verification
  1. To verify the Che instance has installed correctly, navigate to the Eclipse Che Cluster tab of the Operator details page. The CheClusters page displays the list of Che instances and their status.

  2. Click eclipse-che CheCluster and navigate to the Details tab.

  3. See the content of the following fields:

    • The Message field contains error messages. The expected content is None.

    • The Eclipse Che URL field contains the URL of the Eclipse Che instance. The URL appears when the deployment finishes successfully.

  4. Navigate to the Resources tab. View the list of resources assigned to the Che deployment and their status.