Skip to content

ateom-microvm: snapshot durable-dir volumes as one tar per volume - #2283

Merged
Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
BenTheElder:microvm-per-volume-durable-tar
Oct 7, 2026
Merged

Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
BenTheElder:microvm-per-volume-durable-tar

Conversation

@BenTheElder

Copy link
Copy Markdown
Collaborator

Archive and restore each durable-dir volume in its own durable-dir-.tar file instead of a single durable-dir.tar covering the parent directory, matching ateom-gvisor.

Because kata-agent bind-mounts /run/kata-containers/shared/containers/durable/ by path inside the guest VM on cold boot (including DATA-scope restores), extracting a single tar into the parent directory allowed a snapshot entry to replace with a symlink that kata-agent would resolve in the guest root filesystem. Creating each volume directory first and extracting its archive inside it keeps the volume layout out of the snapshot's control.

The PR title becomes the release note. Write it for users: what changed for them, not how the code changed.

Breaking change

See: #2110, applies the same change to microvm. Unlike gvisor this class was contained within the VM, but we'll do the same inside the VM for defense in depth.

Archive and restore each durable-dir volume in its own durable-dir-<volume>.tar file instead of a single durable-dir.tar covering the parent directory, matching ateom-gvisor.

Because kata-agent bind-mounts /run/kata-containers/shared/containers/durable/<volume> by path inside the guest VM on cold boot (including DATA-scope restores), extracting a single tar into the parent directory allowed a snapshot entry to replace <volume> with a symlink that kata-agent would resolve in the guest root filesystem. Creating each volume directory first and extracting its archive inside it keeps the volume layout out of the snapshot's control.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/microVM breaking-change PRs with breaking changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants