Installing Che on OpenShift using the chectl management tool

You can install Che on OpenShift.

Prerequisites
Procedure

  1. Optional: If you previously deployed Che on this OpenShift cluster, ensure that the previous Che instance is removed:

    $ chectl server:delete

  2. Create the Che instance:

    $ chectl server:deploy --platform openshift
Verification steps

  1. Verify the Che instance status:

    $ chectl server:status

  2. Navigate to the Che cluster instance:

    $ chectl dashboard:open

On ARM64 (AArch64) OpenShift clusters, you must override the gateway sidecar images after installing the Eclipse Che Operator, because the default images are not available for ARM64.

To patch the Eclipse Che Operator subscription, run the following commands:

ECLIPSE_CHE_SUBSCRIPTION=$(
  kubectl get subscription -A -o jsonpath='{.items[?(@.spec.name=="eclipse-che")]}'
)

ECLIPSE_CHE_SUBSCRIPTION_NAME=$(
  echo "$ECLIPSE_CHE_SUBSCRIPTION" | jq -r '.metadata.name'
)

ECLIPSE_CHE_SUBSCRIPTION_NAMESPACE=$(
  echo "$ECLIPSE_CHE_SUBSCRIPTION" | jq -r '.metadata.namespace'
)

kubectl patch subscription "$ECLIPSE_CHE_SUBSCRIPTION_NAME" \
  -n "$ECLIPSE_CHE_SUBSCRIPTION_NAMESPACE" \
  --type=merge \
  -p '{
    "spec": {
      "config": {
        "env": [
          {
            "name": "RELATED_IMAGE_gateway_authentication_sidecar",
            "value": "quay.io/openshift/origin-oauth-proxy:4.9"
          },
          {
            "name": "RELATED_IMAGE_gateway_authorization_sidecar",
            "value": "quay.io/openshift/origin-kube-rbac-proxy:4.9"
          }
        ]
      }
    }
  }'
Additional resources