justinandClaude Opus 5
fe7b220ab9
Zerto's tagged checkpoint insert takes exactly one field. The 10.x swagger model VpgInsertTagCheckpointDataApi has a single property, checkpointName, and the 9.0 API reference lists CheckpointName as the only request value. There is no description field, so who the agent is and what it is about to do have to live inside the name. Old name: ai:claude:chg-412:20260921T170829Z New name: ai:claude | edit /home/justin/app-config.yaml | vm=jp-ubuntu | change=chg-412 | 20260921T170829Z zerto_create_tagged_checkpoint and zerto_guard_before_mutate take a new action argument: free text saying what the agent is about to do. The VM name is filled in from the find result. An operator reading the journal in the Zerto UI can now see which agent inserted a checkpoint and why, without the agent transcript. Field text is sanitised so the name stays one readable line: control characters and runs of whitespace collapse to single spaces, ';' becomes ',' because Zerto appends "; Used for File Level Restore" to its own tags, and '|' becomes '/' because ' | ' is our field separator. Capped at TAG_MAX_LEN (250). Measured against ZVM 10.x while picking the format: - names of at least 400 chars are accepted, and spaces, slashes, parentheses, '=' and '|' all survive the round trip - tagged checkpoint inserts fired back to back at one VPG are silently dropped. The POST returns 200 and queues a task, but only the first checkpoint appears. tag_vpgs already inserts then waits per VPG, so it is correct; added a comment so nobody turns that loop into an asyncio.gather(). Verified end to end: guard inserted cp 1197 on VPG jp-ubuntu, the name read back byte-identical from the journal, and FLR from that checkpoint returned the 158 byte pre-mutation file. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Claude-Session: https://claude.ai/code/session_016yVfC5nvZowoLFnEGWhLGn
42 lines
2.5 KiB
Markdown
42 lines
2.5 KiB
Markdown
# Zerto AI Rewind
|
|
|
|
PoC MCP that teaches an agent to discover Zerto protection, pin a tagged checkpoint before changing a VM, and recover a file from that tag. If the loop works, these tools are the delta to put in official ZVM MCP.
|
|
|
|
## Language
|
|
|
|
**Tagged checkpoint**:
|
|
A named bookmark in a VPG journal, inserted by `POST /v1/vpgs/{id}/checkpoints` (`startVpgTaggedCheckpointInsert`). Crash-consistent write-order only; not application-quiesced unless someone scripted that separately. `CheckpointName` is the only field the API accepts, so agent and intent go in the name: `ai:<agent> | <action> | vm=<vm> | change=<id> | <utc>`. Inserts are async tasks and are silently dropped if fired back to back at one VPG; insert, then wait until listed.
|
|
_Avoid_: user checkpoint, snapshot, backup, restore point (unqualified)
|
|
|
|
**VPG**:
|
|
A Virtual Protection Group. One to many VMs sharing a journal. A VM can belong to at most three VPGs, recovered to different sites.
|
|
_Avoid_: job, policy, replication group
|
|
|
|
**Rewind**:
|
|
The agent loop: find protection, tag every protecting VPG, mutate, then bounded recover. Not a Zerto product name.
|
|
_Avoid_: failover (that's DR), undo (that's git or Moholo)
|
|
|
|
**Bounded recover**:
|
|
FLR, offsite clone, or failover test. Failover Live is not a rewind tool.
|
|
_Avoid_: recover (unqualified), fail back, restore the VPG
|
|
|
|
**File-level recovery (FLR)**:
|
|
Mount a VM from a journal checkpoint and pull files. The VM stays up. 10.9 FLR Operator RBAC is broken; Administrator is the documented workaround.
|
|
_Avoid_: file restore (unqualified), instant restore (local-journal VMs only, not v1)
|
|
|
|
**find_protection**:
|
|
Resolve a VM name, hostname, or Zerto vmIdentifier to exactly one VM and every VPG it is in. Zero or two-plus VMs is a hard stop.
|
|
_Avoid_: GetVms (that's the raw inventory call)
|
|
|
|
**Protecting VPG**:
|
|
A VPG whose status is MeetingSLA or a NotMeetingSLA variant, and whose substatus is not a sync. Only these get tagged. 10.9 status 0 is Initializing, not Protecting. A resync deletes existing checkpoints.
|
|
_Avoid_: healthy, in sync, Protecting (as status 0)
|
|
|
|
**Mutating catalog**:
|
|
The opt-in list of MCP tools that must call `zerto_guard_before_mutate` first. Unlisted tools pass through. Users add entries; the starter list is not the whole world.
|
|
_Avoid_: denylist, hold-everything
|
|
|
|
**Official ZVM MCP**:
|
|
HPE Zerto 10.9 MCP (`ZVM.MCP`): inventory, VPG settings, failover test. Not in the demo path. This PoC is one server.
|
|
_Avoid_: Zerto MCP (unqualified when you mean this repo)
|