docs: default ATVM automation to ignore force shutdown and iscsi
Document ATVM automation defaults to always include --ignore_force_shutdown on cmc-templates.py commands and to use --use_specified_plugin iscsi unless explicitly overridden. Update the ATVM automation guide, folder-level AGENTS instructions, and run learnings so future runs follow the same defaults.
This commit is contained in:
@@ -23,6 +23,8 @@ Run ATVM CMC automation tests on the designated automation VM without unintended
|
||||
- Do not include Gold Disk identifiers in `--build_name`.
|
||||
- `--build_name` must not contain spaces; use `-` between words.
|
||||
- For multiple VMs in same distro, use distro-scoped filtering (`--containsVm`) instead of long explicit VM lists.
|
||||
- Always include `--ignore_force_shutdown` on `cmc-templates.py` commands unless the operator explicitly asks not to.
|
||||
- Default to `--use_specified_plugin iscsi` unless the operator explicitly requests a different plugin.
|
||||
- Before preparing a new run, always check whether automation is already running.
|
||||
- Always report whether automation is currently running.
|
||||
- If running, ask whether to terminate; terminate only with explicit approval.
|
||||
@@ -64,7 +66,7 @@ Typical sequence:
|
||||
|
||||
## Command Pattern
|
||||
```bash
|
||||
python3 cmc-templates.py --template <template> --config_file_path ./<config-file> [template options...]; \
|
||||
python3 cmc-templates.py --template <template> --ignore_force_shutdown --config_file_path ./<config-file> --use_specified_plugin iscsi [template options or explicit plugin override...]; \
|
||||
python3 ./run-sorry-cypress.py --config_file <config-file> --build_name <hyphenated-description-no-spaces> [--categorize]
|
||||
```
|
||||
|
||||
@@ -130,6 +132,8 @@ When asked for one VM or a VM set:
|
||||
- choose requested template/options,
|
||||
- choose correct config file for intended Gold Disk,
|
||||
- default to a config filename containing `gold` unless the operator explicitly says otherwise,
|
||||
- always include `--ignore_force_shutdown` on the template-generation command unless the operator explicitly overrides that default,
|
||||
- default to `--use_specified_plugin iscsi` unless the operator explicitly requests another plugin or the template does not use plugin selection,
|
||||
- use a descriptive `--build_name` without Gold Disk IDs.
|
||||
|
||||
## Update Rule
|
||||
|
||||
Reference in New Issue
Block a user