From 24c6d1590aa3d7f1e0a462af7cb96a203bcaff0f Mon Sep 17 00:00:00 2001 From: Cirrus Codex Date: Wed, 13 May 2026 17:34:25 -0400 Subject: [PATCH] docs: prefer govc and raw vcenter rest for inspection --- atvm/AGENTS.md | 1 + atvm/docs/automation/guide.md | 1 + 2 files changed, 2 insertions(+) diff --git a/atvm/AGENTS.md b/atvm/AGENTS.md index 7acabaf..c63386b 100644 --- a/atvm/AGENTS.md +++ b/atvm/AGENTS.md @@ -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. diff --git a/atvm/docs/automation/guide.md b/atvm/docs/automation/guide.md index c49a45d..0e53802 100644 --- a/atvm/docs/automation/guide.md +++ b/atvm/docs/automation/guide.md @@ -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 ` 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.