docs: prefer govc and raw vcenter rest for inspection

This commit is contained in:
Cirrus Codex
2026-05-13 17:34:25 -04:00
parent a53e2ee068
commit 24c6d1590a
2 changed files with 2 additions and 0 deletions

View File

@@ -48,6 +48,7 @@ This file defines how to operate and maintain the ATVM workspace in `/home/aw/co
- Controller IP: `192.168.3.190`
- Controller credential source: `/home/aw/code/cds/.env.credentials.local` via `ATVM_CONTROLLER_USER` and `ATVM_CONTROLLER_PASSWORD`
- Detailed test artifact root on controller: `/root/cdc-e2e-cyp-12.17.4/cypress/cmcReporter`
- For vCenter inspection, prefer `govc` and raw vCenter REST calls before inventing or depending on higher-level wrappers.
- Default Mattermost status destination config: `/home/aw/code/cds/.env.credentials.local`
- Default plugin-bearing template plugin: `--use_specified_plugin iscsi`
- Always include `--ignore_force_shutdown` unless explicitly told not to.

View File

@@ -137,6 +137,7 @@ 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 vCenter inspection and placement checks, prefer `govc` and raw vCenter REST calls when they are available before reaching for alternate wrappers.
- For `govc`-based placement checks, use `govc vm.info -json <vm>` 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 <datastore-ref> 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.