TELCODOCS-1141: MGMT-11232 Support platform integration in ZTP

Author: kdrake20

modules/specifying-the-platform-type-for-managed-clusters.adoc

@@ -0,0 +1,55 @@
+// Module included in the following assemblies:
+//
+// scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc
+
+:_content-type: PROCEDURE
+[id="specifying-the-platform-type-for-managed-clusters_{context}"]
+= Specifying the platform type for managed clusters
+
+You can manually specify the platform type for managed clusters if you do not want to set the platform type automatically.
+
+The {ai-full} supports the following platform types:
+
+* `BareMetal`
+* `VSphere`
+* `None`
+
+.Procedure
+
+* Select the platform in the `AgentClusterInstall` custom resource (CR) by changing the value of the `spec.platformType` parameter:
++
+[source,yaml]
+----
+apiVersion: extensions.hive.openshift.io/v1beta1
+kind: AgentClusterInstall
+metadata:
+  name: cluster
+  namespace: cluster
+spec:
+  platformType: VSphere
+----
+
+In some cases, the system automatically sets the platform type:
+
+* The default platform type for multi-node clusters is `BareMetal`.
+* The default platform type for {sno} is `None`.
+* Enabling the `spec.networking.userManagedNetworking` setting without specifying the platform causes the platform value to be `None`.
+
+The `BareMetal` platform type and `userManagedNetworking` parameter value are not compatible.
+
+[NOTE]
+====
+* `VSphere` is not supported for {sno}.
+* Virtual machine (VM) provisioning should be done by the user.
+* Virtual IP address (VIP) DHCP allocation should be configured manually in `VSphere`.
+====
+
+.Verification
+
+* To verify the selected platform in the `AgentClusterInstall` CR by checking the value of the `spec.platformType` parameter, run the following command:
++
+[source,terminal]
+----
+$ oc get AgentClusterInstall cluster -n cluster -o jsonpath='{.status.platformType}{"\n"}' \
+`VSphere`
+----

scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc

@@ -12,6 +12,8 @@ include::modules/ztp-challenges-of-far-edge-deployments.adoc[leveloffset=+1]
 
 include::modules/about-ztp.adoc[leveloffset=+1]
 
+include::modules/specifying-the-platform-type-for-managed-clusters.adoc[leveloffset=+1]
+
 include::modules/ztp-creating-ztp-crs-for-multiple-managed-clusters.adoc[leveloffset=+1]
 
 include::modules/ztp-configuring-cluster-policies.adoc[leveloffset=+1]