eclipse-che · gtrivedi88 · Jul 3, 2026 · Jul 3, 2026
@@ -1,25 +1,25 @@
 :_content-type: ASSEMBLY
-:description: Caching images for faster workspace start
+:description: How image caching speeds up workspace starts
 :keywords: administration-guide, caching-images-for-faster-workspace-start
-:navtitle: Caching images for faster workspace start
+:navtitle: How image caching speeds up workspace starts
 :page-aliases: administration-guide:caching-images-for-faster-workspace-start.adoc, .:caching-images-for-faster-workspace-start.adoc
 
 
 [id="caching-images-for-faster-workspace-start"]
-= Caching images for faster workspace start
+= How image caching speeds up workspace starts
 
 To improve the start time performance of {prod-short} workspaces,
 use the {image-puller-name-short}, a community-supported {prod-short}-agnostic component that can be used
 to pre-pull images for {platforms-name} clusters.
 
-include::partial$snip_persona-admin.adoc[]
-
 The {image-puller-name-short} is an
 additional {platforms-name} deployment which creates a _DaemonSet_ that can be
 configured to pre-pull relevant {prod-short} workspace images on each node.
 These images would already be available when a {prod-short} workspace starts,
 therefore improving the workspace start time.
 
+For instructions on deploying, configuring, and reviewing cached images, see Additional resources.
+
 include::partial$snip_installing-kubernetes-image-puller.adoc[]
 include::partial$snip_configuring-kubernetes-image-puller.adoc[]
 

@@ -1,15 +1,13 @@
 :_content-type: ASSEMBLY
-:description: Configuring autoscaling
+:description: Scale the platform automatically
 :keywords: administration-guide, configuring, autoscaling, autoscale, horizontal, scaling, machine
-:navtitle: Configuring autoscaling
+:navtitle: Scale the platform automatically
 :page-aliases: administration-guide:configuring-autoscaling.adoc
 
 [id="configuring-autoscaling"]
-= Configuring autoscaling
+= Scale the platform automatically
 
-Learn about different aspects of autoscaling for {prod}.
-
-include::partial$snip_persona-admin.adoc[]
+Scale {prod-short} container replicas and cluster nodes automatically so that the platform grows and shrinks with developer demand.
 
 * xref:configuring-number-of-replicas.adoc[]
 * xref:configuring-machine-autoscaling.adoc[]
@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Configuring {image-puller-name-short} to pre-pull additional images
+:description: Cache additional images for faster starts
 :keywords: administration-guide, image-puller, CLI
-:navtitle: Configuring {image-puller-name-short} to pre-pull additional images
+:navtitle: Cache additional images for faster starts
 :page-aliases: administration-guide:configuring-image-puller-to-pre-pull-additional-images.adoc
 
 [id="configuring-image-puller-to-pre-pull-additional-images"]
-= Configuring {image-puller-name-short} to pre-pull additional images
+= Cache additional images for faster starts
 
-You can configure {image-puller-name} to pre-pull additional {prod-short} images.
-
-include::partial$snip_persona-admin.adoc[]
+Cache additional images with {image-puller-name} to reduce workspace startup time by ensuring that required images are already cached on each node.
 
 .Prerequisites
 
@@ -39,12 +37,24 @@ metadata:
   name: k8s-image-puller-images
   namespace: {image-puller-namespace}
 spec:
-  images: "__NAME-1__=__IMAGE-1__;__NAME-2__=__IMAGE-2__" <1>
+  images: "__NAME-1__=__IMAGE-1__;__NAME-2__=__IMAGE-2__"
 EOF
 ----
-<1> The semicolon separated list of images
++
+where:
++
+`images`:: The semicolon-separated list of images in `name=image` format.
+
+.Verification
+
+* Verify that the image puller `DaemonSet` is running in the `{image-puller-namespace}` namespace:
++
+[source,shell,subs="+attributes"]
+----
+{orch-cli} get daemonset -n {image-puller-namespace}
+----
 
-.Addition resources
+.Additional resources
 
 * https://github.com/che-incubator/kubernetes-image-puller[{image-puller-name} source code repository]
 

@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Configuring {image-puller-name-short} to pre-pull custom images
+:description: Cache your organization's custom images
 :keywords: administration-guide, image-puller, CLI
-:navtitle: Configuring {image-puller-name-short} to pre-pull custom images
+:navtitle: Cache your organization's custom images
 :page-aliases: administration-guide:configuring-image-puller-to-pre-pull-custom-images.adoc
 
 [id="configuring-image-puller-to-pre-pull-custom-images"]
-= Configuring {image-puller-name-short} to pre-pull custom images
+= Cache your organization's custom images
 
-You can configure {image-puller-name} to pre-pull custom images.
-
-include::partial$snip_persona-admin.adoc[]
+Cache your organization's custom images with {image-puller-name} so that workspaces using organization-specific container images start without waiting for large image downloads.
 
 .Prerequisites
 
