Merge pull request #28776 from codyhoag/winc-char-limit-azure

Warning for Azure Windows machine set name length restriction

Author: codyhoag

modules/windows-machineset-azure.adoc

@@ -14,21 +14,21 @@ kind: MachineSet
 metadata:
   labels:
     machine.openshift.io/cluster-api-cluster: <infrastructure_id> <1>
-  name: <infrastructure_id>-windows-worker-<region> <2>
+  name: <windows_machine_set_name> <2>
   namespace: openshift-machine-api
 spec:
   replicas: 1
   selector:
     matchLabels:
       machine.openshift.io/cluster-api-cluster: <infrastructure_id> <1>
-      machine.openshift.io/cluster-api-machineset: <infrastructure_id>-windows-worker-<region> <2>
+      machine.openshift.io/cluster-api-machineset: <windows_machine_set_name> <2>
   template:
     metadata:
       labels:
         machine.openshift.io/cluster-api-cluster: <infrastructure_id> <1>
         machine.openshift.io/cluster-api-machine-role: worker
         machine.openshift.io/cluster-api-machine-type: worker
-        machine.openshift.io/cluster-api-machineset: <infrastructure_id>-windows-worker-<region> <2>
+        machine.openshift.io/cluster-api-machineset: <windows_machine_set_name> <2>
         machine.openshift.io/os-id: Windows <3>
     spec:
       metadata:
@@ -71,7 +71,7 @@ spec:
 ----
 $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
 ----
-<2> Specify the infrastructure ID, worker label, and region.
+<2> Specify the Windows machine set name. Windows machine names on Azure cannot be more than 15 characters long. Therefore, the machine set name cannot be more than 9 characters long, due to the way machine names are generated from it.
 <3> Configure the machine set as a Windows machine.
 <4> Configure the Windows node as a compute machine.
 <5> Specify a `WindowsServer` image offering that defines the `2019-Datacenter-with-Containers` SKU with version `17763.1457.2009030514` or earlier.