Design volume attach and detach for existing VMs #129

New issue

Open

opened 2026-09-15 06:55:35 +00:00 by a73x · 0 comments

a73x commented

2026-09-15 06:55:35 +00:00

Owner

Design deliverables

Choose and document stopped-VM attachment versus live hotplug for the initial scope, with a cloud-hypervisor/vfkit capability matrix.
Specify API operations and lifecycle states, including guest unmount/quiescence requirements before detach.
Preserve tenant isolation, single-VM ownership, host pinning and stable device identity/order.
Define when detach actually releases ownership; cover offline agents, failures, retries and restarts without allowing simultaneous writers.
Produce an implementation plan and verification scenarios, including retained data after detach/reattach.

Keep existing create-time attachment behavior available. References: internal/server/store/volumes.go; internal/agent/cloudhv/cloudhv.go; internal/agent/vfkit/vfkit.go.

Currently claims attach only inside the VM-create transaction. Releasing a claim requires deleting the VM and waiting for reaping. #122 already identifies existing-VM attachment as a separate design decision. ## Design deliverables - Choose and document stopped-VM attachment versus live hotplug for the initial scope, with a cloud-hypervisor/vfkit capability matrix. - Specify API operations and lifecycle states, including guest unmount/quiescence requirements before detach. - Preserve tenant isolation, single-VM ownership, host pinning and stable device identity/order. - Define when detach actually releases ownership; cover offline agents, failures, retries and restarts without allowing simultaneous writers. - Produce an implementation plan and verification scenarios, including retained data after detach/reattach. Keep existing create-time attachment behavior available. References: internal/server/store/volumes.go; internal/agent/cloudhv/cloudhv.go; internal/agent/vfkit/vfkit.go.

a73x referenced this issue

2026-09-15 12:34:15 +00:00

volumes: provision on selected hosts and manage through the console #132