63 lines
3.4 KiB
Markdown
63 lines
3.4 KiB
Markdown
# AGENTS.md
|
|
|
|
This folder contains the VMware/vCenter + MigrateOps runbook for CDS MCP workflows.
|
|
|
|
## Workspace Layout
|
|
- `README.md`
|
|
- top-level navigation
|
|
- `docs/vmware-migrateops-guide.md`
|
|
- authoritative VMware compute migration workflow
|
|
- `docs/esxvm-guide.md`
|
|
- direct vCenter VM hardware review/change workflow
|
|
- `docs/vm-lookup-and-assignment.md`
|
|
- VM lookup, datastore reporting, and FC/disk assignment workflow
|
|
- `docs/cmc-install-reference.md`
|
|
- CMC install, uninstall, and reinstall fallback reference
|
|
- `docs/iscsi-cleanup-reference.md`
|
|
- guest-level iSCSI target cleanup reference
|
|
- `docs/run-learnings.md`
|
|
- run-specific learnings only when a run adds new information
|
|
- `templates/vmw.yaml`
|
|
- base template for `MIGRATEOPS_VMWARE_COMPUTE` operations
|
|
- `artifacts/logs/`
|
|
- runtime log artifacts kept separate from operator guidance
|
|
|
|
## Source Of Truth
|
|
- Use `docs/vmware-migrateops-guide.md` for how to execute VMware compute migration runs.
|
|
- Use `docs/esxvm-guide.md` for direct vCenter VM hardware changes such as new disks, existing-disk attach, and PCI passthrough assignment.
|
|
- Use `docs/vm-lookup-and-assignment.md` for VM lookup responses and FC/disk assignment requests.
|
|
- Use `docs/cmc-install-reference.md` for CMC install/uninstall commands and fallback reinstall notes.
|
|
- Use `docs/iscsi-cleanup-reference.md` for guest-level iSCSI target logout and node-record cleanup.
|
|
- Use `templates/vmw.yaml` as the starting operation template.
|
|
- Treat `docs/run-learnings.md` as evidence/history, not baseline procedure.
|
|
|
|
## Required Run Pattern
|
|
1. Confirm source VM in vCenter and power state before IP/SSH actions.
|
|
2. Prepare source host (CDC cleanup + CMC reinstall/registration) and verify source is connected in CDC.
|
|
This applies to Windows sources too; do not skip project cleanup just because SSH + PowerShell works.
|
|
3. Validate preflight requirements from `docs/vmware-migrateops-guide.md`.
|
|
4. Create MigrateOps from `templates/vmw.yaml` with request-specific replacements.
|
|
5. Monitor continuously and auto-approve cutover unless the user requests manual approval.
|
|
6. After terminal state:
|
|
- validate destination login,
|
|
- archive operation,
|
|
- run offline-host cleanup loop until source/helper cleanup conditions are satisfied,
|
|
- provide final read-only status listing for source/destination/access/helper across CDC and vCenter.
|
|
7. Ask the user explicitly before deleting the destination VM; never delete without same-run confirmation.
|
|
|
|
## Environment Defaults
|
|
- vCenter: `192.168.0.201`
|
|
- Cluster scope: `QACL-ATVMCypressONLY` unless user overrides
|
|
- Default CDC project: `Skidamarink`
|
|
- Default access node: `atvm-linux-h2h`
|
|
- Default ATVM target reference: `192.168.3.191`
|
|
- For Windows ATVM guest execution, prefer SSH + PowerShell with `ATVM_WINDOWS_TARGET_USER` and `ATVM_WINDOWS_TARGET_PASSWORD`.
|
|
|
|
## Update Rules
|
|
- Update `docs/vmware-migrateops-guide.md` only when migration workflow/default behavior changes.
|
|
- Update `docs/esxvm-guide.md` only when direct vCenter hardware workflow/default behavior changes.
|
|
- Update `docs/vm-lookup-and-assignment.md` only when lookup/assignment workflow behavior changes.
|
|
- Update `docs/cmc-install-reference.md` only when install or reinstall reference behavior changes.
|
|
- Update `docs/iscsi-cleanup-reference.md` only when the default iSCSI target cleanup workflow changes.
|
|
- Update `docs/run-learnings.md` only when a run reveals a new learning/failure pattern/required check.
|