Deploy using the CLI

Deploy Che from the command line using the chectl management tool so that you have full control over configuration options and can automate the installation.

This page is for platform administrators who install, configure, and manage Che on Kubernetes clusters. To learn more about common roles and example tasks referenced in Che documentation, see Common user roles and tasks.

Prerequisites
Procedure

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

    $ chectl server:delete

  2. Create the Che instance:

    $ chectl server:deploy --platform openshift

  1. If you are deploying on an ARM64 (AArch64) cluster, override the gateway sidecar images by patching the Eclipse Che Operator subscription:

    The default gateway sidecar images are not available for ARM64.

    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"
          }
        ]
      }
    }
  }'
Verification

  1. Verify the Che instance status:

    $ chectl server:status

  2. Navigate to the Che cluster instance:

    $ chectl dashboard:open
Additional resources