Skip to main content

Obtain credentials for Lumi Enterprise on OpenShift

AI summary
Explains how to obtain and configure Docker Hub credentials, Imply Lumi onboarding credentials, and RSA key pairs for deployment. Covers creating Kubernetes secrets and optional registry mirror setup. These credentials enable your OpenShift cluster to access Lumi container images and authenticate services.

About AI summaries.
info

Imply Lumi Enterprise on OpenShift is an early access feature.

Before you install Imply Lumi Enterprise on OpenShift, set up the credentials required for your deployment. This topic explains how to obtain the required credentials.

In this topic, placeholder values are shown in uppercase—for example, YOUR_DOCKERHUB_USERNAME. Replace these with values for your own environment.

Docker Hub credentials​

Imply stores Lumi container images in a private Docker Hub repository. To pull the images, your OpenShift cluster needs Docker Hub credentials with access to that repository. If you use a registry mirror to access the images for Lumi, the mirror uses the credentials to pull from Docker Hub instead of your cluster using them directly. For more information, see Use a registry mirror.

When you sign up for Lumi, you provide the email address for your Docker Hub account. Imply invites you to join its Docker Hub organization and grants you access to the Lumi repository.

Lumi requires a Docker Hub personal access token (PAT) with Read-only access permissions to pull container images. A PAT is a security credential you use to authenticate with a service instead of using a username and password. If you don't already have a PAT, generate one in Docker Hub and set Access permissions to Read-only. The default, Public Repo Read-only, only allows access to public repositories, so your cluster can't pull images from the private Lumi repository. For more information, see Create and manage personal access tokens in the Docker documentation.

Your cluster needs a Kubernetes secret containing your Docker Hub credentials before it can pull Lumi images. The Helm chart can create the secret for you, or you can create it yourself:

To have the Helm chart create the secret for you, add your Docker Hub username and PAT directly to values.yaml. The chart creates the secret as part of installation.

registry:
dockerhub:
username: YOUR_DOCKERHUB_USERNAME
password: YOUR_DOCKERHUB_PAT

Use the Docker Hub PAT, not your account password. You must set both fields together, or the install fails with a validation error.

If you set registry.pullSecret, the chart ignores registry.dockerhub and doesn't create a secret from it. Set one or the other, not both.

tip

If pods fail to start with an ImagePullBackOff or unauthorized error, check that your PAT's Access permissions are set to Read-only, not Public Repo Read-only.

Lumi onboarding credentials​

Contact your Imply support representative to obtain the following Lumi onboarding credentials:

  • Tenant ID
  • Customer ID
  • API key

You set these in values.yaml as tenantId, customerId, and apiKey. You also need the tenant ID when you configure permissions.

RSA key pair​

Lumi uses an RSA key pair to sign and verify authentication tokens.

Generate an RSA key pair:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -pubout -out public.pem

You need to add both RSA keys to your values.yaml. Make sure to preserve the indentation and include the full key including the header and footer lines:

auth:
rsa:
privateKey: |
-----BEGIN RSA PRIVATE KEY-----
<paste private key content here>
-----END RSA PRIVATE KEY-----
publicKey: |
-----BEGIN PUBLIC KEY-----
<paste public key content here>
-----END PUBLIC KEY-----
tip

Treat the private key as a secret. Don't commit it to source control or share it.

Use a registry mirror​

If you have secured your cluster in a way that doesn't allow it to pull directly from Docker Hub, you can configure Lumi to pull container images and Helm charts from a mirror in your own registry. A mirror, also called a pull-through cache, pulls content from Docker Hub on demand and serves it from your registry.

To use a registry mirror:

  1. In your registry, create a remote repository that proxies https://registry-1.docker.io/.

  2. Configure the mirror to log in to Docker Hub with the Docker Hub credentials you used to join the Imply Docker Hub organization. The mirror uses these credentials to pull from Docker Hub.

  3. If the mirror requires your cluster to authenticate, set registry.pullSecret to the name of a kubernetes.io/dockerconfigjson secret in the Lumi namespace. The secret must have an auths entry for the mirror's host name, MIRROR_HOST.

    Lumi uses registry.pullSecret for both image pulls and the update-client service's Helm chart pulls. The cluster-wide pull secret doesn't authorize chart pulls.

  4. Set the mirror's paths in values.yaml:

    registry:
    containerRepo: "MIRROR_HOST/MIRROR_PATH/imply"
    chartRepo: "oci://MIRROR_HOST/MIRROR_PATH/imply"
    • registry.containerRepo is the location for the Lumi container images.
    • registry.chartRepo is the location for Lumi Helm charts.

    For example, if your mirror is at registry.example.com and the remote repository is docker-remote, set containerRepo to registry.example.com/docker-remote/imply and chartRepo to oci://registry.example.com/docker-remote/imply.

Next step​

After you obtain your credentials, continue to Configure permissions.