@@ -34,11 +32,23 @@ include::partial$snip_persona-admin.adoc[]
                   "imagePuller": {
                     "enable": true,
                     "spec": {
-                      "images": "__NAME-1__=__IMAGE-1__;__NAME-2__=__IMAGE-2__" <1>
+                      "images": "__NAME-1__=__IMAGE-1__;__NAME-2__=__IMAGE-2__"
                     }
                   }
                 }
               }
             }'
 ----
-<1> The semicolon separated list of images
++
+where:
++
+`images`:: The semicolon-separated list of images in `name=image` format.
+
+.Verification
+
+* Verify that the image puller is configured with the custom images:
++
+[source,shell,subs="+attributes"]
+----
+{orch-cli} get checluster {prod-checluster} -n {prod-namespace} -o jsonpath='{.spec.components.imagePuller.spec.images}'
+----
@@ -1,18 +1,16 @@
 :_content-type: PROCEDURE
-:description: Configuring {image-puller-name-short} to pre-pull default {prod-short} images
+:description: Cache default {prod-short} images on all nodes
 :keywords: administration-guide, image-puller, CLI
-:navtitle: Configuring {image-puller-name-short} to pre-pull default {prod-short} images
+:navtitle: Cache default {prod-short} images on all nodes
 :page-aliases: administration-guide:configuring-image-puller-to-pre-pull-default-che-images.adoc
 
 [id="configuring-image-puller-to-pre-pull-default-che-images"]
-= Configuring {image-puller-name-short} to pre-pull default {prod-short} images
+= Cache default {prod-short} images on all nodes
 
-You can configure {image-puller-name} to pre-pull default {prod-short} images.
-{prod} operator will control the list of images to pre-pull and automatically updates them
+Cache default {prod-short} images on all nodes by enabling {image-puller-name}.
+The {prod} Operator controls the list of images to pre-pull and automatically updates them
 on {prod-short} upgrade.
 
-include::partial$snip_persona-admin.adoc[]
-
 .Prerequisites
 
 * Your organization's instance of {prod-short} is installed and running on {kubernetes} cluster.
@@ -41,6 +39,15 @@ include::partial$snip_persona-admin.adoc[]
             }'
 ----
 
+.Verification
+
+* Verify that the image puller is enabled:
++
+[source,shell,subs="+attributes"]
+----
+{orch-cli} get checluster {prod-checluster} -n {prod-namespace} -o jsonpath='{.spec.components.imagePuller.enable}'
+----
+
 .Additional resources
 
 * xref:retrieving-default-list-of-images-for-kubernetes-image-puller.adoc[]
@@ -1,17 +1,13 @@
 :_content-type: PROCEDURE
-:description: Configuring {image-puller-name}
+:description: Configure {image-puller-name}
 :keywords: overview, configuring, image-puller
-:navtitle: Configuring {image-puller-name}
+:navtitle: Configure {image-puller-name}
 
 [id="configuring-{image-puller-name}"]
-= Configuring {image-puller-name}
+= Configure {image-puller-name}
 
 This section contains instructions for configuring the {image-puller-name} for different use cases.
 
-include::partial$snip_persona-admin.adoc[]
-
-== Configuring {image-puller-name}
-
 * xref:configuring-image-puller-to-pre-pull-default-che-images.adoc[]
 * xref:configuring-image-puller-to-pre-pull-custom-images.adoc[]
 * xref:configuring-image-puller-to-pre-pull-additional-images.adoc[]
@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Configuring machine autoscaling
+:description: Prevent workspace failures during node scaling
 :keywords: administration guide, machine, autoscaling, scaling
-:navtitle: Configuring machine autoscaling
+:navtitle: Prevent workspace failures during node scaling
 :page-aliases: administration-guide:configuring-machine-autoscaling.adoc
 
 [id="configuring-machine-autoscaling"]
-= Configuring machine autoscaling
+= Prevent workspace failures during node scaling
 
-If you configured the cluster to adjust the number of nodes depending on resource needs, you need additional configuration to maintain the uninterrupted operation of {prod-short} workspaces.
-
-include::partial$snip_persona-admin.adoc[]
+Prevent workspace failures during node scaling by configuring {prod-short} startup timeouts and pod annotations to work with the cluster autoscaler.
 
 Workspaces need special consideration when the autoscaler adds and removes nodes.
 

@@ -1,7 +1,7 @@
 :_content-type: ASSEMBLY
-:description: Configuring number of replicas for a {prod} container
+:description: Scale {prod-short} for high availability
 :keywords: administration guide, configuring-number-of-replicas
-:navtitle: Configuring number of replicas for a {prod} container
+:navtitle: Scale {prod-short} for high availability
 :page-aliases: administration-guide:configuring-number-of-replicas.adoc
 
 include::partial$proc_configuring-number-of-replicas.adoc[]

@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Installing the {image-puller-name} operator on {kubernetes} cluster by using CLI
+:description: Deploy {image-puller-name-short} on a {kubernetes} cluster
 :keywords: administration-guide, image-puller, operator, CLI
