From 1b88e8887e6b989f709d8b63050f0e61534e8b00 Mon Sep 17 00:00:00 2001 From: "anthony.wen" Date: Thu, 16 Apr 2026 08:13:33 -0400 Subject: [PATCH] Document govc datastore resolution for ATVM placement checks Add the working vCenter placement-check pattern to the ATVM automation guide so explicit VM-list planning uses the correct lowercase govc JSON keys, resolves datastore refs to names, and ignores helper datastores such as install ISO attachments when deciding between gold and gold-2. --- atvm/docs/automation/guide.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/atvm/docs/automation/guide.md b/atvm/docs/automation/guide.md index 7e16928..801a4d1 100644 --- a/atvm/docs/automation/guide.md +++ b/atvm/docs/automation/guide.md @@ -131,6 +131,9 @@ Completed-run verification sequence: - When the operator asks to inventory or show the contents of `AutomatedTest-VMBootImg-Gold` and `AutomatedTest-VMBootImg-Gold-2`, return hostname-only VM lists unless the operator explicitly asks for more detail. - When the operator provides an explicit VM list, check vCenter placement for every requested VM before choosing the config file. - Before presenting any ATVM run commands for an explicit VM-list request, tell the operator that the next step is a live vCenter placement check for the requested VMs and that the result will determine whether the run must use `gold` or `gold-2`. +- For `govc`-based placement checks, use `govc vm.info -json ` and parse the lowercase JSON keys such as `virtualMachines` and `datastore`. +- Resolve each returned datastore managed-object reference to a datastore name with `govc object.collect -s name` before deciding between `gold` and `gold-2`. +- Ignore non-boot helper datastores such as install ISO attachments when applying the `gold` vs `gold-2` rule; base the family decision on the ATVM boot datastore membership. - If every requested VM is on `AutomatedTest-VMBootImg-Gold`, plan the run with the `gold` config. - If every requested VM is on `AutomatedTest-VMBootImg-Gold-2`, plan the run with the `gold-2` config. - If the requested VM set spans both `AutomatedTest-VMBootImg-Gold` and `AutomatedTest-VMBootImg-Gold-2`, stop immediately and do not prepare or run the test.