Configuring Eclipse Che server hostname

This procedure describes how to configure Che to use custom hostname.

  • An active kubectl session with administrative permissions to the destination Kubernetes cluster. See Overview of kubectl.

  • The certificate and the private key files are generated.

To generate the pair of a private key and certificate, the same certification authority (CA) must be used as for other Che hosts.
Ask a DNS provider to point the custom hostname to the cluster ingress.
  1. Pre-create a namespace for Che:

    $ kubectl create namespace eclipse-che
  2. Create a TLS secret:

    $ kubectl create secret TLS <tls_secret_name> \ (1)
    --key <key_file> \ (2)
    --cert <cert_file> \ (3)
    -n eclipse-che
    1 The TLS secret name
    2 A file with the private key
    3 A file with the certificate
  3. Add the required labels to the secret:

    $ kubectl label secret <tls_secret_name> \ (1) -n eclipse-che
    1 The TLS secret name
  4. Configure the CheCluster Custom Resource. See Using the CLI to configure the CheCluster Custom Resource.

        hostname: <hostname>     (1)
        tlsSecretName: <secret>  (2)
    1 Custom Eclipse Che server hostname
    2 The TLS secret name
  5. If Che has been already deployed, wait until the rollout of all Che components finishes.