oxidecomputer / oxidecomputer/propolis
Update migration protocol to negotiate device version payloads
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 270
- Forks
- 42
- Avg merge
- 4d 5h
- Merged PRs (30d)
- 6
Description
The Propolis library's migration framework supports composable versioned payloads through the PayloadOffer and PayloadOutput types in propolis::migrate. In this scheme, each chunk of migration data has a "kind" and a version, and each Propolis component (device or backend) can export one or more chunks. Because chunks are versioned independently, we can bump the version of a common subcomponent (e.g. the virtio state exported by all virtio devices) without having to re-version all of the independent versions that contain it.
Today the migration protocol has no affordance for the source and destination to agree on the component versions the source should send. (Note that it's not a given that the destination understands more versions than the source, since the migration may be a downgrade.) The protocol should include this, probably as part of the "preamble" phase that otherwise determines whether a migration from the source to the target will be accepted.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the PayloadOffer and PayloadOutput types in propolis::migrate, then trace the migration preamble that decides whether a source and destination can proceed. Define how component version information is exchanged and selected, including downgrade cases. Done means the protocol can negotiate the versions of migration payloads before migration data is sent.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- distributed-systems
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 32/100