Merge pull request #78982 from jherrman/CNV-39419

OSDOCS#39419: Fixing procedure for creating live migration policies

Author: kcarmichael08

modules/virt-configuring-a-live-migration-policy.adoc

@@ -6,7 +6,7 @@
 [id="virt-configuring-a-live-migration-policy_{context}"]
 = Creating a live migration policy by using the command line
 
-You can create a live migration policy by using the command line. A live migration policy is applied to selected virtual machines (VMs) by using any combination of labels:
+You can create a live migration policy by using the command line. KubeVirt applies the live migration policy to selected virtual machines (VMs) by using any combination of labels:
 
 * VM labels such as `size`, `os`, or `gpu`
 * Project labels such as `priority`, `bandwidth`, or `hpc-workload`
@@ -22,7 +22,40 @@ If multiple policies meet this criteria, the policies are sorted by alphabetical
 
 .Procedure
 
-. Create a `MigrationPolicy` object as in the following example:
+. Edit the VM object to which you want to apply a live migration policy, and add the corresponding VM labels.
+
+.. Open the YAML configuration of the resource:
++
+[source,terminal]
+----
+$ oc edit vm <vm_name>
+----
+
+.. Adjust the required label values in the `.spec.template.metadata.labels` section of the configuration. For example, to mark the VM as a `production` VM for the purposes of migration policies, add the `kubevirt.io/environment: production` line:
++
+[source,yaml, subs="+quotes"]
+----
+apiVersion: migrations.kubevirt.io/v1alpha1
+kind: VirtualMachine
+metadata:
+  name: <vm_name>
+  namespace: default
+  labels:
+    app: my-app
+    environment: production
+spec:
+  template:
+    metadata:
+      labels:
+        kubevirt.io/domain: <vm_name>
+        kubevirt.io/size: large
+        kubevirt.io/environment: production
+# ...
+----
+
+.. Save and exit the configuration.
+
+. Configure a `MigrationPolicy` object with the corresponding labels. The following example configures a policy that applies to all VMs that are labeled as `production`:
 +
 [source,yaml]
 ----
@@ -36,8 +69,7 @@ spec:
       hpc-workloads: "True"
       xyz-workloads-type: ""
     virtualMachineInstanceSelector: <2>
-      workload-type: "db"
-      operating-system: ""
+      kubevirt.io/environment: "production"
 ----
 <1> Specify project labels.
 <2> Specify VM labels.