From 0bbcef3dcc03db6a66cfd1a3e264376fd7efecc4 Mon Sep 17 00:00:00 2001
From: RichardHoch <rhoch@redhat.com>
Date: Sun, 2 Jun 2024 11:25:47 +0300
Subject: [PATCH] Add scanning for deprecated images to the 'Updating
 deprecated internal images' troubleshooting procedure

---
 ...n-updating-deprecated-internal-images.adoc | 23 ++++++++++++++-----
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/modules/migration-updating-deprecated-internal-images.adoc b/modules/migration-updating-deprecated-internal-images.adoc
index 05db06943c..6b1cbb6134 100644
--- a/modules/migration-updating-deprecated-internal-images.adoc
+++ b/modules/migration-updating-deprecated-internal-images.adoc
@@ -25,28 +25,39 @@ If an {product-title} 3 image is deprecated in {product-title} {product-version}
 The {product-registry} is exposed by default on {product-title} 4.
 
 . If you are using insecure registries, add your registry host values to the `[registries.insecure]` section of `/etc/container/registries.conf` to ensure that `podman` does not encounter a TLS verification error.
-. Log in to the {product-title} 3 registry:
+. Log in to the {product-title} 3 registry by running the following command:
 +
 [source,terminal]
 ----
 $ podman login -u $(oc whoami) -p $(oc whoami -t) --tls-verify=false <registry_url>:<port>
 ----
 
-. Log in to the {product-title} 4 registry:
+. Log in to the {product-title} 4 registry by running the following command:
 +
 [source,terminal]
 ----
 $ podman login -u $(oc whoami) -p $(oc whoami -t) --tls-verify=false <registry_url>:<port>
 ----
 
-. Pull the {product-title} 3 image:
+. Pull the {product-title} 3 image by running the following command:
 +
 [source,terminal]
 ----
 $ podman pull <registry_url>:<port>/openshift/<image>
 ----
 
-. Tag the {product-title} 3 image for the {product-title} 4 registry:
+. Scan the {product-title} 3 image for deprecated namespaces by running the following command:
++
+[source,terminal]
+----
+$ oc get bc --all-namespaces --template='range .items
+"BuildConfig:" .metadata.namespace/.metadata.name =>
+"\t""ImageStream(FROM):" .spec.strategy.sourceStrategy.from.namespace/.spec.strategy.sourceStrategy.from.name
+"\t""ImageStream(TO):" .spec.output.to.namespace/.spec.output.to.name
+end'
+----
+
+. Tag the {product-title} 3 image for the {product-title} 4 registry by running the following command:
 +
 [source,terminal]
 ----
@@ -56,7 +67,7 @@ $ podman tag <registry_url>:<port>/openshift/<image> \ <1>
 <1> Specify the registry URL and port for the {product-title} 3 cluster.
 <2> Specify the registry URL and port for the {product-title} 4 cluster.
 
-. Push the image to the {product-title} 4 registry:
+. Push the image to the {product-title} 4 registry by running the following command:
 +
 [source,terminal]
 ----
@@ -64,7 +75,7 @@ $ podman push <registry_url>:<port>/openshift/<image> <1>
 ----
 <1> Specify the {product-title} 4 cluster.
 
-. Verify that the image has a valid image stream:
+. Verify that the image has a valid image stream by running the following command:
 +
 [source,terminal]
 ----