Merge pull request #100551 from openshift-cherrypick-robot/cherry-pick-100338-to-enterprise-4.20

[enterprise-4.20] OSDOCS-15543#Improved environment variable parsing for ImagePaths

Author: lpettyjo

modules/oc-mirror-imageset-config-parameters-v2.adoc

@@ -96,6 +96,20 @@ local:
     path: /test/podinfo-5.0.0.tar.gz
 ----
 
+|`mirror.helm.local.charts.imagePaths` 
+|The custom path of a container image inside of the local helm chart.
++
+[NOTE]
+====
+`oc-mirror` detects and mirrors container images from the helm chart by searching well-known paths. You can also specify custom paths using this field.
+====
++
+[NOTE]
+====
+Operand images, dynamically deployed by Operator controllers at runtime, are typically referenced by environment variables within the controller's deployment template. Before {product-title} 4.20, while `oc-mirror` could access these environment variables, it attempted to mirror all values, including non-image references, for example, log levels, leading to failures. With this update, you can mirror only the container images referenced in these environment variables.
+====
+|Array of string. For example:  `"- {.spec.template.spec.custom[*].image}"`. 
+
 |`mirror.helm.local.name`
 |The name of the local helm chart to mirror.
 |String. For example: `podinfo`.
@@ -143,7 +157,12 @@ repositories:
 ====
 `oc-mirror` detects and mirrors container images from the helm chart by searching well-known paths. You can also specify custom paths using this field.
 ====
-|Array of string. For example:  `"- {.spec.template.spec.custom[*].image}"`.
++
+[NOTE]
+====
+Operand images, dynamically deployed by Operator controllers at runtime, are typically referenced by environment variables within the controller's deployment template. Before {product-title} 4.20, while `oc-mirror` could access these environment variables, it attempted to mirror all values, including non-image references, for example, log levels, leading to failures. With this update, you can mirror only the container images referenced in these environment variables.
+====
+|Array of string. For example:  `"- {.spec.template.spec.custom[*].image}"`. 
 endif::microshift[]
 
 |`mirror.operators`
@@ -508,4 +527,4 @@ The default is `ocp`
 |Boolean
 The default value is `false`
 endif::microshift[]
-|===
+|===