TELCODOCS-2166#Clarify the GitOps ZTP update process in Edge Computing

Author: amolnar-rh

edge_computing/ztp-updating-gitops.adoc

@@ -34,6 +34,13 @@ include::modules/ztp-required-changes-to-the-git-repository.adoc[leveloffset=+1]
 
 include::modules/ztp-installing-the-new-gitops-ztp-applications.adoc[leveloffset=+1]
 
+include::modules/ztp-pulling-ocp-images.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#enabling-assisted-installer-service-on-bare-metal_ztp-preparing-the-hub-cluster[Enabling the assisted service]
+
 include::modules/ztp-roll-out-the-configuration-changes.adoc[leveloffset=+1]
 
 [role="_additional-resources"]

modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc

@@ -13,7 +13,7 @@
 
 * You have logged in to the hub cluster as a user with `cluster-admin` privileges.
 
-* You have {rh-rhacm} with MultiClusterHub enabled.
+* You have {rh-rhacm} with `MultiClusterHub` enabled.
 
 .Procedure
 
@@ -26,21 +26,28 @@
 $ oc edit AgentServiceConfig
 ----
 
-. Add the following entry to the `items.spec.osImages` field in the CR:
+. Add the following entry to the `spec.osImages` field in the CR:
 +
 [source,yaml,subs="attributes+"]
 ----
-- cpuArchitecture: x86_64
-    openshiftVersion: "{product-version}"
-    rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
-    url: https://<host>/<path>/rhcos-live.x86_64.iso
+apiVersion: agent-install.openshift.io/v1beta1
+kind: AgentServiceConfig
+metadata:
+ name: agent
+spec:
+# ...
+  osImages:
+    - cpuArchitecture: x86_64
+      openshiftVersion: "{product-version}"
+      rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
+      url: https://<host>/<path>/rhcos-live.x86_64.iso
 ----
 +
 where:
 +
 --
-<host> :: Is the fully qualified domain name (FQDN) for the target mirror registry HTTP server.
-<path> :: Is the path to the image on the target mirror registry.
+<host> :: Specifies the fully qualified domain name (FQDN) for the target mirror registry HTTP server.
+<path> :: Specifies the path to the image on the target mirror registry.
 --
 +
-Save and quit the editor to apply the changes.
+Save and quit the editor to apply the changes.

modules/ztp-pulling-ocp-images.adoc

@@ -0,0 +1,54 @@
+// Module included in the following assemblies:
+//
+// * scalability_and_performance/ztp_far_edge/ztp-updating-gitops-ztp.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="ztp-pulling-ocp-images_{context}"]
+= Pulling ISO images for the desired {product-title} version
+
+To pull ISO images for the desired {product-title} version, update the `AgentServiceConfig` custom resource (CR) with references to the desired ISO and RootFS images that are hosted on the mirror registry HTTP server.
+
+.Prerequisites
+
+* You have installed the OpenShift CLI (`oc`).
+
+* You have logged in to the hub cluster as a user with `cluster-admin` privileges.
+
+* You have {rh-rhacm} with `MultiClusterHub` enabled.
+
+* You have enabled the assisted service.
+
+.Procedure
+
+. Update the `AgentServiceConfig` CR by running the following command:
++
+[source,terminal]
+----
+$ oc edit AgentServiceConfig
+----
+
+. Add the following entry to the `spec.osImages` field in the CR:
++
+[source,yaml,subs="attributes+"]
+----
+apiVersion: agent-install.openshift.io/v1beta1
+kind: AgentServiceConfig
+metadata:
+ name: agent
+spec:
+# ...
+  osImages:
+    - cpuArchitecture: x86_64
+      openshiftVersion: "{product-version}"
+      rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
+      url: https://<host>/<path>/rhcos-live.x86_64.iso
+----
++
+where:
++
+--
+<host> :: Specifies the fully qualified domain name (FQDN) for the target mirror registry HTTP server.
+<path> :: Specifies the path to the image on the target mirror registry.
+--
++
+Save and quit the editor to apply the changes.

modules/ztp-updating-gitops-ztp.adoc

@@ -23,4 +23,6 @@ At a high level, the strategy for updating the {ztp} infrastructure is as follow
 
 . Update required content and optional changes in the Git repository.
 
+. Enable pulling the ISO images for the desired {product-title} version.
+
 . Update and restart the application configuration.