-:navtitle: Installing the {image-puller-name} operator on {kubernetes} cluster by using CLI
+:navtitle: Deploy {image-puller-name-short} on a {kubernetes} cluster
 :page-aliases: administration-guide:installing-image-puller-on-kubernetes-by-using-cli.adoc, .:installing-image-puller-on-openshift-using-openshift-templates.adoc,installing-image-puller-on-openshift-using-openshift-templates.adoc
 
 [id="installing-image-puller-on-kubernetes-cluster-by-using-the-cli"]
-= Installing {image-puller-name-short} operator on {kubernetes} cluster by using CLI
+= Deploy {image-puller-name-short} on a {kubernetes} cluster
 
-You can install the {image-puller-name} operator on {kubernetes} cluster by using CLI.
-
-include::partial$snip_persona-admin.adoc[]
+Deploy the {image-puller-name} operator on a {kubernetes} cluster by using CLI.
 
 .Prerequisites
 

@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Installing {image-puller-name-short} on OpenShift by using the web console
+:description: Deploy {image-puller-name-short} from the web console
 :keywords: administration-guide, image-puller, openshift, operator, operatorhub
-:navtitle: Installing {image-puller-name-short} on OpenShift by using the web console
+:navtitle: Deploy {image-puller-name-short} from the web console
 :page-aliases: administration-guide:installing-image-puller-on-openshift-by-using-the-web-console.adoc, .:installing-image-puller-on-openshift-by-using-operatorhub.adoc, installing-image-puller-on-openshift-using-operatorhub.adoc
 
 [id="installing-image-puller-on-openshift-by-using-the-web-console"]
-= Installing {image-puller-name-short} on OpenShift by using the web console
+= Deploy {image-puller-name-short} from the web console
 
-You can install the {image-puller-operator-name} on OpenShift by using the OpenShift web console.
-
-include::partial$snip_persona-admin.adoc[]
+Deploy the {image-puller-operator-name} on OpenShift by using the OpenShift web console.
 
 .Prerequisites
 

@@ -1,15 +1,13 @@
 :_content-type: PROCEDURE
-:description: Installing {image-puller-name-short} on OpenShift using CLI
+:description: Deploy {image-puller-name-short} from the command line
 :keywords: administration-guide, image-puller, openshift, openshift-templates, CLI
-:navtitle: Installing {image-puller-name-short} on OpenShift using CLI
+:navtitle: Deploy {image-puller-name-short} from the command line
 // :page-aliases: .:installing-image-puller-on-openshift-using-openshift-templates.adoc,installing-image-puller-on-openshift-using-openshift-templates.adoc
 
 [id="installing-image-puller-on-openshift-using-the-cli"]
-= Installing {image-puller-name-short} on OpenShift by using the CLI
+= Deploy {image-puller-name-short} from the command line
 
-You can install the {image-puller-name} on OpenShift by using OpenShift `oc` management tool.
-
-include::partial$snip_persona-admin.adoc[]
+Deploy the {image-puller-name} on OpenShift by using the OpenShift `oc` management tool.
 
 [IMPORTANT]
 ====

@@ -1,17 +1,13 @@
 :_content-type: PROCEDURE
-:description: Installing {image-puller-name}
+:description: Deploy {image-puller-name}
 :keywords: overview, installing, image-puller
-:navtitle: Installing {image-puller-name}
+:navtitle: Deploy {image-puller-name}
 
 [id="installing-{image-puller-name}"]
-= Installing {image-puller-name}
+= Deploy {image-puller-name}
 
 Follow the instructions below to install the {image-puller-name} for different use cases.
 
-include::partial$snip_persona-admin.adoc[]
-
-== Installing {image-puller-name}
-
 * xref:installing-image-puller-on-kubernetes-by-using-cli.adoc[]
 * xref:installing-image-puller-on-openshift-by-using-the-web-console.adoc[]
 * xref:installing-image-puller-on-openshift-using-cli.adoc[]
@@ -1,15 +1,12 @@
 :_content-type: PROCEDURE
-:description: Retrieving the default list of images for {image-puller-name}
+:description: Review the default images cached by {image-puller-name-short}
 :keywords: administration-guide, image-puller
-:navtitle: Retrieving the default list of images for {image-puller-name}
+:navtitle: Review the default images cached by {image-puller-name-short}
 
 [id="retrieving-default-list-of-images-for-kubernetes-image-puller"]
-= Retrieving the default list of images for {image-puller-name}
-
-Learn how to retrieve the default list of images used by {image-puller-name}. This can be helpful for administrators who want to review and configure {image-puller-name-short} to use only a subset of these images in advance.
-
-include::partial$snip_persona-admin.adoc[]
+= Review the default images cached by {image-puller-name-short}
 
+Review the default list of images used by {image-puller-name} to decide which images to pre-cache. This list helps administrators configure {image-puller-name-short} to use only a subset of these images in advance.
 
 .Prerequisites