Installing Image Puller using the Che Operator
This section describes how to use the Che Operator to install the Image Puller, which is a community-supported feature in the technology preview state.
-
Operator Lifecycle Manager and OperatorHub are available on the Kubernetes or OpenShift instance. OpenShift provides them starting with version 4.2.
-
The Che Operator is available. See Installing Che on OpenShift 4 using OperatorHub
-
Enable Image Puller in the
CheCluster
Custom Resource by setting.spec.imagePuller.enable
totrue
:apiVersion: org.eclipse.che/v1 kind: CheCluster metadata: name: eclipse-che spec: # ... imagePuller: enable: true
-
Configure Image Puller in the
CheCluster
Custom Resource:apiVersion: org.eclipse.che/v1 kind: CheCluster metadata: name: eclipse-che spec: ... imagePuller: enable: true spec: configMapName: <kubernetes-image-puller> daemonsetName: <kubernetes-image-puller> deploymentName: <kubernetes-image-puller> images: java11-maven=quay.io/eclipse/che-java11-maven:nightly;che-theia=quay.io/eclipse/che-theia:next;java-plugin-runner=eclipse/che-remote-plugin-runner-java8:latest;
-
The Che Operator populates the
.spec.imagePuller.spec.images
field with default images used for workspace startup (Theia images, plug-in broker images, sidecar plug-in images), provided that no images were added to this field before creating theCheCluster
Custom Resource. The Che Operator updates the default images in the.spec.imagePuller.spec.images
field after every rollout update of Che. However, if images were added to the.spec.imagePuller.spec.images
field before creating theCheCluster
Custom Resource, the Che Operator will not add default images. -
If user-provided images are added to the
.spec.imagePuller.spec.images
field after creating theCheCluster
Custom Resource, the Che Operator will still update default images on subsequent Che rollout updates. Non-default images remain unchanged in the.spec.imagePuller.spec.images
field after rollout updates.
-
Kubernetes or OpenShift creates a
kubernetes-image-puller-operator
Subscription. -
The
eclipse-che namespace
contains aKubernetes Image Puller Operator
ClusterServiceVersion
:$ kubectl get clusterserviceversions
-
The
eclipse-che namespace
contains these deployments:kubernetes-image-puller
andkubernetes-image-puller-operator
.$ kubectl get deployments
-
The Kubernetes Image Puller Operator creates a
KubernetesImagePuller
Custom Resource:$ kubectl get kubernetesimagepullers
-
Edit the
CheCluster
Custom Resource and set.spec.imagePuller.enable
tofalse
. -
Edit the
CheCluster
Custom Resource and set the.spec.imagePuller.spec
to configure the optional Image Puller parameters for the Che Operator.