https://issues.redhat.com/browse/ACM-17812--Document image mirroring with SiteConfig

Author: amolnar-rh

mce_acm_integration/main.adoc

@@ -17,3 +17,4 @@ include::siteconfig/siteconfig_deprovision_clusters.adoc[leveloffset=+2]
 include::siteconfig/siteconfig_create_custom_templates.adoc[leveloffset=+2]
 include::siteconfig/siteconfig_scale_in_worker_nodes.adoc[leveloffset=+2]
 include::siteconfig/siteconfig_scale_out_worker_nodes.adoc[leveloffset=+2]
+include::siteconfig/siteconfig_mirror_images_disconnected.adoc[leveloffset=+2]

mce_acm_integration/siteconfig/siteconfig_intro.adoc

@@ -17,3 +17,4 @@ For advanced topics, see the following documentation:
 
 * xref:../siteconfig/siteconfig_scale_in_worker_nodes.adoc#scale-in-worker-nodes[Scaling in worker nodes with the {sco}]
 * xref:../siteconfig/siteconfig_scale_out_worker_nodes.adoc#scale-in-worker-nodes[Scaling out worker nodes with the {sco}]
+* xref:../siteconfig/siteconfig_mirror_images_disconnected.adoc#mirror_images_disconnected[Mirroring images for disconnected environments]

mce_acm_integration/siteconfig/siteconfig_mirror_images_disconnected.adoc

@@ -0,0 +1,58 @@
+[#mirror-images-disconnected]
+= Mirroring images for disconnected environments
+
+You can deploy a cluster with the SiteConfig operator by using the Image Based Install Operator as your underlying operator. If you deploy your clusters with the Image Based Install Operator in a disconnected environment, you must supply your mirror images as extra manifests in the `ClusterInstance` custom resource.
+
+*Required access:* Cluster administrator
+
+Complete the following steps to mirror images for disconnected environments:
+
+. Create a YAML file named `idms-configmap.yaml` for your `ImageDigestMirrorSet` object that contains your mirror registry locations:
+
++
+[source,yaml]
+----
+kind: ConfigMap
+apiVersion: v1
+metadata:
+  name: "idms-configmap"
+  namespace: "example-sno"
+data:
+  99-example-idms.yaml: |
+    apiVersion: config.openshift.io/v1
+    kind: ImageDigestMirrorSet
+    metadata:
+      name: example-idms
+    spec:
+      imageDigestMirrors:
+      - mirrors:
+        - mirror.registry.example.com/image-repo/image
+        source: registry.example.com/image-repo/image
+----
+
+**Important:** Define the `ConfigMap` resource that contains the extra manifest in the same namespace as the `ClusterInstance` resource.
+
+. Create the resource by running the following command on the hub cluster:
+
++
+[source,terminal]
+----
+oc apply -f idms-configmap.yaml
+----
+
+. Reference your `ImageDigestMirrorSet` object in the `ClusterInstance` custom resource:
+
++
+[source,yaml]
+----
+apiVersion: siteconfig.open-cluster-management.io/v1alpha1
+kind: ClusterInstance
+metadata:
+  name: "example-sno"
+  namespace: "example-sno"
+spec:
+  ...
+  extraManifestsRefs:
+    - name: idms-configmap
+...
+----