diff --git a/edge_computing/ztp-updating-gitops.adoc b/edge_computing/ztp-updating-gitops.adoc index 5f1091e355..9ffc0bf716 100644 --- a/edge_computing/ztp-updating-gitops.adoc +++ b/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"] diff --git a/modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc b/modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc index 7d0f183f51..c00624fb3b 100644 --- a/modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc +++ b/modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc @@ -9,38 +9,45 @@ .Prerequisites -* You have installed the OpenShift CLI (`oc`). +* You have installed the {oc-first}. * 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 . Enable the `Provisioning` resource to watch all namespaces and configure mirrors for disconnected environments. For more information, see link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#enable-cim[Enabling the central infrastructure management service]. -. Update the `AgentServiceConfig` CR by running the following command: +. Open the `AgentServiceConfig` CR to update the `spec.osImages` field by running the following command: + [source,terminal] ---- $ oc edit AgentServiceConfig ---- -. Add the following entry to the `items.spec.osImages` field in the CR: +. Update the `spec.osImages` field in the `AgentServiceConfig` CR: + [source,yaml,subs="attributes+"] ---- -- cpuArchitecture: x86_64 - openshiftVersion: "{product-version}" - rootFSUrl: https:////rhcos-live-rootfs.x86_64.img - url: https:////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:////rhcos-live-rootfs.x86_64.img + url: https:////rhcos-live.x86_64.iso ---- + where: + -- - :: Is the fully qualified domain name (FQDN) for the target mirror registry HTTP server. - :: Is the path to the image on the target mirror registry. +`` :: Specifies the fully qualified domain name (FQDN) for the target mirror registry HTTP server. +`` :: 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. \ No newline at end of file diff --git a/modules/ztp-pulling-ocp-images.adoc b/modules/ztp-pulling-ocp-images.adoc new file mode 100644 index 0000000000..47248e8042 --- /dev/null +++ b/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 {oc-first}. + +* 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 + +. Open the `AgentServiceConfig` CR to update the `spec.osImages` field by running the following command: ++ +[source,terminal] +---- +$ oc edit AgentServiceConfig +---- + +. Update the `spec.osImages` field in the `AgentServiceConfig` 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:////rhcos-live-rootfs.x86_64.img + url: https:////rhcos-live.x86_64.iso +---- ++ +where: ++ +-- +`` :: Specifies the fully qualified domain name (FQDN) for the target mirror registry HTTP server. +`` :: Specifies the path to the image on the target mirror registry. +-- + +. Save and quit the editor to apply the changes. \ No newline at end of file diff --git a/modules/ztp-updating-gitops-ztp.adoc b/modules/ztp-updating-gitops-ztp.adoc index 98be1af275..2a51e55934 100644 --- a/modules/ztp-updating-gitops-ztp.adoc +++ b/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.