MGMT-7780: Late Binding Kube API documentation (#2644)

Signed-off-by: Fred Rolland <[email protected]>

Author: rollandf

docs/hive-integration/README.md

@@ -66,6 +66,8 @@ The InfraEnv reflects the image creation status through Conditions.
 
 More details on conditions is available [here](kube-api-conditions.md)
 
+The InfraEnv can be created without a Cluster Deployment reference for late binding flow. More information is available [here](./late-binding.md).
+
 
 ### [NMStateConfig](../../api/v1beta1/nmstate_config_types.go)
 The NMStateConfig contains network configuration that will applied on the hosts. See NMState repository [here](https://github.com/nmstate/nmstate).
@@ -169,6 +171,7 @@ Those examples are here for reference.
 You will likely need to adapt those for your own needs.
 
 * [InfraEnv](crds/infraEnv.yaml)
+* [InfraEnv Late Binding](crds/infraEnvLateBinding.yaml)
 * [NMState Config](crds/nmstate.yaml)
 * [Hive PullSecret Secret](crds/pullsecret.yaml)
 * [Hive ClusterDeployment](crds/clusterDeployment.yaml)

docs/hive-integration/crds/infraEnvLateBinding.yaml

@@ -0,0 +1,16 @@
+apiVersion: agent-install.openshift.io/v1beta1
+kind: InfraEnv
+metadata:
+  name: myinfraenv
+  namespace: spoke-cluster
+spec:
+  pullSecretRef:
+    name: pull-secret
+  proxy:
+    httpProxy: http://11.11.11.33
+    httpsProxy: http://22.22.22.55
+ #sshAuthorizedKey: 'your_pub_key_here' (optional)
+  ignitionConfigOverride: '{"ignition": {"version": "3.1.0"}, "storage": {"files": [{"path": "/etc/someconfig", "contents": {"source": "data:text/plain;base64,aGVscGltdHJhcHBlZGluYXN3YWdnZXJzcGVj"}}]}}'
+  nmStateConfigLabelSelector:
+    matchLabels:
+      some-user-defined-label-name: some-user-defined-label-value

docs/hive-integration/late-binding.md

@@ -0,0 +1,26 @@
+# Late Binding
+
+With late binding, a discovery ISO can be created without the need of a reference to a Cluster Deployment.
+Hosts booted with such an ISO can be bound to different clusters at a later stage.
+
+See full enhancement document [here](../enhancements/agent-late-binding.md).
+
+## High Level Flow
+- The user creates an InfraEnv CR without a Cluster Reference. See example [here](crds/infraEnvLateBinding.yaml)
+- The version of the base RHCOS live ISO is selected automatically to the latest available.
+- The Agent CR created from an host booted from this ISO will not have a Cluster Deployment reference set in it. (`spec.clusterDeploymentName`)
+- The user creates a Cluster Deployment and Agent Cluster Install CR.
+- The user updates the Agent's Cluster Deployment reference to the CD name.
+- The process of the agent binding can be followed on the `Bound` condition available on the Agent CR. See [here](kube-api-conditions.md#agent-conditions))
+- Once the agent is bound, the flow for installation is as before.
+
+An agent can be unbound from a Cluster Deployment as long as the installation did not start.
+
+Note that the Pull Secret of the InfraEnv can be different from the one specified in the Cluster Deployment.
+
+## Unsupported flows
+
+The following operations are not supported:
+
+- Update/Add/Delete a Cluster Deployment reference of an InfraEnv.
+- Update a Cluster Deployment reference of an Agent after installation started.